H5Player
FAQ
FAQ
简体中文

更新日志

V2.0.5

2026-04-03

  • 新增功能

  1. S17 私有协议

  2. 如果开启了马赛克并且netRequestType 是2或3，则使用s17请求

  3. 单通道播放不需要黑屏

V2.0.4-P4

2026-03-27

  • 内部优化
  1. 第一秒有报警数据时，wasm 报错问题

V2.0.4-P3

2026-03-25

  • 内部优化

  1. 用户时间转平台时间问题

  2. netRequestType = 2 时，传入 devId 为空时报错

V2.0.4-P2

2026-02-28

  • 内部优化

  1. 直通通道关闭后还会继续loading的问题

  2. 接入流量管控

  3. addStream 和 destroy 不更新音量对象问题

V2.0.4-P1

2026-01-16

  • 内部优化

  1. wasm 解码性能不足跳秒问题

  2. mse seek 到最后一秒偶现卡住问题

  3. webcodecs 解码最后一帧失败导致卡住问题

  4. 无音频时, webcodecs 解码频率过快导致删帧问题

  5. 优化 mse 帧匹配问题

  6. addStream 支持码流类型

V2.0.4

2025-12-10

  • 内部优化

  1. adas, dms 展示优化

  2. 修改回访频繁切换码流最后一次不生效问题

V2.0.1-P10

2025-11-14

  • 内部优化
  1. 修复证据通道黑屏后不会恢复的问题

V2.0.3-P5

2025-11-04

  • 新增功能

  1. 回放时间支持 utc 时间戳

  2. 增加 hooks 解绑功能

  • 内部优化

  1. 不安全内容优化

  2. startPlayTime 转为平台时区

  3. mp4 文件跨时间段异常场景处理

  4. webcodecs 模式下解码超高清视频时降级为 mse 解码

  5. 视频信息插件在重播时不生效

  6. osd 插件调用 clear() 后缩放画面报错问题

  7. 连续两帧分段结束帧导致视频黑屏后不恢复问题

  8. webcodecs 模式下回放画面延时和音频卡顿问题

  9. 回放切换码流后不能播放结束问题

V2.0.2-P6

2025-10-24

  • 内部优化
  1. 修改 mse 模式 seek 后卡住问题

V2.0.3-P4

2025-09-30

  • 新增功能
  1. 直通增加隐藏页面是否暂停参数 pauseWhileHidden
  • 内部优化

  1. 老设备使用 webcodecs 硬解时帧乱序问题

  2. 通道 i 帧不一致导致 seek 后跳秒问题

  3. osd 乱码问题

  4. 手动马赛克绘制时数据合并问题

V2.0.3-P3

2025-09-05

  • 新增功能
  1. 移动端适配支持
  • 内部优化

  1. 车牌打码范围过大问题

  2. 优化 mse 高倍速生效时间

  3. 修改回放高倍速不会播放结束问题

  4. 直通销毁多个通道时，由单个依次销毁改为同时销毁

  5. 暂停时连续 seek, 最后一次 seek 时间不会通过 onTimeChange 回调

  6. 暂停时 seek, 画面会继续播放问题

  7. 直通移除所有通道再添加通道不会触发 onLoading hook

  8. 监听对讲缓存遗留问题

  9. 优化 webcodecs 和 wasm 马赛克防抖机制

  10. 回放打开子码流后切换主码流无效问题

V2.0.2-P5

2025-08-25

  • 内部优化
  1. 修复证据通道黑屏后不会恢复的问题

V2.0.3-P2

2025-08-08

  • 新增功能

  1. adas 算法增加 限速牌 展示

  2. GPU不可能场景下，非模型通道允许播放

  3. 播放器创建支持 mosaic 配置

  4. 增加 音量回调 onVolumeChange 的 hook

  • 内部优化

  1. WebGL 渲染时设置显示比例，画面抖动问题

  2. mse 解码, readyState <= 2 时连续调用 play(), pause() 导致报错

  3. 连续 seek 时 onTimeChange 回调问题

  4. 直通播放, GPU 报错后会继续 loading 问题

  5. webcodecs 解码内存泄漏问题

  6. JPEG 截图性能优化

  7. 修改 adas 前车速度计算方式

