LiteAVSDK
腾讯云音视频 SDK ,服务于数万家企业客户的高可用组件,致力于最大限度地节省您的研发成本。
TXVodPlayConfig

详细描述

腾讯云点播播放器的参数配置模块 主要负责 TXVodPlayer 对应的参数设置,其中绝大多数设置项在播放开始之后再设置是无效的。

变量

const NSInteger INDEX_AUTO
 

结构体说明

◆ TXVodPlayConfig

class TXVodPlayConfig

属性

int connectRetryCount
 
int connectRetryInterval
 
NSTimeInterval timeout
 
OSType playerPixelFormatType
 
BOOL keepLastFrameWhenStop
 
int firstStartPlayBufferTime
 
int nextStartPlayBufferTime
 
NSString * cacheFolderPath
 
int maxCacheItems
 
NSInteger playerType
 
NSDictionary * headers
 
BOOL enableAccurateSeek
 
BOOL autoRotate
 
BOOL smoothSwitchBitrate
 
NSTimeInterval progressInterval
 
int maxBufferSize
 
int maxPreloadSize
 
NSString * overlayKey
 
NSString * overlayIv
 
BOOL enableRenderProcess
 
long preferredResolution
 
TX_Enum_MediaType mediaType
 
NSDictionary * extInfoMap
 

属性说明

◆ autoRotate

- (BOOL) autoRotate
readwritenonatomicassign

播放 MP4 文件时,若设为YES则根据文件中的旋转角度自动旋转。旋转角度可在 EVT_VIDEO_CHANGE_ROTATION 事件中获得。默认 YES

◆ cacheFolderPath

- (NSString*) cacheFolderPath
readwritenonatomiccopy

视频缓存目录,点播MP4、HLS有效

注解
缓存目录应该是单独的目录,SDK可能会清掉其中的文件
弃用:
此接口已废弃,推荐使用TXPlayerGlobalSetting##setCacheFolderPath

◆ connectRetryCount

- (int) connectRetryCount
readwritenonatomicassign

播放器连接重试次数:最小值为1,最大值为10,默认值为 3

◆ connectRetryInterval

- (int) connectRetryInterval
readwritenonatomicassign

播放器连接重试间隔:单位秒,最小值为3, 最大值为30,默认值为 3

◆ enableAccurateSeek

- (BOOL) enableAccurateSeek
readwritenonatomicassign

是否精确 seek,默认 YES。开启精确后 seek,seek 的时间平均多出 200ms

◆ enableRenderProcess

- (BOOL) enableRenderProcess
readwritenonatomicassign

显示处理标志位 设置Render 显示后处理标志位,包含超分等功能,使用这些功能需要设置此标志位,默认不使用

◆ extInfoMap

- (NSDictionary*) extInfoMap
readwritenonatomicstrong

设置一些不必周知的特殊配置

◆ firstStartPlayBufferTime

- (int) firstStartPlayBufferTime
readwritenonatomicassign

首缓需要加载的数据时长,单位 ms, 默认值为 100ms

◆ headers

- (NSDictionary*) headers
readwritenonatomicstrong

自定义 HTTP Headers

◆ keepLastFrameWhenStop

- (BOOL) keepLastFrameWhenStop
readwritenonatomicassign

stopPlay 的时候是否保留最后一帧画面,默认值为 NO

◆ maxBufferSize

- (int) maxBufferSize
readwritenonatomicassign

最大预加载大小,单位 MB 此设置会影响playableDuration,设置越大,提前缓存的越多

◆ maxCacheItems

- (int) maxCacheItems
readwritenonatomicassign

最多缓存文件个数

弃用:
此接口已废弃,推荐使用{@linkTXPlayerGlobalSetting#setMaxCacheSizeMB}

◆ maxPreloadSize

- (int) maxPreloadSize
readwritenonatomicassign

设置预加载最大缓冲大小,单位:MB

◆ mediaType

- (TX_Enum_MediaType) mediaType
readwritenonatomicassign

设置媒资类型

注解
若自适应码率播放,暂须指定具体类型,如自适应播放HLS直播资源,须传入MEDIA_TYPE_HLS_LIVE类型

◆ nextStartPlayBufferTime

- (int) nextStartPlayBufferTime
readwritenonatomicassign

缓冲时(缓冲数据不够引起的二次缓冲,或者seek引起的拖动缓冲)最少要缓存多长的数据才能结束缓冲,单位ms,默认值为250ms

◆ overlayIv

- (NSString*) overlayIv
readwritenonatomiccopy

加密Iv

◆ overlayKey

- (NSString*) overlayKey
readwritenonatomiccopy

加密 key

◆ playerPixelFormatType

- (OSType) playerPixelFormatType
readwritenonatomicassign

视频渲染对象回调的视频格式。支持 kCVPixelFormatType_32BGRA、kCVPixelFormatType_420YpCbCr8BiPlanarFullRange、kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange

◆ playerType

- (NSInteger) playerType
readwritenonatomicassign

播放器类型

◆ preferredResolution

- (long) preferredResolution
readwritenonatomicassign

Hls 多 Program 时,根据设定的 preferredResolution 选最优的Program进行起播,preferredResolution是宽高的乘积 配置有效值为 >=-1 的整形数,缺省为-1播放内核理解为应使用优先级更低的信息进行配置,会从小于该值的program中匹配算数距离最接近的 优先级为 bitrateIndex > mPreferredBitrate > mPreferredResolution

◆ progressInterval

- (NSTimeInterval) progressInterval
readwritenonatomicassign

设置进度回调间隔时间,若不设置,SDK默认间隔0.5秒回调一次

◆ smoothSwitchBitrate

- (BOOL) smoothSwitchBitrate
readwritenonatomicassign

平滑切换码率。默认NO

◆ timeout

- (NSTimeInterval) timeout
readwritenonatomicassign

超时时间:单位秒,默认 10s

枚举类型说明

◆ TX_Enum_MediaType

enum TX_Enum_MediaType : NSInteger

媒资类型( 使用自适应码率播放功能时需设定具体HLS码流是点播/直播媒资,暂时不支持Auto类型)

枚举值
MEDIA_TYPE_AUTO 

AUTO类型(默认值,自适应码率播放暂不支持)

MEDIA_TYPE_HLS_VOD 

自适应码率播放 HLS 点播媒资

MEDIA_TYPE_HLS_LIVE 

自适应码率播放 HLS 直播媒资

◆ TX_Enum_PlayerType

enum TX_Enum_PlayerType : NSInteger

播放器类型定义

枚举值
PLAYER_AVPLAYER 

基于系统播放器

PLAYER_THUMB_PLAYER 

基于FFmepg,支持软解,兼容性更好

◆ TX_Enum_VideoResolution

enum TX_Enum_VideoResolution : NSInteger

播放器偏好分辨率选择,常见的分辨率width * height值,用于preferredResolution 的赋值

枚举值
VIDEO_RESOLUTION_720X1280 

RESOLUTION 720X1280

VIDEO_RESOLUTION_1080X1920 

RESOLUTION 1080X1920

VIDEO_RESOLUTION_1440X2560 

RESOLUTION 1440X2560

VIDEO_RESOLUTION_2160X3840 

RESOLUTION 2160X3840

变量说明

◆ INDEX_AUTO

const NSInteger INDEX_AUTO

自适应码率 'bitrate index' 参数设置