2.11.2

• 为进一步提升 Web 拉流 SDK 的功能与服务能力，火山引擎视频直播对 Web 拉流 SDK 启用 License 校验并更新计费规则。

• RTM、FLV 和 HLS 流 retryCount 的默认值由 0 变更为 3。

• 更新 RTM 协议拉流的自动降级机制。目前，播放器仅在以下情况下自动触发降级：

  • 浏览器或设备环境不支持 RTM 协议播放，或不支持采用 H.264 编码的 RTM 流播放。
  • 播放过程中出现解码异常。

  对于因网络异常导致的 RTM 拉流失败，播放器将触发自动重试（默认重试 3 次），而不会直接降级。您可以通过 retryCount 参数自定义重试次数。

2026-01-20

• 关于 Web 拉流 SDK 启用 License 校验的公告
• 配置
• RTM 协议拉流

2.10.3

• 支持通过 npm 引入单个插件，以减少包体积。
• 修复通过 link 标签预加载 JS 时导致错误的问题。

2025-11-27

引入依赖

2.10.2

• 优化 RTM 和 FLV 流首帧耗时的日志上报逻辑，支持上报首帧各阶段的耗时
• 修复 RTM 拉流报错后，降级到其他协议拉流时日志停止上报的问题。
• 修复 RTM 断流后调用 retry 导致重复报错的问题。
• 修复部分手机非静音启播时，被浏览器劫持导致有声无画的问题。

2025-11-12

-

2.10.0

• 传入 appId（应用 ID）后，支持配置下发功能。
• 修复了以下场景中可能出现的封面图无法隐藏的问题：配置了封面图（poster）和不自动播放（autoplay: false），且正在播放 RTM 流。

2025-10-21

-

2.8.0

• 支持 RTM 协议中的 SEI 数据解析，用于展示与画面同步的弹幕、打点等信息。
• 支持商业级 DRM 加密，包括 FairPlay、Widevine 和 PlayReady，提升内容版权保护能力。
• 优化 RTM 播放卡顿日志采集能力，增强弱网环境下的问题排查效率。
• 引入 RTM jitterbuffer 播放策略，以缓解弱网下的播放卡顿，提升播放连续性和稳定性。

2025-07-04

-

2.7.1

• 修复日志中传入 userId 无效的问题（仅影响 V2.6.1 至 V2.7.0 版本），确保日志信息能够正确记录用户标识，便于问题追踪和调试。
• 修复了当 controls 设置为 false 时，切换清晰度或线路无效的问题。
• 针对部分 OPPO 设备播放 RTM 流的异常报错问题进行了优化。

2025-06-12

-

2.7.0

新增多协议降级方案，支持传入多个协议地址和降级顺序。降级场景包括：

• 按降级顺序选择当前环境支持的协议播放。
• 默认 RTM 播放失败后按顺序降级。
• 支持失败后区分错误码降级。
• 支持自定义不同协议的播放失败降级策略。

2025-05-07

• FLV 协议拉流
• RTM 协议拉流

2.6.2

本次更新优化了信息面板的样式和清晰度展示，包括：

• 调整布局、优化字体和间距，提高可读性。
• 改进了分辨率信息的显示，使数据更直观。

2025-04-02

-

2.5.2

• FLV 低延迟支持 h5 端。
• switch 支持多格式切换。
• RTM 未配置自动转码取消自动降级。

2024-12-04

方法及属性

2.5.1

• isMseSupported、isMMSSupported 和 isFLVSupported 方法支持传入字符串类型的编码信息来判断浏览器对编解码信息的支持情况。
• 新增日志上传配置检查，未配置 AppID 时会在浏览器开发者工具中的控制台（Console）中进行报错，并使用默认的 AppID 进行日志上报。

2024-10-23

方法及属性

2.5.0

• RTM 拉流支持配置断流等待时间，并支持配置断流后重新拉流是否无缝。
• 优化 LL-HLS 实现逻辑。
• 新增在检查 iOS 端浏览器是否支持 FLV 格式流播放的方法，并支持在 iOS 17.1 及以上浏览器中播放 FLV。

