Overview
适用范围
- 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 链接。