TXPlayerAuthParams

最近更新时间:2025-05-26 18:16:22

我的收藏

TXPlayerAuthParams API 简介

点播播放器播放媒资参数, 通过 TXPlayInfoParams 可以配置腾讯云 fileId 和 URL 播放。

接口概览

API
描述
appId
应用 appId。
fileId
视频文件 ID。
timeout
加密链接超时时间戳。
exper
试看时长。
us
唯一标识请求。
sign
防盗链签名。
https
是否用 HTTPS 请求。
url
视频文件 URL。
mediaType
媒资类型。
MP4加密等级。
headers
HTTP 头。
预下载的音轨名称。

接口详情

appId

应用 ID。如果不设置 URL 该字段必填。
@property(nonatomic, assign) int appId;

fileId

视频文件 ID。如果不设置 URL 该字段必填。
@property(nonatomic, copy) NSString *fileId;

timeout

加密链接超时时间戳。可选,会转换为十六进制小写字符串,CDN 服务器会根据该时间戳判断链接是否有效。
@property(nonatomic, copy) NSString *fileId;

exper

预览时长(以秒为单位),可选。
@property(nonatomic, assign) int exper;

us

唯一标识请求,增加链接唯一性。
@property(nonatomic, copy) NSString *us;

sign

防盗链。若不使用防盗链,此参数留空。播放器 API 使用的防盗链参数(t、us、exper)与 CDN 一致,区别仅在于 sign 的计算方式。
通用防盗链签名:sign = md5(KEY+appId+fileId+t+us)。
预览版防盗链签名:sign = md5(KEY+appId+fileId+t+exper+us)。
@property(nonatomic, copy) NSString *sign;

https

是否使用 HTTPS 请求,默认为 NO。
@property(nonatomic, assign) BOOL https;

url

视频 URL。
@property(nonatomic, copy) NSString *url;

mediaType

媒体类型。默认为 MEDIA_TYPE_AUTO。
@property(nonatomic, assign) TX_Enum_MediaType mediaType;
参数说明
参数名
类型
描述
mediaType
设置媒资类型,默认为 auto 类型。

encryptedMp4Level

设置 MP4 播放的加密等级。
@property(nonatomic, assign) TX_Enum_MP4EncryptionLevel encryptedMp4Level;
参数说明
参数名
类型
描述
encryptedMp4Level
设置 MP4 播放和存储加密等级,从播放器高级版12.2 版本开始支持。

headers

自定义配置播放器播放联网过程中携带的 Http header。
@property(nonatomic, strong) NSDictionary *headers;

preferAudioTrack

设置启播时优先使用的音轨。在预下载场景,则配置优先下载音轨。
说明:
播放器高级版本 12.3 版本开始支持。
@property(nonatomic, copy) NSString *preferAudioTrack;
参数说明
参数名
类型
描述
preferAudioTrack
NSString
音轨名称。