最近更新时间：2024.04.07 14:43:09
首次发布时间：2022.02.15 19:41:38
点播 SDK 提供全面、稳定、流畅的视频播放服务，支持 Android、iOS、Web 和小程序平台。本文为您详细介绍点播 SDK 支持的功能。
本节以 Android、iOS、Web 端为例，介绍点播 SDK 的标准功能。
注意
Web 端的功能支持还取决于系统和浏览器，详见 Web 浏览器兼容说明。
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
音视频格式 | 支持 MP4、MP3、HLS、Vorbis 等丰富的音视频格式。 | √ | √ | √ |
DirectUrl 播放 | 支持以 DirectUrl 方式播放本地视频和网络视频。 | √ | √ | √ |
| Vid 播放 | 支持以 Vid 方式播放存储在视频点播服务的视频。视频点播服务可下发多个清晰度的播放地址（如有）。 | √ | √ | √ |
| H.264 编码格式 | 支持播放 H.264 视频源，并支持软硬解切换。 | √ | √ | √ |
H.265 编码格式 | 支持对 H.265 视频源的硬解码播放。 | √ | √ 说明 额外提供硬解机型黑名单和硬解优化。 | √ |
DASH 协议 | 支持对标准协议的 DASH 视频流和经过火山引擎相关优化的升级版 DASH 视频流的播放和转码。 | √ | √ | √ |
HDR | 支持播放 HDR10/HLG 等多种 HDR（High Dynamic Range，高动态范围）视频。 | √ | √ | √ |
| 软硬解自动切换 | 当终端设备不支持硬件解码时自动切换到软件解码。 | √ | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 基础控制 | 支持开始、结束、暂停和恢复等播放控制功能。 | √ | √ | √ |
| Seek | 支持拖动到指定位置。 | √ | √ | √ |
| 精准 Seek | 支持以帧级别的精确度拖动到指定位置。 | √ | √ | √ |
| 缓存内 Seek | 在进行 Seek 操作时，已缓存的视频内容不被清除且能够快速进行 Seek。 | √ | √ | √ |
| 重播 | 支持视频播放结束后手动触发重播。 | √ | √ | √ |
| 续播 | 支持设置续播起播时间点。 | √ | √ | √ |
| 循环播放 | 支持视频播放结束后自动重播。 | √ | √ | √ |
| 倍速播放 | 支持 0.5 至 5 倍的变速播放，与此同时音频变速不变调。 | √ | √ | √ |
| 清晰度切换 | 支持在视频点播服务生成的多路清晰度流中切换。 | √ | √ | √ |
| 无缝切换 | 针对视频点播服务生成的帧对齐的 MP4、M3U8、DASH 视频，支持在播放过程中平滑切换多个分辨率的播放地址，提升用户的播放体验。 | √ | √ | √ |
| 切换音轨 | 支持在视频点播服务生成的多路 M4A 音轨流中切换。 | √ | √ | X |
| 截图 | 支持截取播放画面的任意一帧。 | √ | √ | X |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 自定义 Header | 支持在请求音视频资源时，自定义 HTTP Header | √ | √ | X |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 音量调节 | 支持调节视频音量。 | √ | √ | √ |
| 静音 | 支持开启和关闭静音。 | √ | √ | √ |
| 纯音频播放 | 支持只播放 DASH 视频文件中的音频和常见的音频文件，例如 MP3、AAC。 | X | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 填充模式 | 支持画面裁剪和填充。 | √ | √ | √ |
| 旋转 | 支持 0°、90°、180° 和 270° 四个旋转角度。 | √ | √ | √ |
| 镜像 | 支持无镜像、水平镜像和垂直镜像三种镜像模式。 | √ | √ | √ |
| 缩略图预览（雪碧图） | 支持进度条缩略图预览。 | √ | √ | √ |
| 设置播放器尺寸 | 支持自定义设置播放器的宽高。 | √ | √ | √ |
| 画中画（小窗） | 支持切换到画中画以小窗形式播放。 | √ | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
预加载 | 在播放当前视频时，提前下载后续视频数据，确保在切换到下一个视频时能够快速起播。 | X | √ | √ |
| 预渲染 | 在播放当前视频时，提前创建播放器并对下一个视频进行解码和渲染，同时可将预渲染的首帧用作视频封面，提前展示给用户。 | X | √ | X |
| 多实例 | 支持在同一界面添加多个播放器并同时播放。 | √ | √ | √ |
| 播放源过期自动刷新 | 支持播放 URL 过期后自动刷新。 | √ | √ | X |
| 播放失败重试 | 播放失败时自动重试。 | √ | √ | X |
边播边缓存 | 支持在播放过程中同时缓存后续内容，降低网络占用，并可设置缓存策略。 | √ | √ | X |
| 视频下载 | 支持将视频下载到本地进行离线播放。 | √ | √ | X |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 外挂字幕 | 支持导入 WebVTT 格式的字幕文件。 | X | √ | √ |
| 蒙版弹幕 | 播放弹幕时不遮挡人物。 | X | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| Referer 黑白名单 | 支持通过播放请求中携带的 Referer 字段识别请求来源，以黑名单或白名单方式对请求来源进行控制。 | √ | √ | √ |
| 时间戳防盗链 | 支持视频的播放地址仅能在鉴权有效时间内播放。 | √ | √ | √ |
| 火山引擎私有加密 | 支持火山引擎私有加密方案，防止视频泄露和盗链问题。 | √ | √ | √ |
| HLS 标准加密 | 支持标准 AES-128 加密方案。 | √ | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 日志上报 | 支持上报播放器 SDK 日志，统计点播视频播放的埋点数据。 | √ | √ | √ |
| 播放数据大盘 | 支持观测播放量、播放质量等大盘数据。 | √ | √ | √ |
| 播放异常追溯 | 支持按照指定用户、播放会话对播放历史进行追溯，定位播放异常原因。 | √ | √ | √ |
| 播放告警能力 | 配合质量平台使用，对播放质量进行监控告警，及时发现播放异常。 | √ | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 事件回调 | 支持对播放状态回调、首帧回调、播放完成或失败回调。 | √ | √ | √ |
| 渲染数据输出 | 支持边渲染边输出 PCM 数据。 | √ | √ | X |
| 实时下载网速 | 支持获取实时下载网速，既可根据业务需要给终端用户在卡顿时展示下载网速，也是使用自适应码率带宽预测模块的必要前提。 | X | √ | X |
| UI 组件 | 提供完整播放器 UI，您可以根据自身需求选用。 | √ | √ | √ |
功能 | 说明 | Android & iOS | Web | |
|---|---|---|---|---|
| 基础版 | 高级版和企业版 | |||
| 工单服务 | 支持提交工单进行咨询。 | √ | √ | √ |
| 专家服务 | 提供专家级技术支持和指导。 | X | √ | √ |
| 质量优化 | 依赖日志埋点上报和质量平台，提供专家级质量优化服务。 | X | √ | √ |
本节以 Android、iOS、Web 端为例，介绍点播 SDK 的增值功能。
说明
对于 Android 和 iOS 高级版，增值功能为选配，可单独收费，详情请咨询火山引擎商务。
功能 | 说明 | Android & iOS | Web | ||
|---|---|---|---|---|---|
| 基础版 | 高级版 | 企业版 | |||
| H.266 编码格式 | 支持播放 H.266 视频源，并提供完整的 H.266 解决方案。 | X | 选配 | √ | X |
自适应码率 | 播放 DASH/HLS 视频时，根据预测的带宽自动选择适合的清晰度进行播放。 | X | 选配 | √ | X |
| 客户端超分 | 针对在线视频，通过端上实时后处理超分技术，在保证画质的前提下，节省带宽；或者在相同带宽条件下，提升视频播放的清晰度和主观质量。 | X | 选配 | √ | X |