You need to enable JavaScript to run this app.
视频点播

视频点播

Copy page
Download PDF
播放器 SDK
功能详情
Copy page
Download PDF
功能详情

播放器 SDK 提供全面、稳定、流畅的视频播放服务,支持 Android、iOS、HarmonyOS NEXT、Web 和小程序平台以及 React Native 和 Flutter 框架。本文为您详细介绍播放器 SDK 支持的功能。

tip

Web 端的功能支持情况还取决于系统和浏览器,详见 Web 浏览器兼容说明

标准功能

本节介绍播放器 SDK 的标准功能。

播放协议与格式

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

音视频格式

支持 MP4、MP3、HLS(TS 分片)、Vorbis 等丰富的音视频格式。

✔️

✔️

✔️

✔️

✔️

✔️

DirectUrl 播放

支持以 DirectUrl 方式播放本地视频和网络视频。

✔️

✔️

✔️

✔️

✔️

✔️

Vid 播放

支持以 Vid 方式播放存储在视频点播服务的视频。视频点播服务可下发多个清晰度的播放地址(如有)。

✔️

✔️

✔️

✔️

✔️

✔️

H.264 编码格式

支持播放 H.264 视频源,并支持软硬解切换。

✔️

✔️

✔️

✔️

✔️

✔️

H.265 编码格式

支持对 H.265 视频源的硬解播放。

✔️
高级版额外提供硬解机型黑名单并支持硬解优化

✔️
高级版和企业版额外提供硬解机型黑名单并支持硬解优化

DASH 协议

支持 BASH(经火山引擎优化的升级版 DASH 协议)视频流的播放。

✔️

✔️

✔️

✔️

HDR

支持播放 HDR10/HLG 等多种 HDR(High Dynamic Range,高动态范围)视频。

✔️

✔️

✔️

✔️

软硬解自动切换

当终端设备不支持硬件解码时自动切换到软件解码。

✔️

✔️

✔️

✔️

✔️

播放控制

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

基础播放控制

支持开始、结束、暂停和恢复等播放控制功能。

✔️

✔️

✔️

✔️

✔️

✔️

Seek

支持拖动到指定位置。

✔️

✔️

✔️

✔️

✔️

✔️

精准 Seek

支持以帧级别的精确度拖动到指定位置。

✔️

✔️

✔️

✔️

✔️

✔️

缓存内 Seek

在进行 Seek 操作时,已缓存的视频内容不被清除且能够快速进行 Seek。

✔️

✔️

✔️

✔️

✔️

✔️

重播

支持视频播放结束后手动触发重播。

✔️

✔️

✔️

✔️

✔️

✔️

续播

支持设置续播起播时间点。

✔️

✔️

✔️

✔️

✔️

✔️

循环播放

支持视频播放结束后自动重播。

✔️

✔️

✔️

✔️

✔️

✔️

倍速播放

支持变速播放,与此同时音频变速不变调

✔️

✔️

✔️

✔️

✔️

✔️

清晰度切换

支持用户流畅无卡顿地切换视频的多路清晰度流。

✔️

✔️

✔️

✔️

✔️

✔️

平滑切换

针对视频点播服务生成的帧对齐的 MP4、M3U8、BASH(经火山引擎优化的升级版 DASH 协议)视频,支持在播放过程中平滑切换多个分辨率的播放地址,提升用户的播放体验。

✔️

✔️

✔️

✔️

切换音轨

支持在视频点播服务生成的多路 M4A 音轨流中切换。

✔️

截图

支持截取播放画面的任意一帧。

✔️

✔️

网络协议

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

自定义 Header

支持在请求音视频资源时,自定义 HTTP Header。

✔️

✔️

音频效果

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

音量调节

支持调节视频音量。

✔️

✔️

✔️

✔️

✔️

✔️

静音

支持开启和关闭静音。

✔️

✔️

✔️

✔️

✔️

✔️

纯音频播放

支持只播放 BASH(经火山引擎优化的升级版 DASH 协议)视频文件中的音频和常见的音频文件,例如 MP3、AAC。

✔️

✔️
仅高级版和企业版支持

音量均衡

支持均衡视频的音量大小,避免音量忽大忽小的场景,需要搭配视频点播服务音量检测功能使用。

✔️
仅高级版和企业版支持

视频效果

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

填充模式

支持画面裁剪和填充。

✔️

✔️

✔️

✔️

✔️

✔️

旋转

支持 0°、90°、180° 和 270° 四个旋转角度。

✔️

✔️

✔️

✔️

✔️

镜像

支持无镜像、水平镜像和垂直镜像三种镜像模式。

✔️

✔️

✔️

✔️

✔️

缩略图预览(雪碧图)

支持进度条缩略图预览。

✔️

✔️

设置播放器尺寸

支持自定义设置播放器的宽高。

✔️

✔️

✔️

✔️

✔️

✔️

画中画(小窗)

支持切换到画中画以小窗形式播放。

✔️

✔️

✔️

✔️

播放性能

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

预加载

在播放当前视频时,提前下载后续视频数据,确保在切换到下一个视频时能够快速起播。

