功能說明
適用範圍
- Viozi 1.0。iPhone / iPad 和 Mac 上可以新增、匯入、訂閱和管理頻道。
- Apple TV 首頁有「直播頻道」一行，可以播放頻道。本文不涵蓋在 Apple TV 上管理頻道的步驟。
- Viozi 只播放你自己提供的頻道地址，不自帶任何頻道。
開始前
- 準備好頻道的直播串流位址，或一份頻道清單（檔案或網址，格式為 .m3u、.m3u8、.pls 或 .txt）。
- 如果要顯示節目表，需要一個 XMLTV 網址（.xml 或 .xml.gz）。清單檔案頭裡帶的
url-tvg/x-tvg-url會被自動識別。
入口
- iPhone：「首頁」的直播一行，或「資料庫」→「直播」。
- iPad / Mac：側邊欄 →「直播」。
- 也可以從新增媒體來源的列表裡選「IPTV 直播（m3u 訂閱）」，它開啟的是和「直播」頁同一個訂閱面板。
步驟
- 開啟「直播」。還沒有頻道時會顯示「加入直播頻道」，以及三個按鈕。
- 選擇一種新增方式（有頻道後在右上角「加入頻道」選單裡）：
- 「加入頻道」：輸入一個頻道的名稱和地址。
- 「匯入頻道清單」：選擇 m3u / pls 檔案，或填一個清單網址，一次新增多個頻道，並勾選要加的頻道。
- 「清單訂閱」：訂閱一個清單網址，清單更新時 Viozi 會自動同步裡面的頻道。
- 回到「直播」，點頻道卡片開始播放。
- （可選）右上角選單 →「節目表」，在「節目表網址」裡一行填一個 XMLTV 網址，點「立即更新」。
預期結果
- 頻道以 16:9 卡片顯示，可以按清單裡的分組用膠囊篩選（「全部頻道」或某個分組），也可以「搜尋頻道」。
- 配好節目表後，卡片上顯示目前節目和時段（例如「19:00–19:30」），播放中帶「直播」標記。「節目表」頁會顯示「對上的頻道」數量和「上次更新」時間。
選項說明
| 選項 | 說明 |
|---|---|
| 節目表網址 | 一行一個 XMLTV 網址；頻道先按清單裡的 tvg-id 對應，沒有時按台名對應 |
| 清單裡附帶的網址 | 從已匯入清單的檔案頭裡識別到的節目表網址 |
| 立即更新 | 馬上重新下載節目表；平時每 12 小時更新一次 |
| 頻道資訊 | 長按（Mac 上右鍵）頻道卡片，檢視或修改名稱和地址 |
| 刪除頻道 | 來自訂閱的頻道刪除後，不會在訂閱重新整理時重新加入 |
限制
- 能不能播放取決於頻道本身的流格式、地址是否有效以及網路；Viozi 不能修復失效的頻道。
- 訂閱的清單有頻道數量上限，超過時只能一次性匯入，不會自動更新。
- 台名對應會去掉「高清」「HD」這類字尾來匹配，個別頻道可能對不上或對錯，可以在清單裡補 tvg-id。
- 在 Apple TV 上，使用明文 HTTP 的清單地址需要你允許後才會讀取。
故障排查
- 頻道打不開或一直載入：先在別的播放器裡確認這個地址能播；檢查是否需要 VPN 或特定網路。仍不行見 無法播放、卡頓、黑屏或顏色異常。
- 節目表顯示「節目表不是可讀取的 XMLTV 檔案。」：確認地址指向 XMLTV 的 .xml 或 .xml.gz，而不是網頁。
- 節目表伺服器傳回了錯誤：地址失效或伺服器拒絕存取，換一個節目表網址。
- 「對上的頻道」很少：清單裡缺 tvg-id，或台名差別太大。
- Apple TV 提示頻道的播放清單連結是明文 HTTP：重新播放並選擇允許，或改用直接的流地址或 https 連結。