Revue
简体中文

指南

自建直播服务：把自己服务器上的直播接到 Apple TV

除了 M3U 播放列表，Revue 还能接入你自己运行的直播服务。这个服务跑在你家的局域网里，按公开的 Revue Server Protocol（英文）提供直播间列表和 HLS 直播流。Revue 负责显示列表、播放和显示弹幕。服务器能用 HLS 提供的直播，Revue 都能播。

Revue 不附带服务器程序，也不提供任何直播内容。服务器接什么内容、怎么接，由你决定。本文讲 Revue 这一侧：什么时候用自建服务、怎么添加、出了问题怎么查。服务器怎么写，见协议文档。

什么时候用自建服务

服务器提供了哪项功能，Revue 就显示哪项；没提供的，Revue 会隐藏。服务器可以提供：

  • 多个来源。每个来源在 Revue 的侧边栏里占一项。
  • 分区和直播间。来源首页按分区一行一行显示直播间，卡片上有封面、标题和观看人数。
  • 在播状态。不在播的直播间打开后显示状态页，例如「未开播」。主播回来后，Revue 自动恢复播放。
  • 关注。在直播间卡片上长按，或者在播放时的浮层里，可以关注或取消关注。
  • 线路和清晰度。播放时在浮层里切换。
  • 弹幕。默认关闭，见下文打开弹幕。

Revue 里自建服务器的来源首页：直播间按分区成行显示，卡片上有封面、标题和观看人数

准备服务器

复制提示词，发给 AI Coding Agent，让它照协议写服务器。

  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Gemini CLI
按 Revue Server Protocol 写一个直播服务器。
协议原文：https://revue.vastlogic.dev/docs/server-protocol.md
要接的直播：（在这里写明）
写完后，按协议第 9 节的检查清单逐条核对。

  • 服务器和 Apple TV 要在同一个局域网里。
  • 想让 Revue 自动找到服务器，服务器要用 Bonjour 广播。 做法见协议第 2 节。不广播也可以，在 Revue 里手动填地址。

在 Revue 里添加服务器

第一次打开 Revue 时，tvOS 会问是否允许 Revue 访问本地网络。选择允许，Revue 才能在局域网里找到你的服务器。

自动发现

Revue 打开后会在局域网里找兼容的服务器。

  • 如果你还没有添加任何服务器或 M3U 播放列表，Revue 找到第一台兼容的服务器就直接用它。屏幕上会显示「已发现局域网服务器 …」。
  • 其他情况下，到 设置 › 直播源，在「在局域网发现」下面选中服务器，就能添加。

手动填写地址

  1. 打开 设置 › 直播源 › 添加直播源。
  2. 选择「地址」，填写服务器地址，例如 http://192.168.1.100:8787。不写 http:// 时，Revue 自动补上。Revue 没有默认端口，地址里要写上服务器的端口。
  3. 「名称」可以不填。不填时，Revue 用地址里的主机名。
  4. 选择「保存」。

保存时 Revue 只检查地址格式，不检查能不能连上。

全新安装后，列表里已经有一项「我的服务器」，地址是空的。你也可以长按它，选择「编辑」，给它填上地址。

添加之后

  • 服务器上的每个来源，在侧边栏里各占一项。在侧边栏里选择来源，就能看它的直播间。
  • 新加的服务器不会自动成为当前源，除非之前没有任何源。在 设置 › 直播源 里选中它，或者在侧边栏里选择它的来源。
  • 收藏的直播间在收藏页的「流媒体直播」下面。
  • 打开 iCloud 同步时，服务器列表会同步到同一 iCloud 账号下的其他 Apple TV。

Revue 的侧边栏列出同一台服务器上的三个来源

删除服务器： 在 设置 › 直播源 里长按服务器，选择「删除…」，再确认。列表里只剩一台服务器时，不能删除。删除后，这台服务器上的收藏会变灰，显示「源已删除」。重新添加同一台服务器，这些收藏也不会恢复。打开 iCloud 同步时，删除会同步到你的所有 Apple TV。

打开弹幕

弹幕默认关闭。有两个地方可以打开：

  • 设置 › 弹幕 › 显示弹幕。在这里还能调整显示区域、速度、字号和透明度。
  • 播放时，按遥控器的右键或确认键打开浮层，选择最左边的弹幕按钮。

播放时打开的浮层：标题、观看人数和主播名，右侧按钮最左边是弹幕按钮

只有服务器为这个直播间提供了弹幕，播放页才会有弹幕按钮。弹幕只来自你的服务器，Revue 不能发弹幕。

直播播放时，弹幕从画面上方飘过

常见问题

现象 原因和处理
首页显示「未发现直播源」 Revue 没找到服务器，也没有 M3U 播放列表。确认服务器在运行，并且和 Apple TV 在同一个局域网里。服务器不广播 Bonjour 时，要手动填地址。
「在局域网发现」下面显示「…协议版本（vX）与本客户端（v4）不兼容」 服务器广播的版本号不是 4。按协议的第 4 版更新服务器。
服务器下面一直显示「暂未获取到源列表」 Revue 连不上服务器，或者服务器的 /api/sources 返回的内容不符合协议。在同一网络的电脑上，用浏览器打开「服务器地址 + /api/sources」，看看返回了什么。
「无法加载列表」 下面一行写着原因。「服务器协议版本不兼容」说明服务器还没升级到第 4 版。「服务返回 HTTP …」说明服务器报了错。其他情况，用协议第 8 节的 JSON Schema 校验服务器的返回内容：一个直播间里有一个字段类型不对，整个列表都会加载失败。
「没有在线房间」 服务器返回的列表是空的。
打开直播间后显示「未开播」之类的状态页 服务器告诉 Revue，这个直播间现在不在播。状态文字由服务器提供。主播回来后，Revue 自动恢复播放。
「无法播放 …」 直播流没能播放。可以选择「换线路重试」。直播流要是 Apple TV 能播的 HLS。
收藏的直播间显示「源已删除」 它所在的服务器被删除了。这些收藏不能恢复，重新添加服务器后要重新收藏。

使用责任

  • Revue 和 Vast Logic 不提供、不托管、也不推荐任何直播来源。服务器接什么内容，由你自己决定，Revue 不参与。
  • 只在个人范围、自己的局域网里使用。不要把服务器开放到公网，不要提供给他人使用，不要用于商业用途。
  • 只接入你有权观看的内容，并遵守内容来源的使用条款和版权法。
  • Revue 不支持 DRM 加密的内容。