有奖征文:轻量对象存储LighthouseCOS用户实践> HOT

TXVodPlayer

点播播放器

请参见 TXVodPlayer。 主要负责从指定的点播流地址拉取音视频数据,并进行解码和本地渲染播放。 播放器包含如下能力:
支持 FLV、MP4 及 HLS 多种播放格式,支持 基础播放(URL 播放) 和 点播播放(Fileid 播放)两种播放方式 。
屏幕截图,可以截取当前播放流的视频画面。
通过手势操作,调节亮度、声音、进度等。
可以手动切换不同的清晰度,也可根据网络带宽自适应选择清晰度。
可以指定不同倍速播放,并开启镜像和硬件加速。
完整能力,请参见 播放器SDK - 能力清单

播放器配置接口

API
描述
点播配置,配置信息请参见 TXVodPlayConfig
startVodPlay 后是否立即播放,默认 YES。
加密 HLS 的 token。设置此值后,播放器自动在 URL 中的文件名之前增加 voddrm.token.TOKEN TextureView
是否循环播放 SurfaceView。
视频渲染回调。(仅硬解支持)
设置播放器业务参数,参数格式为<NSString *, id>
setSubtitleStyle
设置字幕样式信息,可在播放后对字幕样式进行更新(播放器高级版本才支持)。

播放基础接口

API
描述
播放 HTTP URL 形式地址。
10.7版本开始,startPlay 变更为 startVodPlay,需要通过 {@link TXLiveBase#setLicence} 设置 Licence 后方可成功播放, 否则将播放失败(黑屏),全局仅设置一次即可。
直播 Licence、短视频 Licence 和播放器 Licence 均可使用,若您暂未获取上述 Licence ,快速免费申请测试版 Licence 可正常播放,正式版 License 需 购买
启动一个标准 Fairplay drm 播放。
以 fileId 形式播放。
10.7版本开始,startPlayWithParams 变更为 startVodPlayWithParams,需要通过 {@link TXLiveBase#setLicence} 设置 Licence 后方可成功播放, 否则将播放失败(黑屏),全局仅设置一次即可。
直播 Licence、短视频 Licence 和播放器 Licence 均可使用,若您暂未获取上述 Licence ,快速免费申请测试版 Licence 可正常播放,正式版 License 需 购买
停止播放。
是否正在播放。
暂停播放,停止获取流数据,保留最后一帧画面。
恢复播放,重新获取流数据。
跳转到视频流指定时间点,单位秒。
获取当前播放位置,单位秒。
获取总时长,单位秒。
获取可播放时长,单位秒。
获取视频宽度。
获取视频高度。
设置播放开始时间。
创建 Video 渲染 View,该控件承载着视频内容的展示。
移除 Video 渲染 View。
添加外挂字幕(播放器高级版本才支持)。
返回字幕轨道信息列表(播放器高级版本才支持)。
返回音频轨道信息列表(播放器高级版本才支持)。
选择轨道(播放器高级版本才支持)。
取消选择轨道(播放器高级版本才支持)。
seekToPdtTime
跳转到视频流指定 PDT(Program Date Time )时间点,可实现视频快进、快退、进度条跳转等功能,目前只支持 HLS 视频格式。(播放器高级版 11.6 版本开始支持)。 参数单位毫秒(ms)。

视频相关接口

API
描述
获取当前视频帧图像。
注意:由于获取当前帧图像是比较耗时的操作,所以截图会通过异步回调出来。
设置镜像。
设置点播的播放速率,默认1.0。
返回当前播放的码率索引。
设置当前正在播放的码率索引,无缝切换清晰度。
清晰度切换可能需要等待一小段时间。
当播放地址为 master playlist,返回支持的码率(清晰度)。
进入画中画功能。
退出画中画功能。

音频相关接口

API
描述
设置是否静音播放。
设置音量大小,范围:0 - 100。

事件通知接口

API
描述
事件回调,建议使用 vodDelegate
设置播放器的回调。
视频渲染回调(软硬解都支持)。

TRTC 相关接口

通过以下接口,可以把点播播放器的音视频流通过 TRTC 进行推送,更多 TRTC 服务请参见 TRTC 产品概述
API
描述
点播绑定到 TRTC 服务。
点播解绑 TRTC 服务。
开始推送视频流。
取消推送视频流。
开始推送音频流。
取消推送音频流。

类方法

API
描述
获取加固加密播放密钥。
是否支持 Picture In Picture功能(“画中画”功能)。

TXVodPlayListener

腾讯云点播回调通知。

SDK 基础回调

TXVodPlayConfig

点播播放器配置类。

基础配置接口

API
描述
设置播放器重连次数。
设置播放器重连间隔,单位秒。
设置播放器连接超时时间,单位秒。
此接口已废弃,推荐使用 TXPlayerGlobalSetting##setCacheFolderPath
设置点播缓存目录,点播 MP4、HLS 有效。
此接口已废弃,推荐使用 TXPlayerGlobalSetting#setMaxCacheSizeMB
设置缓存文件个数。
设置播放器类型: 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

下载错误码,详细信息请参见 TXDownloadError
枚举值
含义说明
TXDownloadSuccess
下载成功。
TXDownloadAuthFaild
fileid 鉴权失败。
TXDownloadNoFile
无此清晰度文件。
TXDownloadFormatError
格式不支持。
TXDownloadDisconnet
网络断开。
TXDownloadHlsKeyError
获取 HLS 解密 key 失败。
TXDownloadPathError
下载目录访问失败。

TXVodDownloadMediaInfoState

下载状态,详细信息请参见 TXVodDownloadMediaInfoState
枚举值
含义说明
TXVodDownloadMediaInfoStateInit
下载初始态。
TXVodDownloadMediaInfoStateStart
下载开始。
TXVodDownloadMediaInfoStateStop
下载停止。
TXVodDownloadMediaInfoStateError
下载出错。
TXVodDownloadMediaInfoStateFinish
下载完成。

TXVodQuality

下载视频的清晰度,详细信息请参见 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 播放加密视频配置。
API
描述
应用 appId。
文件 ID。
加密链接超时时间戳。
试看时长。
唯一标识请求。
防盗链签名。
https
是否用 https 协议进行CGI请求,默认为NO

TXBitrateItem

HLS 多码率信息。
API
描述
m3u8 文件中的序号。
此流的视频宽度。
此流的视频高度。
此流的视频码率。

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_FIRST_VIDEO_PACKET
收到首帧数据。
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。