ZyPlayer TV版无法加载视频源，如何排查网络与解析配置问题？

Question

ZyPlayer TV版无法加载视频源，常见原因集中在网络连通性与解析配置两方面。首先检查设备网络：确认TV已连接稳定Wi-Fi（非限速/隔离网络），禁用IPv6或尝试切换DNS（如114.114.114.114）；用浏览器访问任意解析接口（如`https://xxx.com/api?url=xxx`）验证是否返回JSON数据，排除跨域、证书错误或服务端拦截。其次核查解析配置：确保TV版中“解析地址”填写正确（无多余空格、末尾斜杠）、协议为HTTPS（部分TV系统不支持HTTP）、支持CORS且响应头含`Access-Control-Allow-Origin: *`；若使用自建解析，需确认其兼容TV端User-Agent（如`Mozilla/5.0 (Linux; U; Android 9; zh-CN;)`）。最后排查缓存与权限：清除ZyPlayer数据、检查是否被防火墙/广告过滤器（如AdGuard Home）误杀解析请求。建议启用日志功能（如有）或抓包（通过路由器镜像端口）定位具体失败环节。

Answer 1

```html

一、现象层：TV端视频源加载失败的典型表现

• ZyPlayer TV版主界面可正常启动，但点击任意影片后长时间转圈，无错误提示或直接弹出“解析失败”；
• 播放器控件（如进度条、音量）可交互，但始终无法进入播放状态；
• 部分设备出现“网络异常”浮层，但其他App（如YouTube、爱奇艺）视频播放正常；
• 日志中高频出现 ERR_CONNECTION_TIMED_OUT、ERR_SSL_VERSION_OR_CIPHER_MISMATCH 或 Failed to fetch 等前端网络错误。

二、网络连通性诊断：从物理链路到协议栈穿透

TV设备受限于系统封闭性与网络栈精简，需分层验证：

层级	检测项	推荐工具/方法	典型异常信号
L2（链路层）	Wi-Fi隔离/限速策略	路由器后台查看客户端QoS、AP隔离开关	ping通网关但无法解析域名
L3（网络层）	IPv6兼容性	在TV开发者选项中禁用IPv6，或路由器关闭IPv6 RA	curl -4 成功而 -6 超时
L4/L7（传输/应用层）	DNS污染/劫持	adb shell + nslookup xxx.com @114.114.114.114	返回非预期IP或NXDOMAIN

三、解析服务验证：跨域、证书与User-Agent三重校验

使用PC浏览器模拟TV端请求进行基准测试（关键参数必须一致）：

curl -v \
  -H "User-Agent: Mozilla/5.0 (Linux; U; Android 9; zh-CN;)" \
  -H "Origin: https://zyp.tv" \
  "https://your-parser.com/api?url=https%3A%2F%2Fv.qq.com%2Fxxx"

成功响应应同时满足以下条件：

• HTTP状态码为 200 OK（非302跳转或4xx/5xx）；
• 响应头含 Access-Control-Allow-Origin: * 或精确匹配TV端Origin；
• 证书由可信CA签发（Android TV对Let’s Encrypt R3等有严格信任链要求）；
• 响应体为合法JSON（无HTML模板、无服务端渲染内容）。

四、ZyPlayer TV配置深度核查清单

1. 解析地址字段：末尾禁止斜杠（https://a.b/c/ → https://a.b/c），TV WebView会错误拼接URL；
2. 协议强制HTTPS：Android TV WebView 80+默认禁用混合内容（Mixed Content），HTTP解析地址将被静默拦截；
3. 空格与不可见字符：复制粘贴易引入Unicode零宽空格（U+200B），建议手动键盘输入并开启编辑器显示隐藏符；
4. 自建解析服务需支持OPTIONS预检请求，并在响应头中返回完整CORS策略（含Access-Control-Allow-Headers与Access-Control-Allow-Methods）。

五、环境干扰溯源：防火墙、广告过滤与系统级拦截

graph TD
  A[ZyPlayer发起解析请求] --> B{是否被中间设备拦截？}
  B -->|是| C[AdGuard Home规则匹配]
  B -->|是| D[路由器QoS限流]
  B -->|是| E[DNSFilter黑名单]
  B -->|否| F[进入TV系统网络栈]
  C --> G[检查adguard.yaml中是否含 parser.com 域名]
  D --> H[确认QoS未对UDP 53/DNS或TCP 443限速]
  E --> I[临时禁用DNSFilter验证]

六、高级排障手段：日志捕获与流量镜像分析

• 启用ZyPlayer内置调试日志（若编译时开启DEBUG_LOG=true），输出至/sdcard/Android/data/com.zyplayer.tv/files/logs/；
• 路由器镜像端口抓包（如OpenWrt+tcpdump）：tcpdump -i br-lan host tv_ip and port 443 -w /tmp/zyp.pcap；
• 关键分析点：TLS握手是否完成（Client Hello → Server Hello）、HTTP/2 SETTINGS帧是否协商成功、解析请求是否发出及响应体长度是否为0；
• 对比PC端相同请求的Wireshark trace，定位TV端特有的TLS扩展缺失（如ALPN未声明http/1.1）或SNI字段异常。

```