orbitv Personal 支持的 M3U 和 M3U8 播放列表格式

M3U / M3U8 是什么

M3U 是一种纯文本播放列表格式，早在音频播放时代就存在了（Winamp 时代就有）。M3U8 是它的 UTF-8 编码变体，现代流媒体应用几乎都用 M3U8。orbitv 的 Personal 功能支持导入 .m3u 和 .m3u8 文件或 URL。

一个最简化的 M3U 文件长这样：

#EXTM3U
#EXTINF:-1 tvg-id="bbcnews", BBC News - 英国
stream.example.com/bbcnews.m3u8
#EXTINF:-1 tvg-id="cnn", CNN - 美国
stream.example.com/cnn.m3u8

但 orbitv 也支持更简化的形式——直接一列 URL：

#EXTM3U
stream.example.com/bbcnews.m3u8
stream.example.com/cnn.m3u8

orbitv 支持的格式变体

标准 M3U8（推荐）

带完整 #EXTM3U 头部、#EXTINF 元信息（频道名、logo、分组、语言等）的列表。orbitv 能正确解析：

• 频道名称（从 #EXTINF 后的文本提取）。
• 分组（group-title="..." 属性）——orbitv 会按分组自动分类。
• Logo（tvg-logo="..." 属性）——orbitv 会在频道卡片上显示 logo（如果网络可达）。
• EPG 关联（tvg-id="..."）——某些列表带 EPG 数据，orbitv 可以尝试匹配电子节目指南。

纯 URL 列表（最简）

只有 #EXTM3U 头部 + 一列 URL，没有 #EXTINF 元信息。orbitv 解析后：

• 频道名从 URL 自动提取（通常不太友好）。
• 没有分组、logo、EPG 信息。
• 功能上能看，但频道管理体验差。

M3U vs M3U8 编码

• M3U：传统格式，编码不固定（可能是 GBK、GB2312、UTF-8 等）。中文频道名在 orbitv 里可能显示乱码。
• M3U8：强制 UTF-8 编码，国际通用，中文、日语、韩语、俄语等都能正常显示。强烈推荐用 M3U8。

orbitv 对两种格式的解析能力基本一致，编码兼容时优先 M3U8。

orbitv 支持的流媒体地址格式

M3U8 文件里的每一行 URL，orbitv 支持：

常见导入失败原因

orbitv 说"无法解析列表"

最常见原因：

1. URL 拼错了——检查远程地址是否能在浏览器里打开，远程列表是否返回 200 状态码。
2. M3U 文件缺少 #EXTM3U 头部——必须是第一行，不能有 BOM（UTF-8 BOM 在某些场景下会导致解析失败）。
3. 编码问题——中文 M3U 文件如果是 GBK 编码，orbitv（默认按 UTF-8 解析）可能乱码甚至解析失败。

解析成功但频道都打不开

列表解析没问题，但点开每个频道都黑屏或加载失败：

1. 源站 URL 过期——很多 IPTV 服务商的 M3U 列表里的频道地址是临时的（可能带过期参数），过了有效期就失效。从服务商那里获取最新列表再导入。
2. 地理限制——某些频道地址只在特定国家 IP 下可访问，换 IP 试试。
3. 协议不兼容——orbitv 不支持 RTMP、MMS 等旧协议，但列表里混入了这类地址。

频道名显示乱码

中文列表用了非 UTF-8 编码（如 GBK），orbitv 按 UTF-8 解析后显示乱码：

• 如果你有原始文件，用文本编辑器转成 UTF-8 保存。
• 如果是远程 URL，让列表提供方提供 UTF-8 编码版本。

orbitv 不做的事

orbitv 的 Personal 功能只解析列表和播放，以下事情它不做：

• 不验证频道源的可用性——导入时不会帮你逐个测试每个频道能不能播放。
• 不自动更新远程列表——除非你手动点"刷新"，否则 orbitv 不会定期重新拉取远程 M3U URL。
• 不修复列表格式——格式有问题直接报错，不会帮你补全或自动修正。
• 不跨设备同步 Personal 配置——换设备需要重新导入。

这些是 orbitv 的设计选择——Personal 是你自己的责任区，orbitv 只提供解析和播放。

Personal 让你能导入自有频道，但 orbitv 还有一套付费升级（Orbitv+ / X / Pro），解锁更多高级功能。下一篇 03-Orbitv+ 付费升级对比。