类型定义

最近更新时间:2024-10-09 10:20:51

我的收藏
Copyright (c) 2021 Tencent. All rights reserved.

Module: V2TXLiveDef @ TXLiteAVSDK

Function: 腾讯云直播服务(LVB)关键类型定义

类型定义

结构体类型

函数列表
描述
视频编码参数
视频帧信息
音频帧数据
音频帧回调格式
推流器的统计数据
播放器的统计数据
云端混流中每一路子画面的位置信息
云端混流(转码)配置
本地录制音视频配置
socks5 代理的协议配置
Log配置
支持自适应切换的码流信息

枚举类型

枚举类型
描述
支持协议
视频分辨率
视频宽高比模式
本地摄像头镜像类型
视频画面填充模式
视频画面顺时针旋转角度
视频帧的像素格式
视频数据包装格式
画中画的状态
声音音质
音频回调数据读写模式
直播流的连接状态
声音播放模式(音频路由)
混流输入类型配置
本地音视频录制模式
日志级别枚举值

V2TXLiveMode

V2TXLiveMode

支持协议

枚举
取值
描述
V2TXLiveMode_RTMP
Not Defined
支持协议: RTMP。
V2TXLiveMode_RTC
Not Defined
支持协议: TRTC。

V2TXLiveVideoResolution

V2TXLiveVideoResolution

视频分辨率

枚举
取值
描述
V2TXLiveVideoResolution160x160
Not Defined
分辨率 160*160,码率范围:100Kbps ~ 150Kbps,帧率:15fps。
V2TXLiveVideoResolution270x270
Not Defined
分辨率 270*270,码率范围:200Kbps ~ 300Kbps,帧率:15fps。
V2TXLiveVideoResolution480x480
Not Defined
分辨率 480*480,码率范围:350Kbps ~ 525Kbps,帧率:15fps。
V2TXLiveVideoResolution320x240
Not Defined
分辨率 320*240,码率范围:250Kbps ~ 375Kbps,帧率:15fps。
V2TXLiveVideoResolution480x360
Not Defined
分辨率 480*360,码率范围:400Kbps ~ 600Kbps,帧率:15fps。
V2TXLiveVideoResolution640x480
Not Defined
分辨率 640*480,码率范围:600Kbps ~ 900Kbps,帧率:15fps。
V2TXLiveVideoResolution320x180
Not Defined
分辨率 320*180,码率范围:250Kbps ~ 400Kbps,帧率:15fps。
V2TXLiveVideoResolution480x270
Not Defined
分辨率 480*270,码率范围:350Kbps ~ 550Kbps,帧率:15fps。
V2TXLiveVideoResolution640x360
Not Defined
分辨率 640*360,码率范围:500Kbps ~ 900Kbps,帧率:15fps。
V2TXLiveVideoResolution960x540
Not Defined
分辨率 960*540,码率范围:800Kbps ~ 1500Kbps,帧率:15fps。
V2TXLiveVideoResolution1280x720
Not Defined
分辨率 1280*720,码率范围:1000Kbps ~ 1800Kbps,帧率:15fps。
V2TXLiveVideoResolution1920x1080
Not Defined
分辨率 1920*1080,码率范围:2500Kbps ~ 3000Kbps,帧率:15fps。

V2TXLiveVideoResolutionMode

V2TXLiveVideoResolutionMode

视频宽高比模式

注意
横屏模式下的分辨率: V2TXLiveVideoResolution640x360 + V2TXLiveVideoResolutionModeLandscape = 640 × 360。
竖屏模式下的分辨率: V2TXLiveVideoResolution640x360 + V2TXLiveVideoResolutionModePortrait = 360 × 640。
枚举
取值
描述
V2TXLiveVideoResolutionModeLandscape
0
横屏模式。
V2TXLiveVideoResolutionModePortrait
1
竖屏模式。

V2TXLiveMirrorType

V2TXLiveMirrorType

本地摄像头镜像类型

