iframe 场景专属

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

31.4 iframe 场景专属问题

1. iframe 完全空白
   ├─ 检查 iframe.src 是否可访问
   ├─ 检查 CORS / CSP 设置
   └─ 开 debug 看握手是不是超时

2. iframe 出来了但不响应命令
   ├─ 握手是否完成(debug 里看 'ready' 事件)
   ├─ 命令是否超时(默认 10s)
   └─ 是否引入了正确的 SDK 版本

3. 事件收不到
   ├─ 静态场景:origin 过滤是不是把自己挡了?
   │    envelope 只有 version / id / timestamp / type / payload 五个字段,
   │    要判的是 type === 'event',没有 context 这种东西
   ├─ iframe URL 是否指向正确的 embed-app 版本
   └─ 用 debug 模式看 postMessage 是否派发

Debug 模式:

<VideoPlayerFrame source="..." debug={true} />

打开后 console 显示握手过程、每一次 postMessage、xgplayer 内部错误。

---

← 回故障排查总览