You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Discord.js v14如何检测用户进出游戏并获取游戏名称?

Discord.js v14 presenceUpdate 事件优化方案

你当前的代码存在几个关键问题,导致不稳定和崩溃:

  • 错误使用事件参数:v14 中 presenceUpdate 的参数是 oldPresence 和 newPresence,而非成员对象(oldMember/newMember),你混淆了事件参数类型。
  • 依赖内部属性:frozenPresence 是 Discord.js 的内部私有属性,不应该被外部代码调用,其行为随时可能变化。
  • 未过滤触发场景:presenceUpdate 会在用户状态(在线/离线)、设备切换、非游戏活动更新(如 Spotify 播放)等多种场景触发,你没有限制只处理游戏活动的变化。
  • 空值未处理:直接访问 game.name 等属性时,未判断对象是否存在,一旦为空就会抛出异常导致崩溃。

改进后的代码实现

discordClient.on("presenceUpdate", (oldPresence, newPresence) => {
    // 跳过机器人用户,避免不必要的处理
    if (newPresence.user?.bot || oldPresence?.user?.bot) return;

    const user = oldPresence?.user?.username || newPresence.user.username;
    const userId = newPresence.user.id;

    // 从状态中提取游戏活动(v14 中使用 activities 数组,TYPE.Game 对应值为 0)
    const getGameActivity = (presence) => {
        return presence?.activities.find(activity => activity.type === 0);
    };

    const oldGame = getGameActivity(oldPresence);
    const newGame = getGameActivity(newPresence);

    // 情况1:用户停止玩游戏(旧状态有游戏,新状态无游戏)
    if (oldGame && !newGame) {
        sendGroupMeMessage(`${user} 停止玩 ${oldGame.name}`, () => {});
        return;
    }

    // 情况2:用户开始玩新游戏或切换游戏
    if (newGame && (!oldGame || oldGame.name !== newGame.name)) {
        sendGroupMeMessage(`${user} 正在玩 ${newGame.name}`, () => {});
        return;
    }

    // 其他非游戏相关的状态更新直接忽略
});

关键优化点说明

  • 参数类型修正:严格遵循 v14 定义的事件参数,通过 presence.user 获取用户信息,避免类型混淆。
  • 安全获取游戏活动:使用官方推荐的 activities 数组筛选游戏类型活动,替代废弃的 game 属性,同时用可选链操作符(?.)避免空值报错。
  • 精准触发逻辑:只在以下核心场景触发消息:
    • 用户从有游戏状态变为无游戏状态
    • 用户从无游戏状态变为有游戏状态
    • 用户切换了不同的游戏
  • 空值防护:所有可能为 null/undefined 的属性访问都做了安全处理,彻底避免因空值导致的崩溃。
  • 过滤机器人:排除机器人用户的状态更新,减少无效处理开销。

内容的提问来源于stack exchange,提问作者Dennis

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.18 19:20:47