V2.0.2-P4

2025-07-14

  • 内部优化

  1. adas 碰撞报警剔除 ttc 为 99.00s 的无效数据

  2. 证据视频 seek 到最后一秒，逐帧问题优化

  3. 证据视频逐帧，再 seek 到最后一秒，黑屏问题优化

V2.0.3-P1

2025-07-11

  • 内部优化

  1. 复合流模式，断网时不会 loading 的问题修复

  2. chrome 升级到 138 之后，video 的大小获取问题

  3. afterReady 状态下，seek 后会触发多次 onTimeChange 回调

  4. 修改非mse模式第一秒fps为1导致逐帧异常问题

V2.0.3

2025-07-01

  • 新增功能

  1. 增加 onStreamTypeChange hook, 监听码流切换

  2. 增加直通 destroyInstanceByUser 参数，支持销毁所有通道后不销毁播放器实例

  3. 全局配置增加 fullRatio 参数, 判断铺满时是否拉伸

  4. 回放增加起播时间 startPlayTime

  5. 增加 onInputAudioDevicesChange hook, 监听输入音频设备变化

  • 内部优化

  • 监听对讲触发 afterReady 时设置音量无效问题

  • 非 mse 模式回放音画同步问题

  • AI 信息展示优化

  • 显示比例传入数组不生效问题

  • 虚拟回放两个不同设备id，相同通道数据导致的声音切换问题

  • 优化结束时间判断误差为 3 秒

  • 优化 onPlayEnd 回调触发时机，需要在 afterReady 之后触发

V2.0.2-P3

2025-06-27

  • 内部优化

  1. 暂停时，seek 后会触发两次 onTimeChange 回调

  2. afterReady 状态下，seek 后会触发多次 onTimeChange 回调

  3. webcodecs 直通起播第一秒卡顿问题

V2.0.2-P2

2025-06-06

  • 内部优化

  1. X3NPRO 设备主子码流切换绿屏优化

  2. seek 时 onTimeChange 触发优化

V2.0.2-P1

2025-05-30

  • 新增功能

  1. 修改词条和单位配置格式。参考 配置文档

  2. 关键帧模式下禁用 逐帧 和 慢倍速。

  3. 增加 重播 replaying 状态。

  • 内部优化

  1. 逐帧问题

  2. 非 mse 模式音画同步问题

  3. adas 算法 行人框 颜色

  4. mse 模式下未起播通道 seek 后删帧问题

  5. 1秒证据视频反复播放问题

V2.0.2

2025-05-08

  • 新增功能

  1. 逐帧模式支持 seek

  2. 逐帧无数据时, onFramePlayNoData 回调第一帧或最后一帧

  3. ai展示 增加 词条配置、单位配置、曲线配置

  4. 逐帧播放是否启用缓存模式

  5. 回放停止后重播可触发 afterReplay hook

V2.0.1-P9

2025-04-02

  • 新增功能
  1. afterReady 状态可 setVolume 和 逐帧操作
  • 内部优化

  1. 优化页面刷新时播放器自动关闭功能

  2. 切换码流时打码问题

  3. audioContext 内存占用优化

  4. loadingTimeout hook 增加 '重连次数是否用尽'字段 reconnectExhausted

V2.0.1-P8

2025-03-20

  • 内部优化

  1. 高倍速同步优化

  2. 对讲实时性优化

  3. 证据结束时间误差过大导致不能播放结束

  4. 直通增加流畅度探测

    playerjs.performanceList

V2.0.1-P7

2025-03-06

  • bug 修复
  1. hasPostApi 获取问题导致接口没有使用 post

V2.0.1-P6

