Discord.py 教程：监听用户状态变化并发送通知消息

在构建 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。

Machine Translation

聚合多个来源的AI翻译

下载

前置条件：启用必要的 Intents

为了让机器人能够接收到成员状态更新的事件，您需要在机器人代码和 Discord 开发者门户中启用特定的 Intents（意图）。这是 Discord API 设计中一个重要的权限控制机制。

1. 在代码中启用 Intents： 您需要启用 discord.Intents.members 和 discord.Intents.presences。

   import discord
   
   # 启用所需的Intents
   intents = discord.Intents.default()
   intents.members = True    # 允许机器人接收成员相关事件
   intents.presences = True  # 允许机器人接收成员在线状态相关事件
   
   client = discord.Client(intents=intents)

2. 在 Discord 开发者门户配置： 登录 Discord Developer Portal，选择您的机器人应用，进入“Bot”页面。在“Privileged Gateway Intents”部分，确保 PRESENCE INTENT 和 SERVER MEMBERS INTENT 都已启用。如果未启用，机器人将无法接收到相应的事件。

实现用户状态变化检测与通知

下面我们将通过一个具体的代码示例，展示如何利用 on_member_update() 事件来检测指定用户的状态变化，并向特定频道发送通知。

import discord
import os

# 1. 启用所需的Intents
intents = discord.Intents.default()
intents.members = True    # 允许机器人接收成员相关事件
intents.presences = True  # 允许机器人接收成员在线状态相关事件

client = discord.Client(intents=intents)

# 配置您的机器人Token
# 建议将Token存储在环境变量中，以提高安全性
BOT_TOKEN = os.getenv("DISCORD_BOT_TOKEN")

# 配置要监听的成员ID和通知频道ID
TARGET_MEMBER_ID = 123456789012345678  # 替换为要监听的Discord用户ID
NOTIFICATION_CHANNEL_ID = 987654321098765432 # 替换为要发送通知的频道ID

@client.event
async 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.event
async 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)

代码解析：

1. Intents 配置：在 discord.Client 初始化时，通过 intents=intents 传入启用了 members 和 presences 的 Intents 对象。
2. 目标成员和频道：TARGET_MEMBER_ID 和 NOTIFICATION_CHANNEL_ID 需要替换为实际的 Discord 用户ID和频道ID。
3. on_member_update 事件：当任何成员信息更新时，此协程都会被调用。
4. 成员ID检查：if after.id == TARGET_MEMBER_ID: 确保我们只处理特定成员的更新。
5. 状态变化检查：if before.status != after.status: 是检测用户状态是否发生变化的关键。before.status 和 after.status 都是 discord.Status 枚举类型。
6. 获取频道：client.get_channel(NOTIFICATION_CHANNEL_ID) 用于获取目标通知频道对象。
7. 发送消息：await channel.send(message) 将通知消息发送到指定频道。
8. 状态映射：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 机器人。