枚举
取值
描述
V2TXLiveMirrorTypeAuto
Not Defined
系统默认镜像类型,前置摄像头镜像,后置摄像头不镜像。
V2TXLiveMirrorTypeEnable
Not Defined
前置摄像头和后置摄像头,都切换为镜像模式。
V2TXLiveMirrorTypeDisable
Not Defined
前置摄像头和后置摄像头,都切换为非镜像模式。

V2TXLiveFillMode

V2TXLiveFillMode

视频画面填充模式

枚举
取值
描述
V2TXLiveFillModeFill
Not Defined
图像铺满屏幕,超出显示视窗的视频部分将被裁剪,画面显示可能不完整。
V2TXLiveFillModeFit
Not Defined
图像长边填满屏幕,短边区域会被填充黑色,画面的内容完整。
V2TXLiveFillModeScaleFill
Not Defined
图像拉伸铺满,因此长度和宽度可能不会按比例变化。

V2TXLiveRotation

V2TXLiveRotation

视频画面顺时针旋转角度

枚举
取值
描述
V2TXLiveRotation0
Not Defined
不旋转。
V2TXLiveRotation90
Not Defined
顺时针旋转90度。
V2TXLiveRotation180
Not Defined
顺时针旋转180度。
V2TXLiveRotation270
Not Defined
顺时针旋转270度。

V2TXLivePixelFormat

V2TXLivePixelFormat

视频帧的像素格式

枚举
取值
描述
V2TXLivePixelFormatUnknown
Not Defined
未知。
V2TXLivePixelFormatI420
Not Defined
YUV420P I420。
V2TXLivePixelFormatNV12
Not Defined
YUV420SP NV12。
V2TXLivePixelFormatBGRA32
Not Defined
BGRA8888。
V2TXLivePixelFormatTexture2D
Not Defined
OpenGL 2D 纹理。

V2TXLiveBufferType

V2TXLiveBufferType

视频数据包装格式

注意
在自定义采集和自定义渲染功能,您需要用到下列枚举值来指定您希望以什么样的格式来包装视频数据。
PixelBuffer:直接使用效率最高,iOS 系统提供了众多 API 获取或处理 PixelBuffer。
NSData: 当使用自定义渲染时,PixelBuffer拷贝一次到NSData。当使用自定义采集时,NSData拷贝一次到PixelBuffer。因此,性能会受到一定程度的影响。
枚举
取值
描述
V2TXLiveBufferTypeUnknown
Not Defined
未知。
V2TXLiveBufferTypePixelBuffer
Not Defined
直接使用效率最高,iOS 系统提供了众多 API 获取或处理 PixelBuffer。
V2TXLiveBufferTypeNSData
Not Defined
会有一定的性能消耗,SDK 内部是直接处理 PixelBuffer 的,所以会存在 NSData 和 PixelBuffer 之间类型转换所产生的内存拷贝开销。
V2TXLiveBufferTypeTexture
Not Defined
直接操作纹理 ID,性能最好。

V2TXLivePictureInPictureState

V2TXLivePictureInPictureState

画中画的状态

枚举
取值
描述
V2TXLivePictureInPictureStateUndefined
Not Defined
未定义。
V2TXLivePictureInPictureStateOccurError
Not Defined
画中画发生错误。
V2TXLivePictureInPictureStateWillStart
Not Defined
画中画将要开始。
V2TXLivePictureInPictureStateDidStart
Not Defined
画中画已经开始。
V2TXLivePictureInPictureStateWillStop
Not Defined
画中画将要停止。
V2TXLivePictureInPictureStateDidStop
Not Defined
画中画已经停止。
V2TXLivePictureInPictureStateRestoreUI
Not Defined
画中画恢复用户界面。

V2TXLiveAudioQuality

V2TXLiveAudioQuality

声音音质

