You need to enable JavaScript to run this app.
导航
功能详情
最近更新时间:2025.03.20 19:23:12首次发布时间:2022.02.15 19:41:38
我的收藏
有用
有用
无用
无用

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

说明

HarmonyOS NEXT 的功能支持情况请见集成 HarmonyOS NEXT SDK

标准功能

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

注意

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

播放协议与格式

功能

说明

Android/iOS

Flutter

React Native

Web

音视频格式

支持 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,高动态范围)视频。

✔️

✔️

✔️

软硬解自动切换

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

✔️

✔️

✔️

✔️

播放控制

功能

说明

Android/iOS

Flutter

React Native

Web

基础播放控制

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

✔️

✔️

✔️

✔️

Seek

支持拖动到指定位置。

✔️

✔️

✔️

✔️

精准 Seek

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

✔️

✔️

✔️

✔️

缓存内 Seek

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

✔️

✔️

✔️

✔️

重播

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

✔️

✔️

✔️

✔️

续播

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

✔️

✔️

✔️

✔️

循环播放

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

✔️

✔️

✔️

✔️

倍速播放

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

✔️

✔️

✔️

✔️

清晰度切换

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

✔️

✔️

✔️

✔️

平滑切换

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

✔️

✔️

✔️

切换音轨

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

✔️

截图

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

✔️

✔️

网络协议

功能

说明

Android/iOS

Flutter

React Native

Web

自定义 Header

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

✔️

✔️

音频效果

功能

说明

Android/iOS

Flutter

React Native

Web

音量调节

支持调节视频音量。

✔️

✔️

✔️

✔️

静音

支持开启和关闭静音。

✔️

✔️

✔️

✔️

纯音频播放

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

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

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

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

✔️

音量均衡

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

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

视频效果

功能

说明

Android/iOS

Flutter

React Native

Web

填充模式

支持画面裁剪和填充。

✔️

✔️

✔️

✔️

旋转

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

✔️

✔️

✔️

✔️

镜像

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

✔️

✔️

✔️

✔️

缩略图预览(雪碧图)

支持进度条缩略图预览。

✔️

✔️

设置播放器尺寸

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

✔️

✔️

✔️

✔️

画中画(小窗)

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

✔️

✔️

播放性能

功能

说明

Android/iOS

Flutter

React Native

Web

预加载

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

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

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

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

✔️
仅高级版支持

预渲染

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

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

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

仅高级版和企业版支持

多实例

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

✔️

✔️

✔️

✔️

播放源过期自动刷新

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

✔️

播放失败重试

播放失败时自动重试。

✔️

✔️

✔️

边播边缓存

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

✔️

✔️

✔️

视频下载

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

✔️

✔️

互动功能

功能

说明

Android/iOS

Flutter

React Native

Web

外挂字幕

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

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

✔️

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

✔️

蒙版弹幕

播放弹幕时不遮挡人物。

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

✔️

视频安全

功能

说明

Android/iOS

Flutter

React Native

Web

Referer 黑白名单

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

✔️

✔️

✔️

✔️

时间戳防盗链

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

✔️

✔️

✔️

✔️

火山引擎私有加密

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

✔️

✔️

✔️

✔️

HLS 标准加密

支持标准 AES-128 加密方案。

✔️

✔️

✔️

✔️

质量上报

功能

说明

Android/iOS

Flutter

React Native

Web

日志上报

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

✔️

✔️

✔️

✔️

播放数据大盘

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

✔️

✔️

✔️

✔️

播放异常追溯

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

✔️

✔️

✔️

✔️

播放告警能力

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

✔️

✔️

✔️

✔️

开发支持

功能

说明

Android/iOS

Flutter

React Native

Web

事件回调

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

✔️

✔️

✔️

✔️

渲染数据输出

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

✔️

实时下载网速

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

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

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

UI 组件

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

✔️

✔️

多 Region

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

说明

当前亚太东南(柔佛)地域邀测中,仅针对企业用户开放。如有需求,请提交工单联系技术支持申请。

✔️

✔️

✔️

服务支持

功能

说明

Android/iOS

Flutter

React Native

Web

工单服务

支持提交工单进行咨询。

✔️

✔️

✔️

✔️

专家服务

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

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

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

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

✔️

质量优化

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

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

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

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

✔️

增值功能

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

说明

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

功能

说明

Android/iOS

Flutter

React Native

Web

H.266 编码格式

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

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

✔️
仅高级版支持

自适应码率播放 (ABR)

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

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

✔️
仅高级版支持

客户端超分

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

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

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

动态 Buffer

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

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

✔️
仅高级版支持