> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube 通知

> 在您的 Discord 服务器中公告新的 YouTube 上传和直播。

<Info>
  需要 **Basic**。每服务器最多 **10 个频道**。共享规则请参见 [通知如何工作](/zh-CN/notifications/overview)。
</Info>

## 添加频道

按频道名搜索。Vetox 将其解析为频道 ID；无法解析的频道会以 **YouTube channel not found** 被拒绝。

## 设置

| 设置             | 默认值        | 说明  |
| -------------- | ---------- | --- |
| **Discord 频道** | —          | 必需  |
| **上传时通知**      | **开启**     | 新视频 |
| **直播时通知**      | **开启**     | 直播  |
| **提及角色**       | 无          |     |
| **自定义通知嵌入**    | YouTube 默认 | 红色  |

<Warning>
  **同时** 关闭两个开关保存时不会有任何提示，并保证该频道永远不会公告任何东西。此状态没有警告。
</Warning>

## 变量

| 变量                  | 解析为     |
| ------------------- | ------- |
| `{channel.name}`    | 频道名     |
| `{channel.avatar}`  | 频道头像    |
| `{video.title}`     | 视频标题    |
| `{video.url}`       | 视频 URL  |
| `{video.thumbnail}` | 视频缩略图   |
| `{video.type}`      | 是上传还是直播 |

## 如何发现新内容

每 **5 分钟** 检查一次，每个频道 **10 分钟冷却**。Vetox 读取频道的动态，每次考虑最新的 **5** 个条目。

<Note>
  在一个 5 分钟窗口内发布超过 5 个视频的频道可能会漏掉其中最早的几个。
</Note>

<Warning>
  **预定的首播被公告为上传**，使用上传的措辞而非直播的措辞。如果您的嵌入写 "went live"，首播会读起来不正确。
</Warning>

## 实操设置

<Steps>
  <Step title="在服务器设置中启用 YouTube" />

  <Step title="按名字添加频道" />

  <Step title="如果需要不同措辞，请分离上传和直播">
    您无法将同一个 YouTube 频道的上传和直播路由到不同的 Discord 频道 —— 每个条目一个频道。请在嵌入中使用 `{video.type}` 来区分它们。
  </Step>

  <Step title="检查目标频道的嵌入链接权限" />
</Steps>

## 疑难解答

<AccordionGroup>
  <Accordion title="新视频未被公告">
    先检查服务器设置的开关和高级会员。然后确认两个通知开关中至少有一个开启。如果视频已超过 2 小时，它会被有意跳过。
  </Accordion>

  <Accordion title="首播被公告为普通上传">
    这是预期行为 —— 首播被归类为上传。
  </Accordion>

  <Accordion title="Shorts 被公告但我不想要">
    没有过滤器可排除 Shorts。频道动态上的所有内容都同等对待。
  </Accordion>

  <Accordion title="公告延迟最多五分钟">
    这就是轮询间隔。YouTube 每 5 分钟检查一次，不是即时的。
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/zh-CN/notifications/twitch">
  带即时状态跟踪的直播。
</Card>