聊天机器人中显示当前直播分类的 !游戏 命令

机器人从哪里获取当前游戏名称

!游戏 命令通常显示的不是电脑上运行的程序，而是 Twitch 频道的当前分类。主播在直播控制面板中更改游戏或分类，机器人则通过内置变量或 API 请求获取该值。

如果 Twitch 面板中仍保留着上一个游戏、选择了“聊天”分类或该字段未填写，机器人也会输出相同的值。聊天机器人本身无法识别屏幕上的游戏：它处理的是平台或外部自动化所传递的数据。

请先更新 Twitch 频道分类

在配置命令之前，请确认你在哪里更改分类：是在 Creator Dashboard 面板中、通过直播管理软件，还是通过机器人的集成功能。重要的是观众在直播页面上看到的频道最终状态。

更换游戏后，不要指望所有服务都能立即更新。机器人可能会将最后的值缓存在本地，而平台传递更新数据也可能存在延迟。对于 !游戏 命令，最好在开播前更改分类，并单独在聊天中检查回复。

Nightbot 中的 !游戏 命令

在 Nightbot 中打开 Custom Commands，创建 !游戏 命令，并填写带有 Twitch 变量的消息。对于当前频道，通常使用这样的回复：“当前正在玩：$(twitch game $(channel))”。

变量 $(channel) 会替换为调用该命令的频道，而 $(twitch game ...) 则请求该频道的分类。如果机器人服务多个频道，这种方式比在每个命令中手动填写主播登录名更方便。

• Command: !游戏
• Message: 当前正在玩：$(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: 设置延迟，以免相同的回复刷屏聊天

Nightbot 的缺点在于回复逻辑有限。若要在没有额外变通方案的情况下处理空分类、多种文本变体或来自自有日程的数据，将会比较困难。

StreamElements 中显示分类的命令

在 StreamElements 中，当前游戏的变量通常以 ${game} 的形式添加到命令回复中。在 Chat bot 部分创建 !游戏 命令，并设置文本：“当前游戏：${game}”。

保存前，请用观众账号在聊天中测试该命令。如果机器人未连接到正确的频道，或频道分类尚未更新，该变量可能会返回旧值或空文本。权限和延迟设置也在命令参数中的同一位置。

• Command: !游戏
• Response: 当前游戏：${game}
• Permission: Everyone
• Cooldown: 根据聊天活跃度进行调整

StreamElements 的缺点在于该命令依赖于该服务自身与 Twitch 的集成。如果授权出现故障或同步延迟，你无法在不修改命令的情况下手动修正回复。

如何通过 Streamer.bot 输出分类

在 Streamer.bot 中，通过 Action 构建命令更为方便。创建一个动作，用于获取 Twitch 频道信息，然后向聊天发送消息。在执行获取频道数据的子动作后，动作参数中通常可以获取到游戏名称 gameName。

在 Send Message 子动作中填写，例如：“当前正在玩：%gameName%”。然后在 Commands 部分将 Action 绑定到 !游戏 命令。如果你使用的 Streamer.bot 版本中参数名称不同，请先以测试模式运行动作，查看 Twitch 子动作返回的参数列表。

Streamer.bot 的缺点在于需要更多手动配置。你需要自行关联命令、动作、机器人对聊天的访问权限以及 Twitch 授权，因此任何环节出错都会导致命令没有回复。

通过 Twitch API 请求分类

自定义机器人、脚本或 Streamer.bot 中的 Action 可以通过 Twitch API 直接获取分类。为此，首先需要获取频道的数字标识符：请求 GET https://api.twitch.tv/helix/users?login=频道登录名 会返回用户数据，其中包括 id。

接着使用请求 GET https://api.twitch.tv/helix/channels?broadcaster_id=频道ID。API 响应中包含 game_name 字段——即当前分类的名称，可以在回复 !游戏 时发送到聊天中。

请求需要 Client-ID 和带有访问令牌的 Authorization 请求头。请勿将令牌和应用标识符粘贴到命令的明文、公开仓库或浏览器小组件中：这些数据应存储在机器人设置或环境变量中。

API 命令的配置步骤

1. 在 Twitch 开发者面板中创建应用并获取 Client ID。
2. 获取具有频道数据访问权限的令牌，并将其保存在你的机器人或脚本设置中。
3. 通过 users 端点按登录名确定频道的 broadcaster_id。
4. 使用 broadcaster_id 向 channels 端点发送请求。
5. 从响应中取出 game_name 字段并生成聊天消息。
6. 如果 game_name 为空，输出中性文本而非空回复。

不要对聊天中的每条消息都轮询 API。更实用的做法是在首次调用 !游戏 时更新值，在命令延迟期间保存该值，并在缓存过期后重新获取数据。手动更改分类后，可以通过单独的管理员命令强制更新值。

如何更新分类并避免收到旧回复

如果你在直播过程中更换游戏，请先在 Twitch 上更新分类，然后等待新值出现在频道页面上，之后再检查 !游戏。如果机器人使用了缓存，请清除缓存或等待下一次 API 请求。

对于单个频道，通常只需在调用命令时更新分类，而无需启动持续轮询。如果需要自动监控，请以适度的间隔进行检查，并考虑 API 的限制。频繁请求不会让数据更准确，反而可能导致平台方面的限制。

直接使用 API 方式的缺点在于需要关注令牌。在访问被撤销、密码更改、应用权限变更或授权出错后，命令可能会开始输出旧分类或停止响应。

电脑上的游戏识别及其局限性

只有在 Twitch 分类不手动更改时，才需要单独的识别工具。这种自动化会跟踪运行中的进程、游戏平台数据、活动窗口或遥测信息，将游戏与 Twitch 分类进行匹配，并通过 API 更新频道。

之后机器人仍然读取的是 Twitch 分类，而非屏幕内容。自动化只是替你更改频道数据。如果游戏通过启动器运行、使用的是浏览器版本、进程名称与游戏不匹配，或主播切换到了其他程序，它可能会出错。

识别的缺点在于需要单独配置和监控。对于包含多个游戏、模组、模拟器和技术场景的直播，手动更改分类往往更可靠。

空分类、多个游戏和手动文本

平台只传递一个当前分类。如果直播中有多个游戏，!游戏 命令应显示当前正在进行的那个，而直播计划最好放在单独的 !日程 命令或频道描述中。

对于空分类，请准备清晰的回复：“当前分类尚未指定”或“现在是聊天直播”。在 Nightbot 和 StreamElements 中，这种处理可能需要单独的命令或手动更改文本。在自定义 API 脚本中，可以检查 game_name 字段是否为空，并填入备用选项。

手动命令仍是可行的备用方案：“当前正在玩：游戏名称”。缺点显而易见——更换游戏后很容易忘记更新，观众将收到错误信息。

权限、延迟和开播前检查

主要的 !游戏 命令通常对所有观众开放，但会添加 cooldown。这可以减少多人同时询问游戏时相同消息的重复。清除缓存、手动更新文本或重启 Action 的命令请保留给管理员和频道所有者。

在更换机器人、令牌或 Twitch 集成后，请检查命令。 即使变量正确，如果机器人连接到其他频道或失去了读取数据的权限，也无济于事。

1. 在 Twitch 面板中指定所需的游戏或分类。
2. 确认新名称在频道页面上可见。
3. 确认聊天机器人连接到的正是你的频道。
4. 用普通观众账号调用 !游戏。
5. 更改分类，并在缓存更新或命令延迟后再次调用。
6. 检查空分类和聊天直播期间的回复。
7. 如果使用 API，请检查令牌有效期和请求错误日志。