点播 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、Vorbis 等丰富的音视频格式。 | √ | √ | √ | √ |
DirectUrl 播放 | 支持以 DirectUrl 方式播放本地视频和网络视频。 | √ | √ | √ | √ |
Vid 播放 | 支持以 Vid 方式播放存储在视频点播服务的视频。视频点播服务可下发多个清晰度的播放地址(如有)。 | √ | √ | √ | √ |
H.264 编码格式 | 支持播放 H.264 视频源,并支持软硬解切换。 | √ | √ | √ | √ |
H.265 编码格式 | 支持对 H.265 视频源的硬解码播放。 | √ | √ | √ | √ |
DASH 协议 | 支持对标准协议的 DASH 视频流和经过火山引擎相关优化的升级版 DASH 视频流的播放和转码。 | √ | X | √ | √ |
HDR | 支持播放 HDR10/HLG 等多种 HDR(High Dynamic Range,高动态范围)视频。 | √ | √ | X | √ |
软硬解自动切换 | 当终端设备不支持硬件解码时自动切换到软件解码。 | √ | √ | √ | √ |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
基础播放控制 | 支持开始、结束、暂停和恢复等播放控制功能。 | √ | √ | √ | √ |
Seek | 支持拖动到指定位置。 | √ | √ | √ | √ |
精准 Seek | 支持以帧级别的精确度拖动到指定位置。 | √ | √ | √ | √ |
缓存内 Seek | 在进行 Seek 操作时,已缓存的视频内容不被清除且能够快速进行 Seek。 | √ | √ | √ | √ |
重播 | 支持视频播放结束后手动触发重播。 | √ | √ | √ | √ |
续播 | 支持设置续播起播时间点。 | √ | √ | √ | √ |
循环播放 | 支持视频播放结束后自动重播。 | √ | √ | √ | √ |
倍速播放 | 支持变速播放,与此同时音频变速不变调。 | √ | √ | √ | √ |
清晰度切换 | 支持用户流畅无卡顿地切换视频的多路清晰度流。 | √ | √ | √ | √ |
无缝切换 | 针对视频点播服务生成的帧对齐的 MP4、M3U8、DASH 视频,支持在播放过程中平滑切换多个分辨率的播放地址,提升用户的播放体验。 | √ | X | X | √ |
切换音轨 | 支持在视频点播服务生成的多路 M4A 音轨流中切换。 | √ | X | X | X |
截图 | 支持截取播放画面的任意一帧。 | √ | X | X | X |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
自定义 Header | 支持在请求音视频资源时,自定义 HTTP Header。 | √ | √ | X | X |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
音量调节 | 支持调节视频音量。 | √ | √ | √ | √ |
静音 | 支持开启和关闭静音。 | √ | √ | √ | √ |
纯音频播放 | 支持只播放 DASH 视频文件中的音频和常见的音频文件,例如 MP3、AAC。 | √ | √ | √ | √ |
音量均衡 | 支持均衡视频的音量大小,避免音量忽大忽小的场景,需要搭配视频点播服务音量检测功能使用。 | √ | X | X | X |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
填充模式 | 支持画面裁剪和填充。 | √ | √ | √ | √ |
旋转 | 支持 0°、90°、180° 和 270° 四个旋转角度。 | √ | √ | √ | √ |
镜像 | 支持无镜像、水平镜像和垂直镜像三种镜像模式。 | √ | √ | √ | √ |
缩略图预览(雪碧图) | 支持进度条缩略图预览。 | √ | X | X | √ |
设置播放器尺寸 | 支持自定义设置播放器的宽高。 | √ | √ | √ | √ |
画中画(小窗) | 支持切换到画中画以小窗形式播放。 | √ | X | X | √ |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
预加载 | 在播放当前视频时,提前下载后续视频数据,确保在切换到下一个视频时能够快速起播。 | √ | √ | √ | √ |
预渲染 | 在播放当前视频时,提前创建播放器并对下一个视频进行解码和渲染,同时可将预渲染的首帧用作视频封面,提前展示给用户。 | √ | √ | 仅高级版和企业版支持 | X |
多实例 | 支持在同一界面添加多个播放器并同时播放。 | √ | √ | √ | √ |
播放源过期自动刷新 | 支持播放 URL 过期后自动刷新。 | √ | X | X | X |
播放失败重试 | 播放失败时自动重试。 | √ | √ | √ | X |
边播边缓存 | 支持在播放过程中同时缓存后续内容,降低网络占用,并可设置缓存策略。 | √ | √ | √ | X |
视频下载 | 支持将视频下载到本地进行离线播放。 | √ | X | X | X |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
外挂字幕 | 支持导入 WebVTT 格式的字幕文件。 | √ | X | √ | √ |
蒙版弹幕 | 播放弹幕时不遮挡人物。 | √ | X | X | √ |
功能 | 说明 | 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 数据。 | √ | X | X | X |
实时下载网速 | 支持获取实时下载网速,既可根据业务需要给终端用户在卡顿时展示下载网速,也是使用自适应码率带宽预测模块的必要前提。 | √ | √ | X | X |
UI 组件 | 提供完整播放器 UI,您可以根据自身需求选用。 | √ | X | X | √ |
多 Region | 支持初始化播放器时设置 Region,适用于国际化播放场景。 说明 当前亚太东南(柔佛)地域邀测中,仅针对企业用户开放。如有需求,请提交工单联系技术支持申请。 | √ | √ | X | √ |
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
工单服务 | 支持提交工单进行咨询。 | √ | √ | √ | √ |
专家服务 | 提供专家级技术支持和指导。 | √ | √ | √ | √ |
质量优化 | 依赖日志埋点上报和质量平台,提供专家级质量优化服务。 | √ | √ | √ | √ |
本节介绍点播 SDK 的增值功能。
说明
对于 Android 和 iOS 高级版,增值功能为选配,单独收费,详情请咨询火山引擎商务。
功能 | 说明 | Android/iOS | Flutter | React Native | Web |
---|---|---|---|---|---|
H.266 编码格式 | 支持播放 H.266 视频源,并提供完整的 H.266 解决方案。 | √ | X | X | X |
自适应码率 | 播放 DASH/HLS 视频时,根据预测的带宽自动选择适合的清晰度进行播放。 | √ | X | X | X |
客户端超分 | 针对在线视频,通过端上实时后处理超分技术,在保证画质的前提下,节省带宽;或者在相同带宽条件下,提升视频播放的清晰度和主观质量。 | √ | X | X | X |