获取 YouTube API 密钥
Astral Overlay 的 YouTube 聊天需要你自己的 YouTube Data API v3 密钥。Twitch 面板不需要此配置。
1. 打开 Google Cloud
Section titled “1. 打开 Google Cloud”打开 Google Cloud Console 并登录 Google 账户。用顶部项目选择器创建项目，或选择已用于此集成的项目。
使用 Astral Overlay Chat 之类的名称便于日后识别。接下来的步骤中请保持选中该项目。
2. 启用 YouTube Data API v3
Section titled “2. 启用 YouTube Data API v3”在 API 库中打开 YouTube Data API v3 页面，选择启用。
若已启用，可继续进入凭据页面。启用其他 YouTube 相关 API 并不能替代此步骤。
3. 创建 API 密钥
Section titled “3. 创建 API 密钥”打开 API 和服务 > 凭据，选择创建凭据 > API 密钥。
如果创建对话框询问密钥可访问哪个 API，选择 YouTube Data API v3。复制生成的密钥，并为其设置易识别的名称。
请选择 API 密钥，而非 OAuth 客户端 ID 或服务账户凭据。当前聊天配置接受密钥字符串。
若控制台布局不同，请查阅 Google 的 YouTube 凭据说明。
4. 设置兼容的限制
Section titled “4. 设置兼容的限制”在凭据页面打开密钥设置：
- 在 API 限制下选择限制密钥，并仅选中 YouTube Data API v3。
- 在应用限制下，除非你会维护外部 IP 限制，否则无限制是当前 Windows 客户端的实用选项。
- 保存设置。
Astral Overlay 从你的计算机直接发起请求。网站限制不适用于该客户端，即便将其设为本文档网站也不适合。Android 和 iOS 限制同样不适用。
如需更严格的访问限制，可用 IP 地址限制允许计算机的公网互联网 IP。连接或 VPN 变化时必须更新。不要输入 127.0.0.1 或家庭网络中的私有地址。
不设置应用限制意味着密钥未绑定到特定计算机。请保留仅限 YouTube 的 API 限制，并保密密钥。Google 的限制参考文档介绍了可用选项。
5. 粘贴到 Astral Overlay
Section titled “5. 粘贴到 Astral Overlay”- 打开屏幕 > 添加聊天，选择 YouTube。
- 将直播视频链接粘贴到视频字段。
- 将密钥粘贴到 API 密钥字段。
- 添加聊天面板。
使用直播视频 URL，不要使用频道主页。Astral Overlay 在界面中隐藏密钥，并在添加聊天时保存新密钥。卡片也可忘记已保存的密钥。
| 消息或现象 | 检查内容 |
|---|---|
| API 未启用 | 在密钥所属项目中启用 YouTube Data API v3。 |
| 密钥无效 | 重新复制 API 密钥，不要粘贴客户端 ID 或项目 ID。 |
| 密钥限制阻止应用 | 检查 YouTube API 限制，以及网站或外部 IP 限制是否拒绝了此计算机。 |
| 配额用尽 | 查看项目的 API 配额。在同一项目重新创建密钥不会刷新项目配额。 |
| 没有直播聊天 | 确认视频正在直播且聊天可用。 |
YouTube API 请求消耗项目配额。Google 的配额文档介绍请求成本与每日重置；实际额度请查看项目控制台。
不要在截图、源代码或支持请求中公开密钥。如果已泄露，请在 Google Cloud 中更换，并更新 Astral Overlay 中的密钥。