枚举
取值
描述
V2TXLiveAudioQualitySpeech
Not Defined
语音音质:采样率:16k;单声道;音频码率:16kbps;适合语音通话为主的场景,比如在线会议,语音通话。
V2TXLiveAudioQualityDefault
Not Defined
默认音质:采样率:48k;单声道;音频码率:50kbps;SDK 默认的音频质量,如无特殊需求推荐选择之。
V2TXLiveAudioQualityMusic
Not Defined
音乐音质:采样率:48k;双声道 + 全频带;音频码率:128kbps;适合需要高保真传输音乐的场景,比如K歌、音乐直播等。

V2TXLiveAudioFrameOperationMode

V2TXLiveAudioFrameOperationMode

音频回调数据读写模式

SDK 提供了两种音频回调数据的操作模式。
读写模式(ReadWrite):可以获取并修改回调的音频数据,默认模式。
只读模式(ReadOnly):仅从回调中获取音频数据。
枚举
取值
描述
V2TXLiveAudioFrameOperationModeReadWrite
0
读写模式:可以获取并修改回调的音频数据。
V2TXLiveAudioFrameOperationModeReadOnly
1
只读模式:仅从回调中获取音频数据。

V2TXLivePushStatus

V2TXLivePushStatus

直播流的连接状态

枚举
取值
描述
V2TXLivePushStatusDisconnected
Not Defined
与服务器断开连接。
V2TXLivePushStatusConnecting
Not Defined
正在连接服务器。
V2TXLivePushStatusConnectSuccess
Not Defined
连接服务器成功。
V2TXLivePushStatusReconnecting
Not Defined
重连服务器中。

V2TXAudioRoute

V2TXAudioRoute

声音播放模式(音频路由)

枚举
取值
描述
V2TXAudioModeSpeakerphone
Not Defined
扬声器。
V2TXAudioModeEarpiece
Not Defined
听筒。

V2TXLiveMixInputType

V2TXLiveMixInputType

混流输入类型配置

枚举
取值
描述
V2TXLiveMixInputTypeAudioVideo
Not Defined
混入音视频。
V2TXLiveMixInputTypePureVideo
Not Defined
只混入视频。
V2TXLiveMixInputTypePureAudio
Not Defined
只混入音频。

V2TXLiveRecordMode

V2TXLiveRecordMode

本地音视频录制模式

枚举
取值
描述
V2TXLiveRecordModeBoth
Not Defined
Both mode: 录制音频和视频

V2TXLiveLogLevel

V2TXLiveLogLevel

日志级别枚举值

枚举
取值
描述
V2TXLiveLogLevelAll
0
输出所有级别的 log。
V2TXLiveLogLevelDebug
1
输出 DEBUG,INFO,WARNING,ERROR 和 FATAL 级别的 log。
V2TXLiveLogLevelInfo
2
输出 INFO,WARNING,ERROR 和 FATAL 级别的 log。
V2TXLiveLogLevelWarning
3
只输出 WARNING,ERROR 和 FATAL 级别的 log。
V2TXLiveLogLevelError
4
只输出 ERROR 和 FATAL 级别的 log。
V2TXLiveLogLevelFatal
5
只输出 FATAL 级别的 log。
V2TXLiveLogLevelNULL
6
不输出任何 sdk log。

V2TXLiveVideoEncoderParam

V2TXLiveVideoEncoderParam

视频编码参数

