自建直播服務：把自己伺服器上的直播接到 Apple TV
除了 M3U 播放清單，Revue 也能連接你自己架設的直播服務。這個服務在你家的區域網路裡執行，依照公開的 Revue Server Protocol（英文）提供直播間清單與 HLS 直播串流。Revue 負責顯示清單、播放和顯示彈幕。伺服器能以 HLS 提供的直播，Revue 都能播放。
Revue 不附帶伺服器程式，也不提供任何直播內容。伺服器要接什麼內容、怎麼接，由你決定。本文說明 Revue 這一端：什麼時候適合自建服務、怎麼新增、出問題時怎麼檢查。伺服器怎麼寫，請見協定文件。
什麼時候適合自建服務
- 只有固定的直播網址： 用 M3U 播放清單就夠了，不需要伺服器。請見在 Apple TV 上看 IPTV：匯入 M3U 播放清單與節目表。
- 內容會變動： 哪些直播間正在直播、分區怎麼排、封面與觀看人數，這些都會隨時變化，M3U 無法表達。伺服器可以隨時告訴 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 找到第一台相容的伺服器就會直接使用。畫面上會顯示「已發現區域網路伺服器 …」。
- 其他情況下，請前往 設定 › 直播來源，在「於區域網路發現」下方選取伺服器，即可新增。
手動輸入位址
- 前往 設定 › 直播來源 › 新增直播來源。
- 選取「位址」，輸入伺服器位址，例如
http://192.168.1.100:8787。沒寫http://時，Revue 會自動補上。Revue 沒有預設連接埠，位址裡要寫上伺服器的連接埠。 - 「名稱」可以不填。不填時，Revue 使用位址裡的主機名稱。
- 選取「儲存」。
儲存時 Revue 只檢查位址格式，不檢查能不能連線。
全新安裝後，清單裡已經有一項「我的伺服器」，位址是空的。你也可以長按它，選取「編輯」，替它填上位址。
新增之後
- 伺服器上的每個來源，在側邊欄裡各占一項。在側邊欄選取來源，就能看它的直播間。
- 新增的伺服器不會自動成為目前來源，除非之前沒有任何來源。請在 設定 › 直播來源 裡選取它，或在側邊欄選取它的來源。
- 收藏的直播間在收藏頁的「串流直播」下方。
- 開啟 iCloud 同步時，伺服器清單會同步到同一個 iCloud 帳號下的其他 Apple TV。
刪除伺服器： 在 設定 › 直播來源 裡長按伺服器，選取「刪除…」，再確認。清單裡只剩一台伺服器時，無法刪除。刪除後，這台伺服器上的收藏會變灰，顯示「來源已刪除」。重新新增同一台伺服器，這些收藏也不會恢復。開啟 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 加密的內容。