本教程将指导您如何使用 Discord.py 库监听并响应 Discord 服务器中成员的状态变化。我们将重点介绍正确的事件处理函数 on_member_update()，并演示如何配置必要的 Intents、比较用户状态，以及在状态发生改变时向指定频道发送通知消息，确保您的 Discord 机器人能准确捕捉并响应这些动态。
1. 理解用户状态与事件监听
在 discord 中，用户状态（如在线、离线、空闲、请勿打扰等）是其在线活动的重要指示。discord.py 提供了强大的事件机制，允许机器人监听并响应这些状态的变化。过去，on_presence_update() 事件曾被用于此目的，但现在已被弃用。当前正确且推荐的事件是 on_member_update()。
on_member_update() 事件会在服务器（Guild）中的成员信息发生变化时触发，这包括了他们的状态、昵称、角色等。该事件接收两个参数：
before: 变化前的 discord.Member 对象。after: 变化后的 discord.Member 对象。
通过比较 before 和 after 对象的属性，我们可以精确地检测到哪些信息发生了改变。
2. 配置必要的 Intents
为了让您的 Discord 机器人能够接收到成员状态更新的事件，您必须在机器人客户端中启用特定的 Intents。具体而言，您需要启用 Intents.members 和 Intents.presences。
Intents.members 允许机器人获取成员的详细信息，包括他们的角色、昵称等。Intents.presences 允许机器人接收成员的在线状态和活动信息。
以下是如何配置 Intents 的示例：
import discord# 启用所有默认 Intents，并额外启用 members 和 presences Intentsintents = discord.Intents.default()intents.members = Trueintents.presences = True# 创建机器人客户端实例时传入配置好的 Intentsclient = discord.Client(intents=intents)# 或者，如果您使用的是 commands.Bot# from discord.ext import commands# bot = commands.Bot(command_prefix='!', intents=intents)
注意事项：
如果您在 Discord 开发者门户中启用了 “Privileged Gateway Intents” 中的 “Presence Intent” 和 “Server Members Intent”，那么在代码中也必须启用对应的 Intents，否则机器人将无法收到相关事件。对于大型机器人（通常指超过一定服务器数量的机器人），启用这些特权 Intents 可能需要额外的审核。
3. 实现 on_member_update() 事件监听
一旦 Intents 配置完成，您就可以在机器人代码中实现 on_member_update() 事件处理函数。在该函数内部，我们将比较 before.status 和 after.status 来判断用户状态是否发生了变化。
import discord# 1. 配置 Intentsintents = discord.Intents.default()intents.members = Trueintents.presences = Trueclient = discord.Client(intents=intents)TARGET_CHANNEL_ID = YOUR_GENERAL_CHANNEL_ID_HERE # 替换为您的目标频道ID (例如: 123456789012345678)TARGET_MEMBER_ID = YOUR_TARGET_MEMBER_ID_HERE # 替换为您想要监听的特定成员ID (可选，如果监听所有成员则无需)@client.eventasync def on_ready(): print(f'机器人已登录为 {client.user}') # 验证目标频道是否存在 target_channel = client.get_channel(TARGET_CHANNEL_ID) if not target_channel: print(f"警告: 未找到 ID 为 {TARGET_CHANNEL_ID} 的目标频道。请检查频道 ID。")@client.eventasync def on_member_update(before: discord.Member, after: discord.Member): # 2. 检查是否是目标成员（如果需要监听特定成员） if TARGET_MEMBER_ID and after.id != TARGET_MEMBER_ID: return # 如果不是目标成员，则直接返回 # 3. 检查用户状态是否发生变化 if before.status != after.status: print(f'{after.display_name} 的状态从 {before.status} 变为 {after.status}') # 4. 获取目标频道并发送消息 target_channel = client.get_channel(TARGET_CHANNEL_ID) if target_channel: message = ( f"**成员状态更新通知：**n" f"**成员：** {after.mention} ({after.display_name})n" f"**原状态：** {before.status.name.capitalize()}n" f"**新状态：** {after.status.name.capitalize()}" ) try: await target_channel.send(message) except discord.Forbidden: print(f"错误: 机器人没有在频道 {target_channel.name} ({target_channel.id}) 发送消息的权限。") except Exception as e: print(f"发送消息时发生未知错误: {e}") else: print(f"错误: 无法找到 ID 为 {TARGET_CHANNEL_ID} 的目标频道，无法发送通知。")# 替换为您的机器人令牌# client.run('YOUR_BOT_TOKEN_HERE')
代码解析：
TARGET_CHANNEL_ID：您希望发送通知的频道 ID。您可以通过在 Discord 客户端中启用开发者模式，右键点击频道来复制其 ID。TARGET_MEMBER_ID：如果您只想监听特定用户的状态变化，可以设置此变量。如果想监听所有用户的状态变化，可以移除或注释掉相关判断。before.status 和 after.status：这两个属性返回 discord.Status 枚举成员，例如 discord.Status.online、discord.Status.idle 等。before.status != after.status：这是检测状态是否改变的核心逻辑。client.get_channel(TARGET_CHANNEL_ID)：通过 ID 获取 discord.TextChannel 对象。target_channel.send(message)：向指定频道发送通知消息。
4. 运行机器人
在将 YOUR_BOT_TOKEN_HERE 替换为您的机器人令牌后，运行此脚本即可启动机器人并开始监听用户状态变化。
python your_bot_file.py
5. 注意事项与最佳实践
机器人权限： 确保您的机器人在目标服务器中拥有 读取消息历史 和 发送消息 的权限，以便能够成功发送通知。错误处理： 在发送消息时，添加 try-except 块来捕获 discord.Forbidden 异常，这表示机器人没有在指定频道发送消息的权限。频道 ID 获取： 在 Discord 客户端中，进入“用户设置” -> “高级”，开启“开发者模式”。然后右键点击您想要发送通知的频道，选择“复制 ID”。discord.Status 枚举： discord.Status 枚举成员包括 online (在线), offline (离线), idle (空闲), dnd (请勿打扰), invisible (隐身，但对机器人而言通常显示为离线), streaming (直播中)。性能考量： 如果您的机器人加入的服务器数量很多，且用户活跃度高，on_member_update() 事件可能会频繁触发。请确保您的处理逻辑高效，避免阻塞事件循环。日志记录： 建议在关键操作（如发送消息失败）时进行日志记录，以便于调试和监控。
总结
通过本教程，您应该已经掌握了如何使用 Discord.py 的 on_member_update() 事件来实时监听并响应 Discord 服务器中成员的状态变化。正确配置 Intents、比较 before 和 after 状态，以及妥善处理消息发送，是构建一个能够有效监控用户动态的 Discord 机器人的关键。请务必根据您的实际需求调整代码中的频道 ID 和成员 ID，并注意机器人权限的配置。
以上就是Discord.py 教程：实时检测用户状态变化并发送通知的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1374772.html
微信扫一扫 
支付宝扫一扫 
