本教程详细讲解如何使用 Discord.py 监听服务器成员的状态变化（如在线、离线、忙碌等），并在此变化发生时向指定频道发送通知消息。我们将重点介绍 on_member_update() 事件的正确用法，以及所需的 Intents 配置，以确保您的机器人能够准确捕获并响应用户活动。
在构建 discord 机器人时，有时我们需要实时了解服务器成员的在线状态变化，例如当某个特定用户上线或下线时发送通知。早期的 discord.py 版本可能使用 on_presence_update() 事件来处理此类需求，但该事件已被弃用。本文将指导您使用当前推荐的 on_member_update() 事件来高效实现这一功能。
Discord.py 用户状态监听核心：on_member_update()
on_member_update() 是 Discord.py 中用于监听服务器成员信息更新的事件，它不仅包括用户状态（presence）的变化，还包括昵称、角色等其他成员属性的更新。
on_presence_update() 的弃用与 on_member_update() 的引入
过去，on_presence_update() 事件主要用于处理用户在线状态（presence）的更新。然而，随着 Discord API 和 Discord.py 库的演进，为了更好地整合和管理成员相关的所有更新，on_member_update() 成为了处理这类事件的首选。它提供了更全面的信息，并且是官方推荐的实现方式。
on_member_update() 事件参数解析
on_member_update() 事件回调函数接收两个 discord.Member 对象作为参数：
before: 表示成员更新前的状态。after: 表示成员更新后的状态。
通过比较这两个对象的相关属性，我们可以精确地检测到所需的变化。对于用户状态变化，我们将重点关注 before.status 和 after.status。
前置条件：启用必要的 Intents
为了让机器人能够接收到成员状态更新的事件，您需要在机器人代码和 Discord 开发者门户中启用特定的 Intents（意图）。这是 Discord API 设计中一个重要的权限控制机制。
在代码中启用 Intents：您需要启用 discord.Intents.members 和 discord.Intents.presences。
import discord# 启用所需的Intentsintents = discord.Intents.default()intents.members = True # 允许机器人接收成员相关事件intents.presences = True # 允许机器人接收成员在线状态相关事件client = discord.Client(intents=intents)
在 Discord 开发者门户配置：登录 Discord Developer Portal，选择您的机器人应用，进入“Bot”页面。在“Privileged Gateway Intents”部分，确保 PRESENCE INTENT 和 SERVER MEMBERS INTENT 都已启用。如果未启用，机器人将无法接收到相应的事件。
实现用户状态变化检测与通知
下面我们将通过一个具体的代码示例，展示如何利用 on_member_update() 事件来检测指定用户的状态变化，并向特定频道发送通知。
import discordimport os# 1. 启用所需的Intentsintents = discord.Intents.default()intents.members = True # 允许机器人接收成员相关事件intents.presences = True # 允许机器人接收成员在线状态相关事件client = discord.Client(intents=intents)# 配置您的机器人Token# 建议将Token存储在环境变量中，以提高安全性BOT_TOKEN = os.getenv("DISCORD_BOT_TOKEN")# 配置要监听的成员ID和通知频道IDTARGET_MEMBER_ID = 123456789012345678 # 替换为要监听的Discord用户IDNOTIFICATION_CHANNEL_ID = 987654321098765432 # 替换为要发送通知的频道ID@client.eventasync def on_ready(): """机器人启动时触发的事件""" print(f'机器人已上线：{client.user}') # 尝试获取通知频道，确保其存在 channel = client.get_channel(NOTIFICATION_CHANNEL_ID) if channel: print(f"通知频道 '{channel.name}' (ID: {channel.id}) 已找到。") else: print(f"警告：无法找到ID为 {NOTIFICATION_CHANNEL_ID} 的通知频道。请检查ID是否正确且机器人有访问权限。")@client.eventasync def on_member_update(before: discord.Member, after: discord.Member): """ 当服务器成员信息更新时触发的事件。 包括状态、昵称、角色等变化。 """ # 2. 检查是否是目标成员 if after.id == TARGET_MEMBER_ID: # 3. 检查状态是否发生变化 if before.status != after.status: print(f'{after.display_name} 的状态从 {before.status} 变为 {after.status}') # 4. 获取通知频道并发送消息 channel = client.get_channel(NOTIFICATION_CHANNEL_ID) if channel: # 状态枚举 discord.Status 包含 online, offline, idle, dnd (勿扰) 等 status_map = { discord.Status.online: "在线", discord.Status.offline: "离线", discord.Status.idle: "挂机", discord.Status.dnd: "勿扰", discord.Status.invisible: "隐身" # 隐身状态也会被视为offline } before_status_text = status_map.get(before.status, str(before.status)) after_status_text = status_map.get(after.status, str(after.status)) message = f"**{after.display_name}** 的状态已更新：从 `{before_status_text}` 变为 `{after_status_text}`。" await channel.send(message) else: print(f"无法向频道 {NOTIFICATION_CHANNEL_ID} 发送消息：频道未找到或机器人无权限。")# 运行机器人if __name__ == "__main__": if not BOT_TOKEN: print("错误：未设置 DISCORD_BOT_TOKEN 环境变量。请在运行前设置。") else: client.run(BOT_TOKEN)
代码解析：
Intents 配置：在 discord.Client 初始化时，通过 intents=intents 传入启用了 members 和 presences 的 Intents 对象。目标成员和频道：TARGET_MEMBER_ID 和 NOTIFICATION_CHANNEL_ID 需要替换为实际的 Discord 用户ID和频道ID。on_member_update 事件：当任何成员信息更新时，此协程都会被调用。成员ID检查：if after.id == TARGET_MEMBER_ID: 确保我们只处理特定成员的更新。状态变化检查：if before.status != after.status: 是检测用户状态是否发生变化的关键。before.status 和 after.status 都是 discord.Status 枚举类型。获取频道：client.get_channel(NOTIFICATION_CHANNEL_ID) 用于获取目标通知频道对象。发送消息：await channel.send(message) 将通知消息发送到指定频道。状态映射：status_map 提供了一个将 discord.Status 枚举值转换为更友好的中文描述的示例。
注意事项
Intents 配置的双重检查：确保您的机器人代码和 Discord 开发者门户中的 PRESENCE INTENT 和 SERVER MEMBERS INTENT 都已启用。任何一方未启用都会导致机器人无法接收到相应的事件。机器人权限管理：确保您的机器人在目标服务器中拥有足够的权限：读取消息/查看频道：以便获取频道对象。发送消息：以便在频道中发送通知。读取成员：这是 SERVER MEMBERS INTENT 的一部分，确保机器人可以访问成员列表和属性。读取在线状态：这是 PRESENCE INTENT 的一部分，确保机器人可以接收状态更新。状态枚举 discord.Status：discord.Status 枚举包含 online（在线）、offline（离线）、idle（挂机）、dnd（勿扰）和 invisible（隐身）。请注意，invisible 在很多情况下会被 Discord API 视为 offline。错误处理与健壮性：在实际应用中，您可能需要添加更完善的错误处理，例如当 client.get_channel() 返回 None 时，或者发送消息失败时。大型服务器的性能考量：对于拥有大量成员的服务器，频繁的 on_member_update 事件可能会对机器人性能造成一定影响。如果只需要监听少数特定用户，可以在事件处理函数开头尽快过滤掉不相关的用户。
总结
通过本教程，您应该已经掌握了如何使用 Discord.py 的 on_member_update() 事件来监听服务器成员的状态变化，并向指定频道发送通知。记住，正确配置 Intents 是实现此功能的关键前提。遵循这些步骤，您可以构建出响应用户活动、功能强大的 Discord 机器人。
以上就是Discord.py 教程：监听用户状态变化并发送通知消息的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1374789.html
微信扫一扫 
支付宝扫一扫 
