Discord.py：监听并响应用户状态变化

DDD

发布时间：2025-10-01 11:57:43

1014人浏览过

来源于php中文网

原创

Discord.py：监听并响应用户状态变化

本教程详细指导如何在Discord.py中检测用户状态变化并发送通知。我们将重点介绍使用on_member_update事件来捕捉用户在线状态、活动状态等更新，并通过比较前后状态来识别变化。文章涵盖了必要的Intents配置、事件处理逻辑、获取目标频道的方法，并提供了一个完整的Python代码示例，帮助你构建一个能够实时响应用户状态更新的Discord机器人。

理解 Discord.py 事件与 Intents

在discord.py中，监听机器人所在服务器内成员的事件是构建互动功能的基础。对于用户状态变化，许多开发者可能会想到on_presence_update事件。然而，需要明确的是，on_presence_update事件已被弃用或其功能已整合到其他事件中。目前，处理成员信息更新（包括状态变化）的推荐事件是on_member_update(before: discord.member, after: discord.member)。

为了让机器人能够接收到成员状态相关的事件，你必须在初始化机器人时启用特定的Intents（意图）。Intents是Discord API用来控制机器人接收哪些事件的机制，以优化资源使用并提高安全性。对于成员状态变化，至少需要启用discord.Intents.members和discord.Intents.presences。

discord.Intents.members: 允许机器人接收成员加入/离开、成员角色更新等事件。
discord.Intents.presences: 允许机器人接收成员的在线状态（如在线、离线、空闲、请勿打扰）和活动状态（如正在玩游戏、正在听音乐）更新。

在Discord开发者门户中，你也需要在你的机器人应用设置页面（Bot选项卡下）手动启用“PRESENCE INTENT”和“SERVER MEMBERS INTENT”。

核心逻辑：检测用户状态变化

on_member_update事件在成员的任何可观察属性发生变化时触发，包括其昵称、角色、以及最重要的——在线状态（status）和活动（activity）。该事件接收两个discord.Member对象作为参数：before和after。

before: 成员在更新前的状态。
after: 成员在更新后的状态。

要检测用户状态是否发生变化，我们只需比较before.status和after.status。discord.Status是一个枚举类型，包含online、offline、idle、dnd（请勿打扰）等值。

知识画家

AI交互知识生成引擎，一句话生成知识视频、动画和应用

下载

import discord

# 确保在Discord开发者门户中启用了PRESENCE INTENT和SERVER MEMBERS INTENT
intents = discord.Intents.default()
intents.members = True  # 启用成员意图
intents.presences = True # 启用存在意图 (用于检测状态变化)

client = discord.Client(intents=intents)

TARGET_CHANNEL_ID = 123456789012345678  # 替换为你要发送消息的频道ID
TARGET_MEMBER_ID = 987654321098765432 # 可选：如果你只想追踪特定用户，替换为该用户ID

@client.event
async def on_ready():
    print(f'机器人已登录为 {client.user}')

@client.event
async def on_member_update(before: discord.Member, after: discord.Member):
    # 可选：如果你只想追踪特定用户
    # if after.id != TARGET_MEMBER_ID:
    #     return

    # 检查用户在线状态是否发生变化
    if before.status != after.status:
        print(f'{after.display_name} 的状态从 {before.status} 变为 {after.status}')

        # 获取目标频道
        target_channel = client.get_channel(TARGET_CHANNEL_ID)
        if target_channel:
            await target_channel.send(
                f'**{after.display_name}** 的状态更新了！\n'
                f'从 `{before.status.name}` 变为 `{after.status.name}`.'
            )
        else:
            print(f'错误：未找到ID为 {TARGET_CHANNEL_ID} 的频道。')

# 替换为你的机器人Token
client.run('YOUR_BOT_TOKEN_HERE')

发送通知消息

在检测到状态变化后，通常需要向特定频道发送通知。

获取目标频道: 可以使用client.get_channel(channel_id)方法通过频道的ID来获取频道对象。频道ID是唯一的数字标识符，可以在Discord客户端中通过开启开发者模式并右键点击频道来复制。
发送消息: 获取到频道对象后，使用await channel.send("你的消息内容")即可发送消息。

注意事项

Intents 配置: 务必在代码中和Discord开发者门户中同时启用PRESENCE INTENT和SERVER MEMBERS INTENT。如果未启用，on_member_update事件可能不会被触发，或者不会包含状态信息。
频道 ID: 确保TARGET_CHANNEL_ID是正确的，并且机器人有权限在该频道发送消息。如果频道ID不正确或机器人没有权限，target_channel将为None，或send方法会抛出discord.Forbidden异常。
性能考虑: on_member_update事件在服务器中任何成员的任何相关属性变化时都会触发。如果你的机器人管理着大量成员，并且你只关心特定用户的状态，务必在事件处理函数内部添加条件判断（如if after.id == TARGET_MEMBER_ID:）来过滤不相关的事件，以减少不必要的处理负载。
错误处理: 考虑添加try-except块来处理发送消息时可能出现的异常，例如网络问题或权限不足。
状态名称: before.status和after.status是discord.Status枚举类型。要获取其字符串表示，可以使用.name属性（如before.status.name），它会返回'online'、'offline'等字符串。
活动状态: 如果你不仅想检测在线状态，还想检测用户正在进行的游戏或活动，可以比较before.activity和after.activity。after.activity可能是一个discord.Activity对象，你可以从中获取活动的名称、类型等信息。