2024-09-06

• 配置
• 方法及属性

2.4.0

• 播放器新增 RTM 拉流时的 networkEvaluateInterval （网络评估时间间隔）设置。
• 新增 getRTMNetWorkInfo 方法，支持获取 RTM 拉流的网络评估信息。
• 新增 getRTMStats 方法，支持获取 RTM 拉流的播放信息。
• 新增 getFLVStats 方法，支持获取 FLV 拉流的播放信息。
• FLV 拉流支持自适应码率（ABR）拉流。
• 新增播放器 playTime 属性，支持获取当前播放时长。

2024-06-12

• 配置
• 方法和属性
• 事件

2.3.0

新增通过 NPM 包集成 SDK 的方法，并提供使用 NPM 方式集成时各功能接入的代码示例。

2024-02-29

• 接入指引
• 功能接入

2.2.1

• FLV 拉流增加 enableLowLatency 配置，支持配置低延时模式；
• FLV、HLS 拉流 retryCount 配置支持进行断流重试；
• RTM 拉流增加 enableRTMAutoTranscode 配置，支持配置自动转码。

2023-12-12

配置

2.1.0

• 区分 RTM 错误码，流不存在时返回 2104 错误码；
• 拉流地址增加 _session_id；
• 播放器 RTM 拉流配置新增 enableFallback 配置项，支持设置 RTM 播放失败时是否进行自动降级；
• 播放器 RTM 拉流配置修改 fallbackUrl 配置含义，当开启 RTM 播放失败自动降级且 fallbackUrl 设置为空时，会降级到对应的 FLV 或 HLS 地址。

2023-11-09

配置

1.7.0

• 区分 RTM 错误码，流不存在时返回 2104 错误码；
• 修复切换清晰度后播放异常时， toast 不会消失的问题；
• 修复切换线路时，视频启播前线路选择控件不展示的问题。

2023-11-07

历史文档

2.0.0

2.0.0 版本全新发布，相比 2.0.0 以下版本进行了以下优化：

• 优化播放器接入方式，并减小包体积；
• 优化播放器创建方式；
• 优化播放器配置、方法、属性和事件格式。

2023-10-31

• 接入指引
• 功能接入
• SDK API

1.6.3

• 修复 RTM 播放格式部分日志未上报的问题；
• 修复报错面板未正确显示用户传入 userId 参数的问题。

2023-10-12

-

1.6.1

• Web 拉流 SDK 的 JS 和 CSS 资源引入地址更新，旧地址将不再提供新版本的资源获取；
  • 新地址：
    • CSS:https://lf-unpkg.volccdn.com/obj/vcloudfe/sdk/@volcengine/veplayer/版本号/index.min.css
    • JS:https://lf-unpkg.volccdn.com/obj/vcloudfe/sdk/@volcengine/veplayer/版本号/index.min.js
  • 旧地址：
    • CSS:https://unpkg.byted-static.com/volcengine/veplayer/版本号/dist/index.min.css
    • JS:https://unpkg.byted-static.com/volcengine/veplayer/版本号/dist/index.min.js
• 优化自动播放策略；
• 修复 RTM 重试过程中调用 switchURL 切换流地址时，未取消正在进行的请求的问题；
• 日志上报增加 SDK 版本信息；
• 修复切换清晰度后立即切换线路时，toast js 报错的问题；
• RTM 日志上报增加 stats 相关的信息。

2023-09-15

接入指引

1.5.10

• 修复 webview 中静音取消按钮背景色消失问题；
• 修复 rotateFullscreen 配置为 true 时，横屏全屏播放的样式问题；
• 修复使用华为鸿蒙手机播放 RTM 流时，点击取消静音后，仍没有声音的问题。

2023-07-25

-

1.5.1

• 调用 play() 方法返回 Promise；
• 更新错误码：
  • 错误码 1 更新为 5101；
  • 错误码 2 更新为 5102；
  • 错误码 3 更新为 5103；
  • 错误码 4 更新为 5104。

2023-05-29

接口说明