HTML5视频播放器行为采集关键在于设计精准的采集逻辑：区分主动/自动播放、暂停节点分析、完成率校验；节流timeupdate、捕获seek行为、结合页面可见性；分类错误、监控缓冲、记录全屏/音量；结构化上报字段并本地缓存兜底。
HTML5 视频播放器本身不自带分析能力，但它的标准事件系统（如 play、timeupdate、seeked）天然支持用户行为采集。关键不在“用什么播放器”，而在“如何设计采集逻辑”——既要准确反映真实观看行为，又要避免干扰播放性能和用户体验。
播放行为：从“是否播放”到“怎么播”
单纯记录一次 play 事件意义有限。真正有价值的是组合状态与上下文：
-
区分主动播放与自动播放：检查
event.detail?.trigger或结合autoplay属性判断触发来源，避免将页面加载自动播计入有效启动率 -
暂停不是中断，而是行为节点：
pause事件应连带记录currentTime和前一阶段持续时长，用于识别高频暂停点（如知识点卡顿、广告反感） -
完成率需排除无效播放：仅当
ended触发且总播放时长 ≥ 视频时长 × 80% 才计为“完整观看”，防止刷新、跳转导致误判
进度交互：识别用户注意力分布
timeupdate 是热力图和跳过分析的基础，但直接监听它会产生大量冗余数据：
- 节流上报而非逐帧记录：每 2–5 秒采样一次当前时间点，同时标记是否处于播放中（排除暂停时的静止上报）
-
显式捕获 seek 行为：监听
seeking+seeked组合，计算拖动起始/目标位置、跨度大小，识别“回看”（倒拖）或“跳过”（快进超 30 秒）模式 -
结合页面可见性：用
document.visibilityState过滤掉用户切走标签页后的伪播放，确保所有时长数据对应真实注视行为
错误与体验指标：把技术问题转化为用户反馈
播放失败对用户是黑盒，但错误事件携带明确线索：
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
-
分类处理 error 事件：解析
video.error.code（如 MEDIA_ERR_NETWORK、MEDIA_ERR_DECODE），再结合video.networkState判断是 CDN 问题还是终端解码异常 -
缓冲行为比错误更常见：监听
stalled和waiting，统计单次缓冲时长与频率，超过 3 秒且发生 ≥2 次即标记为“体验受损”会话 -
全屏与音量是隐性偏好信号：
enterfullscreen出现说明内容吸引沉浸；volumechange中静音操作集中发生在某时间段，可能指向片头广告或语音不适配
数据结构与上报：轻量、可扩展、防丢失
前端采集只是第一步，字段设计决定后期分析效率：
-
必含上下文字段：
video_id（非 URL）、session_id（本地生成，跨页保持）、user_anonymous_id（非登录态可用设备指纹） -
事件粒度按需分层：基础事件（播放/暂停）实时上报；聚合事件（如“本段观看总时长”）在
visibilitychange隐藏时或页面卸载前批量提交 -
本地缓存兜底：使用 IndexedDB 存储未发送事件，页面恢复后重试；对
play、ended等关键事件启用 fetch 的keepalive: true保证卸载前发出
不复杂但容易忽略：所有采集逻辑必须与播放器生命周期同步启停，避免销毁后仍触发回调造成内存泄漏或错误上报。