该设置决定远端用户看到的画面质量。
枚举类型
描述
minVideoBitrate
【字段含义】最低视频码率,SDK 会在网络不佳的情况下主动降低视频码率以保持流畅度,最低会降至 minVideoBitrate 所设定的数值。
【推荐取值】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数,用于约束 SDK 对视频码率的调整范围:
如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值,等价于关闭 SDK 对视频码率的自适应调节能力。
videoBitrate
【字段含义】目标视频码率,SDK 会按照目标码率进行编码,只有在弱网络环境下才会主动降低视频码率。
【推荐取值】请参考 V2TXLiveVideoResolution 在各档位注释的最佳码率,也可以在此基础上适当调高。
比如:V2TXLiveVideoResolution1280x720 对应 1200kbps 的目标码率,您也可以设置为 1500kbps 用来获得更好的观感清晰度。
【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数,用于约束 SDK 对视频码率的调整范围:
如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值,等价于关闭 SDK 对视频码率的自适应调节能力。
videoFps
【字段含义】视频采集帧率。
【推荐取值】15fps 或 20fps。5fps 以下,卡顿感明显。10fps 以下,会有轻微卡顿感。20fps 以上,会浪费带宽(电影的帧率为 24fps)。
videoResolution
【字段含义】 视频分辨率。
【特别说明】如需使用竖屏分辨率,请指定 videoResolutionMode 为 Portrait,例如: 640 × 360 + Portrait = 360 × 640。
【推荐取值】
桌面平台(Win + Mac):建议选择 640 × 360 及以上分辨率,videoResolutionMode 选择 Landscape,即横屏分辨率。
videoResolutionMode
【字段含义】分辨率模式(横屏分辨率 or 竖屏分辨率)。
【推荐取值】桌面平台(Windows、Mac)建议选择 Landscape。
【特别说明】如需使用竖屏分辨率,请指定 resMode 为 Portrait,例如: 640 × 360 + Portrait = 360 × 640。

V2TXLiveVideoFrame

V2TXLiveVideoFrame

视频帧信息

注意
自定义采集和自定义渲染时使用。自定义采集时,需要使用 V2TXLiveVideoFrame 来包装待发送的视频帧;自定义渲染时,会返回经过 V2TXLiveVideoFrame 包装的视频帧。
枚举类型
描述
bufferType
【字段含义】视频数据包装格式。
【推荐取值】V2TXLiveBufferTypePixelBuffer。
data
【字段含义】bufferType 为 V2TXLiveBufferTypeNSData 时的视频数据。
height
【字段含义】视频高度。
pixelBuffer
【字段含义】bufferType 为 V2TXLiveBufferTypePixelBuffer 时的视频数据。
pixelFormat
【字段含义】视频帧像素格式。
【推荐取值】V2TXLivePixelFormatNV12。
rotation
【字段含义】视频帧的顺时针旋转角度。
textureId
【字段含义】视频纹理ID。
width
【字段含义】视频宽度。

V2TXLiveAudioFrame

V2TXLiveAudioFrame

音频帧数据

枚举类型
描述
channel
【字段含义】声道数。
data
【字段含义】音频数据。
sampleRate
【字段含义】采样率。
timestamp
【字段含义】时间戳,单位ms。

V2TXLiveAudioFrameObserverFormat

V2TXLiveAudioFrameObserverFormat

音频帧回调格式

枚举类型
描述
channel
【字段含义】声道数。
【推荐取值】默认值:1,代表单声道。可设定的数值只有两个数字:1-单声道,2-双声道。
mode
【字段含义】回调数据读写模式。
【推荐取值】V2TXLiveAudioFrameOperationModeReadOnly:仅从回调中获取音频数据。可设定的模式有 V2TXLiveAudioFrameOperationModeReadOnly,V2TXLiveAudioFrameOperationModeReadWrite。
sampleRate
【字段含义】采样率。
【推荐取值】默认值:48000Hz。支持 16000, 32000, 44100, 48000。
samplesPerCall
【字段含义】采样点数。
【推荐取值】取值必须是 sampleRate/100 的整数倍。

V2TXLivePusherStatistics

V2TXLivePusherStatistics

推流器的统计数据

枚举类型
描述
appCpu
【字段含义】当前 App 的 CPU 使用率(%)。
audioBitrate
【字段含义】音频码率(Kbps)。
fps
【字段含义】帧率(fps)。
height
【字段含义】视频高度。
netSpeed
【字段含义】上行速度(kbps)
rtt
【字段含义】从 SDK 到云端的往返延时(ms)
systemCpu
【字段含义】当前系统的 CPU 使用率(%)。
videoBitrate
【字段含义】视频码率(Kbps)。
width
【字段含义】视频宽度。

V2TXLivePlayerStatistics

V2TXLivePlayerStatistics

播放器的统计数据

