orbitv 网络与 Chromecast 连接问题排查

orbitv 网络依赖

orbitv 是纯在线应用——所有频道索引、流媒体播放、助手推荐、Personal 自播列表都依赖网络连接。网络问题大致分三类：

1. Chromecast 投放类：手机找不到电视设备，或投放中途断连。
2. 基本播放类：手机 / 电视上 orbitv 连不上服务器，频道列表空的。
3. 频道内容类：频道列表能加载，但点开播放失败（可能是频道源的网络问题，不是 orbitv 的）。

场景一：Chromecast 投放搜不到设备

这是 orbitv 多设备投放最常见的问题，排查顺序：

第一步：确认手机和 Chromecast 在同一个 Wi-Fi

最常见原因，90% 的搜不到问题都出在这里：

• 手机用 Wi-Fi，Chromecast 插在电视上连的是同一个 Wi-Fi 吗？
• 手机有没有可能连了移动数据流量（关闭了 Wi-Fi）？
• 家里有多个 Wi-Fi（主路由 + 访客网络），手机和电视会不会分属不同 Wi-Fi？
• 企业 / 酒店 Wi-Fi 隔离了设备间的 mDNS 广播——Chromecast 无法被发现，只能换家庭 Wi-Fi 试。

第二步：Google Home 能不能搜到 Chromecast

打开手机上的 Google Home APP（没装的话先装）：

• Google Home 里看不到 Chromecast？问题在 Chromecast 或网络，不是 orbitv。
• Google Home 里能看到 Chromecast？那 orbitv 应该也能看到——试试重启 orbitv。

第三步：开启 Android 定位权限

Android 12+ 要求应用有定位权限才能发现局域网内的 Chromecast 设备：

1. 系统设置 → 应用 → orbitv → 权限。
2. 确认"位置 / 定位"权限已开启（至少"使用时允许"）。
3. 某些版本可能需要开启"始终允许"才能持续发现设备。

第四步：重启 Chromecast 设备

Chromecast 设备长时间运行偶尔会出现 mDNS 广播停止：

• 拔掉 Chromecast 电源，等 30 秒再插回去。
• 等 Chromecast 启动完成（通常 1~2 分钟），再回 orbitv 试试。

第五步：Chromecast 固件版本过老

• Google Home → Chromecast 设备卡片 → 设置 → 关于，查看固件版本。
• 如果版本很老，让 Chromecast 自动更新（插着电、连着网络，更新会自动推送）。
• orbitv 的投放协议可能不兼容很老的 Chromecast 固件。

场景二：基本播放类——orbitv 打不开频道列表

orbitv 主界面一片空白或频道列表加载不出来：

排查步骤

1. 确认手机本身能上网：用浏览器打开 orbitv 官网试试。
2. Wi-Fi 和移动数据切换试试：当前网络可能被墙或有干扰。
3. 重启 orbitv：强制关闭再打开。
4. 检查 orbitv 版本：旧版本可能连接不上更新后的服务器。
5. DNS 问题：某些地区运营商 DNS 无法解析 orbitv 域名，改公共 DNS（如 8.8.8.8 或 1.1.1.1）试试。
6. 代理 / VPN 干扰：如果手机上开着 VPN 或代理工具，先关掉再试——orbitv 可能在代理环境下连接异常。

场景三：频道点开无法播放 / 加载很慢

频道列表能加载，但点开后黑屏或一直转圈：

注意：这大概率是频道源的问题，不是 orbitv 的问题

orbitv 只是索引公开流媒体地址，不自己托管任何视频文件。频道能不能播放取决于源站本身：

• 源站可能刚好在维护或升级。
• 源站的流媒体地址可能过期了（很多 IPTV 源带临时签名，几小时到几天就失效）。
• 源站可能做了地理限制，只允许某些国家的 IP 访问。
• 源站可能做了反爬，频繁请求后被临时拉黑。

快速验证方法

1. 用浏览器直接访问源站地址：从 orbitv 里找到这个频道的源 URL（某些版本在播放器里能看到），复制到浏览器里打开——如果浏览器也打不开，说明是源站问题。
2. 换个同类频道试试：orbitv 同一类内容通常有多个频道，换一个能不能播放——能的话基本确认是原频道源问题。
3. 等几小时或过段时间再试：公开流媒体源变化频繁，临时故障很常见。
4. 给频道源换 IP：如果怀疑地理限制，可以用 VPN 或代理试试。

orbitv 能做的事

orbitv 自身不做频道源的自动健康检查，也不会自动替换失效的频道——它只负责索引和播放。频道失效了：

• orbitv 不会主动把它从频道列表里移除。
• orbitv 不会提示"此频道已失效"——你点进去才发现打不开。
• 你需要自己从 Favorites / MyList 里手动删掉失效频道。

这是 orbitv 的设计选择——保持索引透明，不替用户做频道替换决策。

电视端 vs 手机端的网络差异

电视端播放直播流对网络要求更高：

电视盒子播放卡顿的标准排查路径：

1. 确认 Wi-Fi 信号强度（盒子在电视背后信号可能差）。
2. 换 5GHz Wi-Fi（2.4GHz 容易干扰）或用网线。
3. 重启路由器和盒子。
4. 换同类低码率频道试试（高码率频道对网络要求更严）。

网络连接是基础，还有一类常见问题是频道源本身失效。下一篇 06-频道不可用与黑屏排查。