播不出来

本页摘自完整使用手册的 § 31 故障排查,构建时 @include 抽取,零漂移同步。

31.1 视频播不出来

1. 打开 Chrome DevTools → Network
   检查 manifest / 分片请求状态
   ├─ 404 → 链接错误 / 签名过期
   ├─ 403 → 认证失败(签名有效期不够?)
   ├─ CORS 错误 → 后端加 Access-Control-Allow-Origin
   └─ 200 但内容不对 → 检查文件格式

2. Console 有报错吗?
   ├─ E_MEDIA_NOT_SUPPORTED → URL 后缀识别错误,显式加 type: 'hls'
   ├─ E_AUTH_EXPIRED → 认证问题(401/403,签名过期或无权限)
   ├─ E_AUTOPLAY_BLOCKED → 加 muted 或等用户交互
   ├─ E_LOAD_FAILED → iframe 加载失败,检查 embed-app URL
   └─ E_ENV_CSP_BLOCKED → 页面 CSP 没放行播放器域名

3. 平台特殊问题?
   ├─ iOS + FLV → 硬限制,改 HLS(用 sources 数组)
   ├─ iOS + MP4 + 自定义 header → 用签名 URL
   ├─ 微信 / UC / 夸克 → 参考 § 12 平台能力矩阵
   └─ iframe 3 个同页面 → 改 inline 或减少

---

← 回故障排查总览