✔️
仅高级版支持

✔️
仅高级版和企业版支持

预渲染

在播放当前视频时,提前创建播放器并对下一个视频进行解码和渲染,同时可将预渲染的首帧用作视频封面,提前展示给用户。

✔️
仅高级版和企业版支持

多实例

支持在同一界面添加多个播放器并同时播放。

✔️

✔️

✔️

✔️

✔️

✔️

播放源过期自动刷新

支持播放 URL 过期后自动刷新。

✔️

✔️

播放失败重试

播放失败时自动重试。

✔️

✔️

✔️

✔️

✔️

✔️

边播边缓存

支持在播放过程中同时缓存后续内容,降低网络占用,并可设置缓存策略。

✔️

✔️

✔️

✔️

✔️

✔️

视频下载

支持将视频下载到本地进行离线播放。

✔️

✔️

互动功能

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

外挂字幕

支持添加 WebVTT 和 SRT 格式的字幕文件。

✔️

✔️
仅高级版和企业版支持

蒙版弹幕

播放弹幕时不遮挡人物。

✔️

✔️
仅高级版和企业版支持

视频安全

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

Referer 黑白名单

支持通过播放请求中携带的 Referer 字段识别请求来源,以黑名单或白名单方式对请求来源进行控制。

✔️

✔️

✔️

✔️

✔️

✔️

时间戳防盗链

支持视频的播放地址仅能在鉴权有效时间内播放。

✔️

✔️

✔️

✔️

✔️

✔️

火山引擎私有加密

支持播放火山引擎私有加密视频,防止视频泄露和盗链问题。

✔️

✔️

✔️

✔️

✔️

✔️

HLS 标准加密

支持播放标准 AES-128 加密视频。

✔️

✔️

✔️

✔️

✔️

✔️

质量上报

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

日志上报

支持上报播放器 SDK 日志,统计点播视频播放的埋点数据。

✔️

✔️

✔️

✔️

✔️

✔️

播放数据大盘

支持观测播放量、播放质量等大盘数据。

✔️

✔️

✔️

✔️

✔️

✔️

播放异常追溯

支持按照指定用户、播放会话对播放历史进行追溯,定位播放异常原因。

✔️

✔️

✔️

✔️

✔️

✔️

播放告警能力

配合质量平台使用,对播放质量进行监控告警,及时发现播放异常。

✔️

✔️

✔️

✔️

✔️

✔️

开发支持

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

事件回调

支持对播放状态回调、首帧回调、播放完成或失败回调。

✔️

✔️

✔️

✔️

✔️

✔️

渲染数据输出

支持边渲染边输出 PCM 数据。

✔️

实时下载网速

支持获取实时下载网速,既可根据业务需要给终端用户在卡顿时展示下载网速,也是使用自适应码率带宽预测模块的必要前提。

✔️
仅高级版和企业版支持

✔️
仅高级版和企业版支持

UI 组件

提供完整播放器 UI,您可以根据自身需求选用。

✔️

✔️

多 Region

支持初始化播放器时设置 Region,适用于国际化播放场景。

tip

视频点播亚太东南(柔佛)地域仅针对企业用户开放。功能支持情况详见服务地域

✔️

✔️

✔️

✔️

服务支持

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

工单服务

支持提交工单进行咨询。

✔️

✔️

✔️

✔️

✔️

✔️

专家服务

提供专家级技术支持和指导。

✔️

✔️
仅高级版和企业版支持

质量优化

依赖日志埋点上报和质量平台,提供专家级质量优化服务。

✔️

✔️
仅高级版和企业版支持

增值功能

本节介绍播放器 SDK 的增值功能。

tip

  • 对于 Android 和 iOS 播放器 SDK:
    • 高级版中,增值功能为选配项,用户可根据业务需求选择开通。选配功能将单独收费,具体费用及开通流程请咨询火山引擎商务团队。
    • 企业版默认包含所有增值功能。
  • 对于 Web 播放器 SDK:高级版默认包含所有增值功能,无需额外付费。

功能

说明

Web

Android&iOS

Flutter

React Native

uni-app

HarmonyOS Next

H.266 编码格式

支持播放 H.266 视频源,并提供完整的 H.266 解决方案。

✔️
仅高级版支持

✔️
仅高级版和企业版支持

自适应码率播放 (ABR)

播放 BASH(经火山引擎优化的 DASH 协议)或 HLS 视频时,根据预测的带宽自动选择适合的清晰度进行播放。

✔️
仅高级版支持

✔️
仅高级版和企业版支持

客户端超分

针对在线视频,通过端上实时后处理超分技术,在保证画质的前提下,节省带宽;或者在相同带宽条件下,提升视频播放的清晰度和主观质量。

✔️
仅高级版和企业版支持

✔️
仅高级版和企业版支持

动态 Buffer

播放过程中基于网络状况、视频码率等信息动态调整 Buffer 时长,在保证播放体验的同时,减少播放带宽成本浪费。

✔️
仅高级版支持

✔️
仅高级版和企业版支持

Last updated: 2026.01.08 11:21:32