Sentinel Video Player

Appearance

故障排查 ​

先定位症状,再进对应的决策树。大部分问题在第一层就能收敛。

症状去哪
完全播不出来 / 黑屏 / 报错播不出来
能播,但点了之后要等很久首帧慢
能播,但一直转圈 / 断断续续卡顿严重
iframe 空白 / 命令没反应 / 收不到事件iframe 专属

先做这一件事 ​

开 debug。iframe 场景尤其如此 —— 不开基本是盲猜。

vue
<script setup lang="ts">
import { VideoPlayerFrame } from '@sentinel-lab/video-vue-frame'

const src = 'https://your-cdn/video.m3u8'
</script>

<template>
  <VideoPlayerFrame :source="src" debug />
</template>

打开后 console 会打出:握手过程、每一次 postMessage、命令超时(默认 10s)、 xgplayer 内部错误。

分不清是 SDK 问题还是源的问题? ​

把同一个 URL 直接丢进浏览器地址栏(HLS 可以用 Safari,或任意在线 m3u8 测试页)。

  • 裸播也不行 → 是源 / CDN / 签名的问题,和 SDK 无关,先修那边
  • 裸播正常、SDK 里不行 → 再往下查

这一步能省掉大量无效排查。

还是定位不了 ​

提工单要带什么 —— 少了那几项基本没法定位。