枚举类型
描述
appCpu
【字段含义】当前 App 的 CPU 使用率(%)。
audioBitrate
【字段含义】音频码率(Kbps)。
audioBlockRate
【字段含义】音频播放卡顿率,单位(%)。
音频播放卡顿率(audioBlockRate) = 音频播放的累计卡顿时长(audioTotalBlockTime) / 音频播放的区间时长(2000ms)。
audioPacketLoss
【字段含义】网络音频丢包率(%),注:仅支持前缀为 [trtc://][webrtc://] 的播放地址。
audioTotalBlockTime
【字段含义】音频播放的累计卡顿时长(ms)。
该时长为区间(2s)内的卡顿时长。
fps
【字段含义】帧率(fps)。
height
【字段含义】视频高度。
jitterBufferDelay
【字段含义】播放延迟(ms)。
netSpeed
【字段含义】下载速度(kbps)
rtt
【字段含义】从 SDK 到云端的往返延时(ms),注:仅支持前缀为 [trtc://][webrtc://] 的播放地址。
systemCpu
【字段含义】当前系统的 CPU 使用率(%)。
videoBitrate
【字段含义】视频码率(Kbps)。
videoBlockRate
【字段含义】视频播放卡顿率,单位(%)。
视频播放卡顿率(videoBlockRate) = 视频播放的累计卡顿时长(videoTotalBlockTime) / 视频播放的区间时长(2000ms)。
videoPacketLoss
【字段含义】网络视频丢包率(%),注:仅支持前缀为 [trtc://][webrtc://] 的播放地址。
videoTotalBlockTime
【字段含义】视频播放的累计卡顿时长(ms)。
该时长为区间(2s)内的卡顿时长。
width
【字段含义】视频宽度。

V2TXLiveMixStream

V2TXLiveMixStream

云端混流中每一路子画面的位置信息

枚举类型
描述
height
【字段含义】图层位置高度(绝对像素值)。
inputType
【字段含义】该直播流的输入类型。
streamId
【字段含义】参与混流的 userId 所在对应的推流 streamId,nil 表示当前推流 streamId。
userId
【字段含义】参与混流的 userId。
width
【字段含义】图层位置宽度(绝对像素值)。
x
【字段含义】图层位置 x 坐标(绝对像素值)。
y
【字段含义】图层位置 y 坐标(绝对像素值)。
zOrder
【字段含义】图层层次(1 - 15)不可重复。

V2TXLiveTranscodingConfig

V2TXLiveTranscodingConfig

云端混流(转码)配置

枚举类型
描述
audioBitrate
【字段含义】最终转码后的音频码率。
【推荐取值】默认值:64kbps,取值范围是 [32,192],单位:kbps。
audioChannels
【字段含义】最终转码后的音频声道数。
【推荐取值】默认值:1。取值范围为 [1,2] 中的整型。
audioSampleRate
【字段含义】最终转码后的音频采样率。
【推荐取值】默认值:48000Hz。支持12000HZ、16000HZ、22050HZ、24000HZ、32000HZ、44100HZ、48000HZ。
backgroundColor
【字段含义】混合后画面的底色颜色,默认为黑色,格式为十六进制数字,比如:“0x61B9F1” 代表 RGB 分别为(97,158,241)。
【推荐取值】默认值:0x000000,黑色。
backgroundImage
【字段含义】混合后画面的背景图。
【推荐取值】默认值:nil,即不设置背景图。
【特别说明】背景图需要您事先在 “控制台 => 应用管理 => 功能配置 => 素材管理” 中上传,
上传成功后可以获得对应的“图片ID”,然后将“图片ID”转换成字符串类型并设置到 backgroundImage 里即可。
例如:假设“图片ID” 为 63,可以设置 backgroundImage = "63"。
mixStreams
【字段含义】每一路子画面的位置信息。
outputStreamId
【字段含义】输出到 CDN 上的直播流 ID。
如不设置该参数,SDK 会执行默认逻辑,即房间里的多路流会混合到该接口调用者的视频流上,也就是 A + B => A。
如果设置该参数,SDK 会将房间里的多路流混合到您指定的直播流 ID 上,也就是 A + B => C。
【推荐取值】默认值:nil,即房间里的多路流会混合到该接口调用者的视频流上。
videoBitrate
【字段含义】最终转码后的视频分辨率的码率(kbps)。
【推荐取值】如果填0,后台会根据 videoWidth 和 videoHeight 来估算码率,您也可以参考枚举定义 V2TXLiveVideoResolution 的注释。
videoFramerate
【字段含义】最终转码后的视频分辨率的帧率(FPS)。
【推荐取值】默认值:15fps,取值范围是 (0,30]。
videoGOP
【字段含义】最终转码后的视频分辨率的关键帧间隔(又称为 GOP)。
【推荐取值】默认值:2,单位为秒,取值范围是 [1,8]
videoHeight
【字段含义】最终转码后的视频分辨率的高度。
【推荐取值】推荐值:640px,如果你是纯音频推流,请将 width × height 设为 0px × 0px,否则混流后会携带一条画布背景的视频流。
videoWidth
【字段含义】最终转码后的视频分辨率的宽度。
【推荐取值】推荐值:360px,如果你是纯音频推流,请将 width × height 设为 0px × 0px,否则混流后会携带一条画布背景的视频流。

V2TXLiveLocalRecordingParams

V2TXLiveLocalRecordingParams

本地录制音视频配置

枚举类型
描述
filePath
【字段含义】录制的文件地址(必填),请确保路径有读写权限且合法,否则录制文件无法生成。
【推荐取值】该路径需精确到文件名及格式后缀,格式后缀用于决定录制出的文件格式,目前支持的格式暂时只有 MP4。
interval
【字段含义】interval 录制信息更新频率,单位毫秒,有效范围:1000-10000。
【推荐取值】 -1 , 表示不回调。
recordMode
【字段含义】媒体录制模式。
【推荐取值】 V2TXLiveRecordModeBoth , 即同时录制音频和视频。

V2TXLiveSocks5ProxyConfig

V2TXLiveSocks5ProxyConfig

socks5 代理的协议配置

枚举类型
描述
supportHttps
【字段含义】是否支持 https。
【推荐取值】默认值:true。
supportTcp
【字段含义】是否支持 tcp。
【推荐取值】默认值:true。
supportUdp
【字段含义】是否支持 udp。
【推荐取值】默认值:true。

V2TXLiveLogConfig

V2TXLiveLogConfig

Log配置

枚举类型
描述
enableConsole
【字段含义】是否允许 SDK 在编辑器(XCoder、Android Studio、Visual Studio 等)的控制台上打印 Log。
【推荐取值】默认值:NO。
enableLogFile
【字段含义】是否启用本地 Log 文件。
【特殊说明】如非特殊需要,请不要关闭本地 Log 文件,否则腾讯云技术团队将无法在出现问题时进行跟踪和定位。
【推荐取值】默认值:YES。
enableObserver
【字段含义】是否通过 V2TXLivePremierObserver 接收要打印的 Log 信息。
【特殊说明】如果您希望自己实现 Log 写入,可以打开此开关,Log 信息会通过 V2TXLivePremierObserver#onLog 回调给您。
【推荐取值】默认值:NO。
logLevel
【字段含义】设置 Log 级别。
【推荐取值】默认值:V2TXLiveLogLevelAll。
logPath
【字段含义】设置本地 Log 的存储目录,默认 Log 存储位置:
iOS & Mac: sandbox Documents/log。

V2TXLiveStreamInfo

V2TXLiveStreamInfo

支持自适应切换的码流信息

枚举类型
描述
bitrate
【字段含义】 码率, 单位bps, 默认值:0, 表示未知。
framerate
【字段含义】 帧率, 默认值:0, 表示未知。
height
【字段含义】 视频高, 默认值:0, 表示未知。
url
【字段含义】 流地址, 通过 SwitchStream 接口调用实现多码率质量切换。
width
【字段含义】 视频宽, 默认值:0, 表示未知。