精选直播

精选直播功能让你的服务器显示一个小型的其他 Owncast 直播目录。 访客在你的主页上会看到一个 精选 标签，列出你所展示的服务器，并显示每个服务器的在线或离线状态。 当你没有直播时，它为人们提供了一个前往的去处，并且是发现相关直播的一种方式。

展示双方均需选择加入。 你选择要展示哪些服务器，对方的管理员则选择是否允许你展示他们的服务器。 两个服务器可以互相展示，但双方需要独立批准对方。

Featured streams require Owncast v0.3.0

精选直播是 Owncast 0.3.0 的全新功能。 如果你遇到 bug 或有建议，请 提交 issue 或 与社区实时聊天。

开始之前

精选直播基于为 Owncast 的 社交功能 提供支持的相同联邦，因此：

• 必须启用社交功能 在你的服务器和你想要展示的服务器上。
• 对方服务器也必须运行 Owncast，并且版本要足够新以支持精选直播。
• 必须可以通过标准端口 (443) 的 HTTPS 访问。 在非标准端口发布的服务器无法被展示。

展示其他直播

1. 在管理侧栏中，打开 精选直播。
2. 点击 展示直播。
3. 输入你想展示的服务器地址，例如 https://otherserver.example.com。
4. 保存。

该服务器会立即出现在你的列表中，显示为 等待批准 状态，但尚未向访客显示。 展示一个服务器会向其发送请求，该服务器的管理员必须批准请求，条目才会生效。 这可以阻止任何人在未获对方同意的情况下将其列为精选。

批准展示你的请求

当其他服务器展示你时，请求会出现在管理员的 精选直播 中。 侧栏的 精选直播 项会带有一个徽章，显示等待你处理的请求数量，这样你无需特意查看就能注意到它们。 批准请求后，该服务器可能会在其目录中列出你。 在你批准之前，对方服务器会将你的条目标记为等待状态，并对其访客保持隐藏。

批准请求与常规关注者是分开的。 展示你的服务器不会出现在你的“关注者”列表或计数中。

你可以在关注者管理的 展示你 选项卡下查看当前所有正在展示你的目录，并删除其中任何一项。 移除后会停止向其发送你的直播状态，因此你的条目将从该目录中消失。

访客会看到什么

一旦你所展示的服务器批准了请求，它就会出现在你主页的 精选 标签中：

• 在线的服务器会显示当前直播的缩略图和标题，并排在顶部。
• 离线的服务器会显示服务器的标志。
• 每张卡片都会显示服务器名称和地址，并链接到该服务器，以便访客可以前往观看。

该标签页大约每分钟自动刷新一次，因此精选服务器上/下线会在不需任何人重新加载页面的情况下更新显示。

服务器的状态反映其真实的运行情况：

• 在直播开始后大约一分钟内会显示为在线。
• 直播结束后会立即恢复为离线。
• 如果精选服务器在未正常结束直播的情况下消失（例如崩溃或失去连接），其条目在大约十分钟后会回落为离线。

停止展示直播

在 精选直播 中，点击你不再希望列出的服务器旁的 取消展示。 它将从你的目录中移除，访客不再看到它。

建立你自己的目录

精选直播构建在 Owncast 的 ActivityPub 支持之上。 如果你更愿意构建自己的目录或聚合器来跟踪在线的 Owncast 服务器，而不是使用内置的精选标签，请参阅 ActivityPub 协议参考中的 构建 Owncast 直播目录。

如需完整可运行的示例，请参见 owncast-directory-example 仓库。 它是一个小型的参考应用，会关注 Owncast 服务器、跟踪哪些服务器处于在线状态、接受管理员提交，并提供一个列出这些服务器的网页。 它仅仅是一个概念验证示例，并不适用于生产环境，但它展示了如何使用 ActivityPub API 来构建 Owncast 直播目录。