播放器 SDK 是腾讯云视立方产品家族的子产品之一,提供直播、点播场景的视频播放能力。您可以在 产品功能 中查看 SDK 支持的功能清单,在 Demo 体验 中获取各端 Demo 进行功能体验,在本页面中下载各端 SDK 并获取 Demo 源码。
播放器 SDK 下载
播放器 SDK 提供方为深圳市腾讯计算机系统有限公司,其个人信息处理规则见 腾讯云视立方·播放器 SDK 个人信息保护规则,当前可下载版本为 12.3,发布日志见 发布日志(iOS 和 Android),合规使用说明见 腾讯云视立方·播放器 SDK 合规使用指南。
Web SDK
iOS SDK 与 Android SDK
HarmonyOS SDK
说明:
跨平台 SDK
SDK 能力清单
功能模块 | 功能项 | 功能简介 | Web | iOS & Android | Flutter |
播放协议/格式 | 点播或直播支持 | 同时支持点播播放和直播播放能力 | ✓ | ✓ | ✓ |
| 支持的直播播放格式 | 支持 RTMP、FLV、HLS、DASH 和 WebRTC 等直播视频格式 | WebRTC、FLV、HLS、DASH | RTMP、FLV、HLS、WebRTC | RTMP、FLV、HLS、WebRTC |
| 支持的点播播放格式 | 支持 HLS、DASH、MP4 和 MP3 等点播音视频格式 | HLS、MP4、MP3、FLV、DASH | MP4、MP3、HLS、DASH(DASH仅高级版支持) | MP4、MP3、HLS |
| URL 播放 | 支持网络视频的 URL 方式播放,URL 可以为点播播放地址也可以为直播拉流地址 | ✓ | ✓ | ✓ |
| FileID 播放 | 支持通过云点播文件标识 FileID 播放视频,包含多个清晰度的视频、缩略图、打点等信息 | ✓ | ✓ | ✓ |
| 本地视频播放 | 支持播放存储在本地的视频文件 | - | ✓ | ✓ |
| 支持腾讯云毫秒级超低时延快直播播放 | ✓ | ✓ | ✓ | |
| DASH 协议支持 | 支持标准协议的 DASH 视频播放 | ✓ | ✓(仅高级版支持) | × |
| 全景 VR 视频 | 支持播放全景VR视频源,移动端设备支持手指拖动或陀螺仪操作以查看全景视频内容,PC端设备支持鼠标在界面上拖动画面查看 | × | ||
| Quic 加速 | 支持 Quic 传输协议,有效提升视频传输效率 | - | ✓(仅高级版支持) | ✓ |
| SDR/HDR 视频 | 支持播放 SDR 视频和 HDR 10/HLG 标准的 HDR 视频 | - | ✓ | ✓ |
| H.264播放及软硬解 | 支持播放 H.264 视频源,并支持软硬解 | ✓ | ✓ | ✓ |
| H.265硬解 | 支持对 H.265 视频源的硬解码播放 | - | ✓ | ✓ |
| AV1 | 支持播放 AV1 编码格式的视频 | 部分支持 | 部分支持(仅高级版支持) | 部分支持 |
| 纯音频播放 | 支持 MP3 等文件纯音频播放 | ✓ | ✓ | ✓ |
| 双声道音频 | 支持播放双声道音频 | × | ✓ | ✓ |
| 多音轨 | 支持播放含多音轨的视频文件,播放时可切换音轨,如英文切换中文。 | ✓ | ✓(仅高级版支持) | × |
| 设置 HTTP Header | 请求视频资源时,自定义 HTTP Headers 内容 | × | ✓ | ✓ |
| 支持 HTTPS | 支持播放 HTTPS 的视频资源 | ✓ | ✓ | ✓ |
| HTTP 2.0 | 支持 HTTP 2.0协议 | ✓ | ✓ | ✓ |
播放性能 | 以极低的接入成本,实现极速首帧、无感启播、丝滑切换的短视频播放体验。结合预播放、预下载、播放器复用、精准流量控制、加载策略等技术,在保证低能耗的前提下实现更好的播放效果。 | - | ✓(仅高级版支持) | × | |
| 预下载 | 支持提前下载指定视频文件内容,并支持配置预下载视频文件的大小及分辨率。 | ✓ | ✓ | ✓ |
| 边播边缓存 | 支持播放的同时缓存下载后面的内容,降低网络占用,可设置缓存策略 | ✓ | ✓ | ✓ |
| 精准 seek | 支持在进度条上跳转到指定位置进行播放,移动端可精确到帧级别,Web 端精准到毫秒级 | ✓ | ✓ | ✓ |
| 自适应码率 | 支持播放 HLS、DASH 和 WebRTC 的自适应码流,可根据网络带宽自动选择合适的码率进行播放 | ✓ | ✓(DASH仅高级版支持) | ✓(不支持DASH) |
| 实时下载网速 | 支持获取实时下载网速,既可根据业务需要给 C 端用户在卡顿时展示下载网速,也是使用自适应码率带宽预测模块的必要前提 | ✓ | ✓ | ✓ |
| 多实例 | 支持在一个界面添加多个播放器同时播放 | ✓ | ✓ | ✓ |
| 动态追帧 | 发生卡顿时,通过类似“快进”的方式追赶上当前直播进度,保证直播画面实时性 | ✓ | × | × |
播放控制 | 基础控制 | 支持开始、结束、暂停和恢复等播放控制功能 | ✓ | ✓ | ✓ |
| 基础画中画 | 支持切换到画中画以小窗形式播放,移动端同时支持在集成APP内或APP外的画中画播放。 | ✓ | ✓ | ✓ |
| 相对基础画中画,新增支持加密视频画中画、离线播放画中画和“秒切”效果。 | - | ✓(仅高级版支持) | × | |
| 缓存内 seek | 支持已经缓存的视频内容在 seek 时不清除缓存内容并快速 seek | ✓ | ✓ | ✓ |
| 直播时移 | 支持直播时移视频流播放,可设置开始、结束和当前支持时间,支持拖动 | ✓ | × | × |
| 进度条标记及缩略图预览 | 支持在进度条上添加标记信息,并支持缩略图(雪碧图)预览 | ✓ | ✓ | ✓ |
| 设置封面 | 支持设置播放视频的封面 | ✓ | ✓ | ✓ |
| 重播、循环播放、列表播放 | 支持视频播放结束后自动或手动重播;同时支持依次播放视频列表中的视频,并支持轮播,即在视频列表最后一个视频播放完成后,播放列表的第一个视频。 | ✓ | ✓ | ✓ |
| 断点续播 | 支持从上次播放结束位置开始播放 | ✓ | ✓ | ✓ |
| 自定义启播时间 | 支持自定义视频开启播放的时间 | ✓ | ✓ | ✓ |
| 倍速播放 | 支持0.5~3倍的变速播放,音频实现变速不变调 | ✓ | ✓ | ✓ |
| 后台播放 | 支持界面切到后台后继续播放音频和视频 | - | ✓ | ✓ |
| 播放回调 | 支持对播放状态回调、首帧回调、播放完成或失败回调 | ✓ | ✓ | ✓ |
| 播放失败重试 | 播放失败时自动重试,支持直播的自动重连功能 | ✓ | ✓ | ✓ |
| 音量设置 | 支持实时调节系统音量和静音操作 | ✓ | ✓ | ✓ |
| 清晰度切换和命名 | 支持用户流畅无卡顿的切换 HLS 视频的多路清晰度流,并支持为不同清晰度流自定义命名 | ✓ | ✓ | ✓ |
| 截图功能 | 支持截取播放画面的任意一帧 | - | ✓ | × |
| 试看功能 | 支持播放开启试看功能的视频 | ✓ | ✓ | × |
| 弹幕 | 支持在视频上方展示弹幕 | ✓ | ✓ | × |
| 外挂字幕 | 支持导入自定义字幕文件,Web 端支持 WebVTT 格式,移动端支持 VTT、SRT 格式 | ✓ | ✓(仅高级版支持) | ✓(仅高级版支持) |
referer 黑白名单 | 支持通过播放请求中携带的 Referer 字段识别请求的来源,以黑名单或白名单方式对来源请求进行控制 | ✓ | ✓ | ✓ | |
| Key 防盗链 | 支持在播放链接中加入控制参数,控制链接的有效时间、试看时长、允许播放的 IP 数等 | ✓ | ✓ | ✓ |
| HLS 加密 | 支持基于 HLS 提供的 AES encryption 方案,使用密钥对视频数据加密 | ✓ | ✓ | ✓ |
| HLS 私有加密 | 支持在云点播的私有协议对视频进行加密,且仅能通过播放器 SDK 对加密后的视频进行解密播放,可有效防范多种浏览器插件和灰产工具的破解 | ✓ | ✓ | ✓ |
| 商业 DRM | 提供苹果 Fairplay、谷歌 Widevine 原生加密方案 | ✓ | ✓(仅高级版支持) | × |
| 安全下载 | 支持离线下载加密视频后,仅可通过播放器 SDK 对视频进行解密播放 | - | ✓ | ✓ |
| 动态水印 | 支持在播放界面添加不规则跑动的文字水印,有效防盗录 | ✓ | ✓ | × |
| 溯源水印 | 支持以极低的成本实现对视频盗录者的追溯 | ✓ | ✓ | ✓ |
| 随机时间、随机位置、短暂的出现在播放界面上,同时一旦检测到水印被异常去除,将自动停止视频播放;可在几乎不影响观看体验的同时保证视频安全。 | ✓ | × | × | |
| 检测Web端播放环境和播放状态是否正常,异常环境下将中断视频播放,保护视频安全。插件包含MSE环境检测、安全结构检查和接口响应完整性校验。 | ✓(仅高级版) | - | - | |
显示效果 | 自定义 UI | SDK 提供含 UI 集成方案,提供包含 UI 界面的常用播放组件,可以根据自身需求选用 | ✓ | ✓ | ✓ |
| 屏幕填充 | 支持为视频画面选择不同填充模式,适应屏幕大小 | ✓ | ✓ | × |
| 设置播放器尺寸 | 支持自定义设置播放器的宽高 | ✓ | ✓ | ✓ |
| 图片贴片 | 支持暂停时,增加图片贴片用于广告展示 | ✓ | ✓ | × |
| 视频镜像 | 支持水平、垂直等方向的镜像 | ✓ | ✓ | × |
| 视频旋转 | 支持对视频画面按角度旋转,同时支持根据视频文件内部 rotate 参数自动旋转视频 | × | ✓ | × |
| 锁定屏幕 | 支持锁屏功能,包含锁定旋转和隐藏界面元素 | - | ✓ | × |
| 亮度调节 | 支持播放视频时调节系统亮度 | - | ✓ | ✓ |
增值功能 | 终端极速高清 | × | ✓ | × | |
| 播放质量监控 | ✓ | ✓ | ✓ |
注意:
表中“-”表示该端无需具备相应功能或不存在相关概念。
未注明“仅高级版支持”的“✓”代表基础版即支持。
安装包增量
平台 | 基础版安装包增量 | 高级版安装包增量 |
Android | arm64:4.1 M armv7:3.9 M dex:573 KB | arm64:4.4 M armv7:4.2 M dex:573 KB |
iOS | arm64:5M | arm64:5.3M |