点播播放器
支持 FLV、MP4 及 HLS 多种播放格式，支持 基础播放（URL 播放） 和 点播播放（Fileid 播放）两种播放方式 。
屏幕截图，可以截取当前播放流的视频画面。
通过手势操作，调节亮度、声音、进度等。
可以手动切换不同的清晰度，也可根据网络带宽自适应选择清晰度。
可以指定不同倍速播放，并开启镜像和硬件加速。
完整能力，请参见 播放器SDK - 能力清单。
播放器配置接口
API | 描述 |
startVodPlay 后是否立即播放，默认 YES。 | |
加密 HLS 的 token。设置此值后，播放器自动在 URL 中的文件名之前增加 voddrm.token.TOKEN TextureView。 | |
是否循环播放 SurfaceView。 | |
视频渲染回调。（仅硬解支持） | |
设置播放器业务参数，参数格式为 <NSString *, id> | |
setSubtitleStyle | 设置字幕样式信息，可在播放后对字幕样式进行更新（播放器高级版本才支持）。 |
setAudioNormalization | 设置音量均衡，响度范围：-70～0（LUFS） 。播放器高级版 11.7 版本开始支持。 可填预设值（相关类或文件：Android：TXVodConstants；iOS：TXVodPlayConfig.h） 关：AUDIO_NORMALIZATION_OFF 开：AUDIO_NORMALIZATION_STANDARD（标准）
AUDIO_NORMALIZATION_LOW （低）
AUDIO_NORMALIZATION_HIGH（高） 可填自定义数值：从低到高，范围-70 - 0 LUFS。 |
播放基础接口
API | 描述 |
播放 HTTP URL 形式地址。 10.7 版本开始， startPlay变更为startVodPlay，需要通过 V2TXLivePremier#setLicence或者TXLiveBase#setLicence设置 License 后方可成功播放， 否则将播放失败（黑屏），全局仅设置一次即可。直播 Licence、短视频 Licence 和播放器 Licence 均可使用，若您暂未获取上述 Licence ，可 免费申请测试版 License 以正常播放，正式版 License 需 购买。 | |
启动一个标准 Fairplay drm 播放。 | |
以 fileId 形式播放。 10.7 版本开始， startPlayWithParams变更为startVodPlayWithParams，需要通过 V2TXLivePremier#setLicence或者TXLiveBase#setLicence设置 License 后方可成功播放， 否则将播放失败（黑屏），全局仅设置一次即可。直播 Licence、短视频 Licence 和播放器 Licence 均可使用，若您暂未获取上述 Licence ，可 免费申请测试版 License 以正常播放，正式版 License 需 购买。 | |
停止播放。 | |
是否正在播放。 | |
暂停播放，停止获取流数据,保留最后一帧画面。 | |
恢复播放，重新获取流数据。 | |
跳转到视频流指定时间点，单位秒。 | |
获取当前播放位置，单位秒。 | |
获取总时长，单位秒。 | |
获取可播放时长，单位秒。 | |
获取视频宽度。 | |
获取视频高度。 | |
设置播放开始时间。 | |
创建 Video 渲染 View，该控件承载着视频内容的展示。 | |
移除 Video 渲染 View。 | |
添加外挂字幕（播放器高级版本才支持）。 | |
返回字幕轨道信息列表（播放器高级版本才支持）。 | |
返回音频轨道信息列表（播放器高级版本才支持）。 | |
选择轨道（播放器高级版本才支持）。 | |
取消选择轨道（播放器高级版本才支持）。 | |
seekToPdtTime | 跳转到视频流指定 PDT（Program Date Time ）时间点，可实现视频快进、快退、进度条跳转等功能，目前只支持 HLS 视频格式。（播放器高级版 11.6 版本开始支持）。
参数单位毫秒(ms)。 |
视频相关接口
API | 描述 |
获取当前视频帧图像。 注意：由于获取当前帧图像是比较耗时的操作，所以截图会通过异步回调出来。 | |
设置镜像。 | |
设置点播的播放速率，默认1.0。 | |
返回当前播放的码率索引。 | |
设置当前正在播放的码率索引，无缝切换清晰度。 清晰度切换可能需要等待一小段时间。 | |
当播放地址为 master playlist，返回支持的码率（清晰度）。 | |
进入画中画功能。 | |
退出画中画功能。 |
音频相关接口
API | 描述 |
设置是否静音播放。 | |
设置音量大小，范围：0 - 100。 |
事件通知接口
API | 描述 |
设置播放器的回调。 | |
视频渲染回调（软硬解都支持）。 |
TRTC 相关接口
API | 描述 |
开始推送视频流。 | |
取消推送视频流。 | |
开始推送音频流。 | |
取消推送音频流。 |
类方法
API | 描述 |
获取加固加密播放密钥。 | |
是否支持 Picture In Picture功能（“画中画”功能）。 |
TXVodPlayListener
腾讯云点播回调通知。
SDK 基础回调
API | 描述 |
画中画状态回调。 | |
画中画错误状态回调。 |
TXVodPlayConfig
点播播放器配置类。
基础配置接口
API | 描述 |
设置播放器重连次数。 | |
设置播放器重连间隔，单位秒。 | |
设置播放器连接超时时间，单位秒。 | |
设置点播缓存目录，点播 MP4、HLS 有效。 | |
设置缓存文件个数。 | |
设置播放器类型。 PLAYER_AVPLAYER：使用系统自带播放器。 PLAYER_THUMB_PLAYER：使用腾讯云自研播放器。 | |
设置自定义 HTTP headers。 | |
设置是否精确 seek，默认 true。 | |
播放 MP4 文件时，若设为 YES 则根据文件中的旋转角度自动旋转。 旋转角度可在 PLAY_EVT_CHANGE_ROTATION 事件中获得。默认 YES。 | |
平滑切换多码率 HLS，默认 false。 | |
设置进度回调间隔，单位毫秒。 | |
最大预加载大小，单位 MB。 | |
设置预加载最大缓冲大小，单位：MB。 | |
设置首缓需要加载的数据时长，单位 ms，默认值为100ms。 | |
缓冲时（缓冲数据不够引起的二次缓冲，或者 seek 引起的拖动缓冲）最少要缓存多长的数据才能结束缓冲，单位ms，默认值为250ms。 | |
设置 HLS 安全加固加解密 key。 | |
设置 HLS 安全加固加解密 Iv。 | |
设置拓展信息。 | |
播放 HLS 有多条码流时，根据设定的 preferredResolution 选最优的码流进行起播，preferredResolution 是宽高的乘积（width * height）， 启播前设置才有效。 | |
enableRenderProcess | 是否允许加载后渲染后处理服务（如超分插件服务），默认开启。 |
视频渲染对象回调的视频格式。 | |
stopPlay 的时候是否保留最后一帧画面，默认值为 NO。 | |
设置媒资类型。可选值有： MEDIA_TYPE_AUTO，AUTO 类型（默认值，自适应码率播放暂不支持）。 MEDIA_TYPE_HLS_VOD，HLS 点播媒资。 MEDIA_TYPE_HLS_LIVE，HLS 直播媒资。 MEDIA_TYPE_FILE_VOD，MP4 等通用文件点播媒资（从 11.2 版本开始支持）。 MEDIA_TYPE_DASH_VOD，DASH 点播媒资（从 11.2 版本开始支持）。 |
TXPlayerGlobalSetting
点播播放器全局配置类。
API | 描述 |
设置播放引擎的 cache 目录。设置后，预下载，播放器等会优先从此目录读取和存储。 | |
设置播放引擎的最大缓存大小。设置后会根据设定值自动清理 Cache 目录的文件。单位 MB。 |
TXVodPreloadManager
点播播放器预下载接口类。
API | 描述 |
获取 TXVodPreloadManager 实例对象，单例模式。 | |
启动预下载前，请先设置好播放引擎的缓存目录 TXPlayerGlobalSetting#setCacheFolderPath 和缓存大小TXPlayerGlobalSetting#setMaxCacheSize。 | |
停止预下载。 |
视频预下载回调
API | 描述 |
下载完成回调。 | |
下载错误回调。 |
TXVodDownloadManager
点播播放器视频下载接口类。
TXVodDownloadDataSource
API | 描述 |
fileid 信息。 | |
下载清晰度，默认原画。 | |
如地址有加密，请填写 token。 | |
清晰度模板。 | |
文件Id。 | |
签名信息。 | |
应用 appId。必填。 | |
账户名称。 | |
HLS EXT-X-KEY 加解密参数。 | |
加解密参数 overlayIv。 |
TXVodDownloadMediaInfo
API | 描述 |
是否下载完成。 | |
fileid 下载对象（可选）。 | |
下载地址。 | |
账户名称 。 | |
时长。 | |
可播放时长。 | |
获取下载文件总大小，单位：Byte，只针对 fileid 下载源有效。 注意：总大小是指上传到腾讯云点播控制台的原始文件的大小，转自适应码流后的子流大小，暂时无法获取。 | |
已下载大小，单位：byte。 | |
分段总数。 | |
已下载的分段数 | |
进度。 | |
播放路径，可传给 TXVodPlayer 播放。 | |
下载速度，byte 每秒。 | |
下载状态。 | |
isResourceBroken | 判断下载后的视频资源是否损坏，如下载完被删除等情况将返回 YES。（11.0 版本开始支持）TXVodDownloadManager |
API | 描述 |
获取 TXVodDownloadManager 实例对象，单例模式。 | |
设置下载根目录。 | |
设置下载 HTTP 头。 | |
设置下载回调方法，下载前必须设好。 | |
以 URL 方式开始下载。 | |
以 FileID 方式开始下载。 | |
停止下载，ITXVodDownloadListener.onDownloadStop 回调时停止成功。 | |
删除下载文件。 | |
删除下载信息。 | |
获取所有用户的下载列表信息，耗时接口，请不要在主线程调用。 | |
获取下载信息，耗时接口，请不要在主线程调用。 | |
获取 HLS EXT-X-KEY。 | |
加密。 |
TXVodDownloadDelegate
API | 描述 |
下载开始。 | |
下载进度更新。 | |
下载停止。 | |
下载结束。 | |
下载过程中遇到错误。 | |
下载 HLS，遇到加密的文件，将解密 Key 给外部校验。 |
TXDownloadError
枚举值 | 含义说明 |
TXDownloadSuccess | 下载成功。 |
TXDownloadAuthFaild | fileid 鉴权失败。 |
TXDownloadNoFile | 无此清晰度文件。 |
TXDownloadFormatError | 格式不支持。 |
TXDownloadDisconnet | 网络断开。 |
TXDownloadHlsKeyError | 获取 HLS 解密 key 失败。 |
TXDownloadPathError | 下载目录访问失败。 |
TXVodDownloadMediaInfoState
枚举值 | 含义说明 |
TXVodDownloadMediaInfoStateInit | 下载初始态。 |
TXVodDownloadMediaInfoStateStart | 下载开始。 |
TXVodDownloadMediaInfoStateStop | 下载停止。 |
TXVodDownloadMediaInfoStateError | 下载出错。 |
TXVodDownloadMediaInfoStateFinish | 下载完成。 |
TXVodQuality
说明：
TXVodQuality240P ~ TXVodQuality1080p 常量在 11.0 版本新增。
枚举值 | 含义说明 |
TXVodQualityOD | 原画。 |
TXVodQualityFLU | 流畅。 |
TXVodQualitySD | 标清。 |
TXVodQualityHD | 高清。 |
TXVodQualityFHD | 全高清。 |
TXVodQuality2K | 2K。 |
TXVodQuality4K | 4K。 |
TXVodQuality240P | 流畅240P。 |
TXVodQuality360P | 流畅360P。 |
TXVodQuality480P | 标清480P。 |
TXVodQuality540P | 标清540P。 |
TXVodQuality720P | 高清720P。 |
TXVodQuality1080p | 高清720P。 |
TXPlayerAuthParams
通过 fileId 播放加密视频配置。
TXBitrateItem
HLS 多码率信息。
TXImageSprite
雪碧图解析工具。
API | 描述 |
设置雪碧图地址。 | |
获取缩略图。 |
TXPlayerDrmBuilder
点播 Drm 构造器。
API | 描述 |
证书提供商 URL。 | |
解密 key URL。 | |
播放链接。 |
错误码表
常规事件
code | 事件定义 | 含义说明 |
2004 | PLAY_EVT_PLAY_BEGIN | 视频播放开始（若有转圈圈效果，此时将停止）。 |
2005 | PLAY_EVT_PLAY_PROGRESS | 视频播放进度，会通知当前播放进度、加载进度和总体时长。 |
2007 | PLAY_EVT_PLAY_LOADING | 视频播放 loading，如果能够恢复，之后会有 LOADING_END 事件。 |
2014 | PLAY_EVT_VOD_LOADING_END | 视频播放 loading 结束，视频继续播放。 |
2006 | PLAY_EVT_PLAY_END | 视频播放结束。 |
2013 | PLAY_EVT_VOD_PLAY_PREPARED | 播放器已准备完成，可以播放。 |
2003 | PLAY_EVT_RCV_FIRST_I_FRAME | 网络接收到首个可渲染的视频数据包（IDR）。 |
2009 | PLAY_EVT_CHANGE_RESOLUTION | 视频分辨率改变。 |
2011 | PLAY_EVT_CHANGE_ROTATION | MP4 视频旋转角度。 |
警告事件
code | 事件定义 | 含义说明 |
-2301 | PLAY_ERR_NET_DISCONNECT | 网络断连，且经多次重连亦不能恢复,更多重试请自行重启播放。 |
-2305 | PLAY_ERR_HLS_KEY | HLS 解密 key 获取失败。 |
2101 | PLAY_WARNING_VIDEO_DECODE_FAIL | 当前视频帧解码失败。 |
2102 | PLAY_WARNING_AUDIO_DECODE_FAIL | 当前音频帧解码失败。 |
2103 | PLAY_WARNING_RECONNECT | 网络断连, 已启动自动重连（重连超过三次就直接抛送 PLAY_ERR_NET_DISCONNECT）。 |
2106 | PLAY_WARNING_HW_ACCELERATION_FAIL | 硬解启动失败，采用软解。 |
-2304 | PLAY_ERR_HEVC_DECODE_FAIL | H265 解码失败。 |
-2303 | PLAY_ERR_FILE_NOT_FOUND | 播放的文件不存在。 |
-5 | VOD_PLAY_ERR_LICENCE_CHECK_FAIL | License 不合法，播放失败。 注意： 在 startVodPlay 之前，需要通过 TXLiveBase#setLicence 设置 License 后方可成功播放，否则将播放失败（黑屏），全局仅设置一次即可。直播 License、短视频 License 和播放器 License 均可使用，若您暂未获取上述 License ，可 免费申请测试版 License 以正常播放，正式版 License 需 购买。 |
播放器 SDK 常量
事件码和错误码定义
枚举值 | 含义 |
VOD_PLAY_EVT_RCV_FIRST_I_FRAME | 播放事件：成功接收到第一个视频帧。 |
VOD_PLAY_EVT_RCV_FIRST_AUDIO_FRAME | 播放事件：成功接收到第一个音频帧。 |
VOD_PLAY_EVT_PLAY_BEGIN | 播放事件：播放已经开始。 |
VOD_PLAY_EVT_PLAY_PROGRESS | 播放事件：播放进度更新，点播播放器（VodPlayer）专用。 |
VOD_PLAY_EVT_PLAY_END | 播放事件：播放已经结束。 |
VOD_PLAY_EVT_PLAY_LOADING | 播放事件：数据缓冲中。 |
VOD_PLAY_EVT_START_VIDEO_DECODER | 播放事件：视频解码器已经启动。 |
VOD_PLAY_EVT_CHANGE_RESOLUTION | 播放事件：视频分辨率发生变化。 |
VOD_PLAY_EVT_GET_PLAYINFO_SUCC | 播放事件：成功获取到点播文件的信息，点播播放器（VodPlayer）专用。 |
VOD_PLAY_EVT_CHANGE_ROTATION | 播放事件：MP4 视频的旋转角度发生变化，点播播放器（VodPlayer）专用。 |
VOD_PLAY_EVT_VOD_PLAY_PREPARED | 播放事件：视频加载完毕，点播播放器（VodPlayer）专用。 |
VOD_PLAY_EVT_VOD_LOADING_END | 播放事件：视频缓冲结束，点播播放器（VodPlayer）专用。 |
VOD_PLAY_EVT_STREAM_SWITCH_SUCC | 播放事件：已经成功完成切流（在不同清晰度的视频流之间进行切换）。 |
VOD_PLAY_EVT_VOD_PLAY_TCP_CONNECT_SUCC | TCP 连接成功。 |
VOD_PLAY_EVT_VOD_PLAY_SEEK_COMPLETE | 视频播放 Seek 完成。 |
VOD_PLAY_EVT_AUDIO_SESSION_INTERRUPT | 播放事件: Audio Session 被其他 App 中断（仅适用于 iOS 平台）。 |
VOD_PLAY_ERR_NET_DISCONNECT | 直播错误：网络连接断开（已经经过三次重试并且未能重连成功）。 |
VOD_PLAY_ERR_FILE_NOT_FOUND | 点播错误：播放文件不存在。 |
VOD_PLAY_ERR_HLS_KEY | 点播错误：HLS 解码 KEY 获取失败。 |
VOD_PLAY_ERR_GET_PLAYINFO_FAIL | 点播错误：获取点播文件的文件信息失败。 |
画中画错误类型
枚举值 | 含义 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_NONE | 无错误。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_DEVICE_NOT_SUPPORT | 设备或系统版本不支持（iPad iOS9+ 才支持 PIP）。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_PLAYER_NOT_SUPPORT | 播放器不支持。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_VIDEO_NOT_SUPPORT | 视频不支持。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_PIP_IS_NOT_POSSIBLE | PIP 控制器不可用。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_ERROR_FROM_SYSTEM | PIP 控制器报错。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_PLAYER_NOT_EXIST | 播放器对象不存在。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_PIP_IS_RUNNING | PIP 功能已经运行。 |
TX_VOD_PLAYER_PIP_ERROR_TYPE_PIP_NOT_RUNNING | PIP 功能没有启动。 |
画中画控制器状态
枚举值 | 含义 |
TX_VOD_PLAYER_PIP_STATE_UNDEFINED | 未设置状态。 |
TX_VOD_PLAYER_PIP_STATE_WILL_START | 画中画即将开始。 |
TX_VOD_PLAYER_PIP_STATE_DID_START | 画中画已经开始。 |
TX_VOD_PLAYER_PIP_STATE_WILL_STOP | 画中画即将结束。 |
TX_VOD_PLAYER_PIP_STATE_DID_STOP | 画中画已经结束。 |
TX_VOD_PLAYER_PIP_STATE_RESTORE_UI | 重置 UI。 |
