Red-DiscordBot 流媒体通知功能完全指南

Red-DiscordBot 流媒体通知功能完全指南

Red-DiscordBot A multi-function Discord bot 项目地址: https://gitcode.com/gh_mirrors/re/Red-DiscordBot

概述

Red-DiscordBot 的 Streams 模块是一个强大的流媒体通知系统，它可以帮助 Discord 服务器管理员和成员实时追踪多个平台的直播状态。本文将详细介绍该模块的功能、配置方法以及最佳实践。

功能特点

Streams 模块主要提供以下核心功能：

1. 多平台支持：目前支持 Twitch、YouTube 和 Picarto 三大流媒体平台
2. 实时通知：当关注的频道开始直播时，自动在指定 Discord 频道发送通知
3. 自定义消息：可完全自定义通知消息内容和格式
4. 提及选项：支持配置多种提及方式（@everyone、@here 或特定角色）
5. 自动清理：直播结束后可自动删除通知消息

模块加载

在使用 Streams 模块前，需要先加载它：

[p]load streams

其中 [p] 代表你的机器人命令前缀。

平台认证配置

Twitch 认证

要使用 Twitch 相关功能，需要配置 API 凭证：

1. 访问 Twitch 开发者控制台
2. 注册新应用程序
3. 设置 OAuth 重定向 URI 为 http://localhost
4. 选择适当的应用类别
5. 获取客户端 ID 和密钥后执行：

[p]set api twitch client_id <你的客户端ID> client_secret <你的客户端密钥>

YouTube 认证

YouTube 功能需要 API 密钥：

1. 创建 Google Cloud 项目
2. 启用 YouTube Data API v3
3. 创建 API 密钥
4. 执行以下命令配置：

[p]set api youtube api_key <你的API密钥>

安全提示：这些认证信息属于敏感数据，建议仅在私密频道或与机器人的私信中进行配置。

基础命令

检查直播状态

• Picarto：[p]picarto <频道名称>
• Twitch：[p]twitchstream <频道名称>
• YouTube：[p]youtubestream <频道ID或名称>

通知管理

创建/删除通知

• Picarto：[p]streamalert picarto <频道名称>
• Twitch：[p]streamalert twitch channel <频道名称>
• YouTube：[p]streamalert youtube <频道ID或名称>

查看当前通知

[p]streamalert list

停止通知

• 停止当前频道所有通知：[p]streamalert stop
• 停止服务器所有通知：[p]streamalert stop disable-all=yes

高级配置

通知消息定制

Streams 模块允许完全自定义通知消息：

1. 带提及的通知：

   [p]streamset message mention <消息内容>
   

   可用变量：

   • {mention} - 插入配置的提及
   • {stream} - 频道名称
   • {stream.display_name} - 频道显示名称（Twitch 可能不同）

2. 不带提及的通知：

   [p]streamset message nomention <消息内容>
   

3. 重置为默认消息：

   [p]streamset message clear
   

提及选项

• 切换基本提及：[p]streamset mention
• 切换 @everyone 提及：[p]streamset mention all
• 切换 @here 提及：[p]streamset mention online
• 切换角色提及：[p]streamset mention role <角色>

其他实用设置

1. 自动删除：直播结束后自动删除通知

   [p]streamset autodelete <on/off>
   

2. 忽略重播：不通知 Twitch 的重播内容

   [p]streamset ignorereruns
   

3. 检查频率：设置直播状态检查间隔（最小60秒）

   [p]streamset timer <秒数>
   

4. 按钮支持：切换通知消息中的按钮显示

   [p]streamset usebuttons
   

最佳实践

1. 合理设置检查频率：过于频繁的检查可能导致 API 限制，建议设置为60-300秒
2. 使用角色提及：相比 @everyone，为直播爱好者创建专门的角色进行提及更为友好
3. 消息模板设计：充分利用变量创建清晰的通知消息，例如：

   {mention}，{stream.display_name} 正在直播！快来围观吧！
   

4. 多频道管理：为不同类型的直播内容创建不同的 Discord 通知频道

常见问题

Q：为什么我的 Twitch/YouTube 通知不工作？ A：请确保已正确配置平台认证信息，并且机器人有权限发送消息到目标频道。

Q：如何知道当前有哪些活跃的通知？ A：使用 [p]streamalert list 命令查看当前服务器设置的所有通知。

Q：通知消息太频繁怎么办？ A：可以调整 [p]streamset timer 设置延长检查间隔，或考虑关闭自动删除功能。

通过合理配置 Streams 模块，你可以为 Discord 社区成员提供及时、个性化的流媒体通知服务，增强社区互动体验。

Red-DiscordBot A multi-function Discord bot 项目地址: https://gitcode.com/gh_mirrors/re/Red-DiscordBot