2025-01-20

  • bug 修复
  1. 页面隐藏后短证据mse数据全部塞完后不会播放
  2. 解决webcodecs 265默认软解导致配置错误
  3. mse 音频 g711a 误判监听对讲导致丢弃
  4. 修改页面隐藏后关闭视频的后续重新打开问题
  • 新增功能

  1. 增加 ai 报警类型配置。参考 配置文档

    playerjs.config = { allowAlarm: [] };

  2. 直通 mse 模式增加 实时优先和流畅优先配置。参考 直通文档

    createLivePlayer(doms, { playMode: 0, // 0-实时优先，1-流畅优先 });
  • 优化项

  1. webcodecs 默认走软解

  2. 对讲卡顿优化

  3. 监听增加 afterReady hook

  4. 监听第一秒卡顿优化

  5. 视频信息插件性能优化

  6. 监听对讲 onError Hook 增加超时错误

V2.0.1-P5

2024-12-09

  • 新增功能

  1. header 带 _referer

V2.0.1-P4

2024-11-29

  • bug 修复
  1. 逐帧 gop 异常导致卡住问题
  2. 编辑马赛克缩放容器后显示异常
  3. 手动马赛克低分辨率重新编辑时格子显示异常
  4. fileList 的 fileSize 是字符串导致 wasm 报错
  • 新增功能
  1. 新增默认倍速 startMultiple。参考 回放配置
  2. 截图支持尺寸和格式配置。参考 截图功能
  3. 手动马赛克增加右键删除功能
  4. 直通增加再次重连逻辑配置。参考 断线重连
  • 优化项

  1. loading 超时隐藏页面不需要暂停

  2. mse 解码错误后重置

  3. afterReady 时强制触发一次 onTimeChange

  4. 音频延迟优化

V2.0.1-P3

2024-10-31

  • bug 修复
  1. 断网重播和 seek 问题
  • 优化项

  1. mse 帧匹配优化

  2. ai 矩形框和车道线优化

V2.0.1-P2

2024-09-29

  • bug 修复
  1. 放大状态下切换码流后放大效果失效
  2. 手动马赛克bug修复
  3. 苹果手机 safari 打开视频报错
  4. mse 起播瞬间不打码
  • 优化项

  1. 直通关闭时立即 resolve

  2. loadingTimeout 回调通道优化

V2.0.1-P1

2024-09-05

V2.0.1

2024-07-01

  • 新增功能

    1、支持905、1078设备多路同时播放，因设备不支持多路同步，则播放时无法保证强同步

    2、新增手动马赛克功能，详情参考视频其他功能中手动马赛克部分

    3、新增对讲下发提示音功能

    4、新增矿山大石块功能

    5、webcodecs 新增支持选择软硬解

  • 接口变更

    1、回放新增多路回放标记

    设备多路同步回放标识，默认同步播放，比如 1078、905 多路播放，需要设置为 false，仅设备回放、融合回放支持

H5Player.createHistoryPlayer(domList, { deviceSyncPlay: false, });

2、新增 startPrompt、stopPrompt，用于传入开始、结束提示音

const intercom = H5Player.createIntercom({
  ...config,
  startPrompt: buffer, // 开始提示音，pcm 格式，16位，采样率 8000，单通道
  stopPrompt: buffer, // 结束提示音，pcm 格式，16位，采样率 8000，单通道
})；

· 3、全局新增webcodecs软硬解

webcodecs 是否启用硬件解码。0-浏览器自动选择，1-硬件解码，2-软件解码。仅在 decoderType = 2 时生效。如果直通需要更高的实时性，将该配置项设置为 2, 不过会损失掉一些性能。

H5Player.config = { hardwareAcceleration: 0, };

  • 接口新增

    1、对讲新增 HOOK

intercom.hooks.afterReady.tap('ready', () => {
    message.info('开始提示音结束，对讲开始');
});

intercom.hooks.afterStop.tap('stop', () => {
    message.info('结束提示音结束，对讲结束');
});

  • 优化项

    1、内存、cpu、时延优化

    wasm 软解时延400ms，mse硬解时延1200ms，webcodecs硬解时延850ms，webcodecs软解时延400ms。

    性能比较：mse>webcodecs硬解>webcodecs软解>wasm 软解

目录