Discord.py 教程:实时检测用户状态变化并发送通知

花韻仙語
发布: 2025-10-01 08:58:02
原创
1055人浏览过

Discord.py 教程:实时检测用户状态变化并发送通知

本教程将指导您如何使用 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 Intents
intents = discord.Intents.default()
intents.members = True
intents.presences = True

# 创建机器人客户端实例时传入配置好的 Intents
client = discord.Client(intents=intents)

# 或者,如果您使用的是 commands.Bot
# from discord.ext import commands
# bot = commands.Bot(command_prefix='!', intents=intents)
登录后复制

注意事项:

ViiTor实时翻译
ViiTor实时翻译

AI实时多语言翻译专家!强大的语音识别、AR翻译功能。

ViiTor实时翻译 116
查看详情 ViiTor实时翻译
  • 如果您在 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. 配置 Intents
intents = discord.Intents.default()
intents.members = True
intents.presences = True

client = discord.Client(intents=intents)

TARGET_CHANNEL_ID = YOUR_GENERAL_CHANNEL_ID_HERE # 替换为您的目标频道ID (例如: 123456789012345678)
TARGET_MEMBER_ID = YOUR_TARGET_MEMBER_ID_HERE # 替换为您想要监听的特定成员ID (可选,如果监听所有成员则无需)

@client.event
async 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.event
async 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 教程:实时检测用户状态变化并发送通知的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号