V2TXLivePusher

最后更新时间：2022-10-13 11:40:06

V2TXLivePusher

最后更新时间： 2022-10-13 11:40:06

功能
腾讯云直播推流器。
介绍
主要负责将本地的音频和视频画面进行编码，并推送到指定的推流地址，支持任意的推流服务端。
推流器包含如下能力：
自定义的视频采集，让您可以根据项目需要定制自己的音视频数据源。
美颜、滤镜、贴纸，包含多套美颜磨皮算法（自然&光滑）和多款色彩空间滤镜（支持自定义滤镜）。
Qos 流量控制技术，具备上行网络自适应能力，可以根据主播端网络的具体情况实时调节音视频数据量。
脸形调整、动效挂件，支持基于优图 AI 人脸识别技术的大眼、瘦脸、隆鼻等脸形微调以及动效挂件效果，只需要购买优图 License 就可以轻松实现丰富的直播效果。
SDK 基础函数
initWithLiveMode
初始化直播推流器。
- (instancetype)initWithLiveMode:(V2TXLiveMode)liveMode
参数
参数
类型
含义
liveMode
V2TXLiveMode
推流协议类型：RTMP/ROOM 协议，默认值：RTMP。
setObserver
设置推流器回调。通过设置回调，可以监听 V2TXLivePusher 推流器的一些回调事件，包括推流器状态、音量回调、统计数据、警告和错误信息等。
- (void)setObserver:(id<V2TXLivePusherObserver>)observer
参数
参数
类型
含义
observer
V2TXLivePusherObserver
推流器的回调目标对象，更多信息请参见 V2TXLivePusherObserver。
推流基础接口
setRenderView
设置本地摄像头预览 View，本地摄像头采集到的画面，经过美颜、脸形调整、滤镜等多种效果叠加之后，最终会显示到传入的 View 上。
- (V2TXLiveCode)setRenderView:(TXView *)view
参数
参数
类型
含义
view
TXView *
本地摄像头预览 View。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
startPush
开始音视频数据推流。
- (V2TXLiveCode)startPush:(NSString *)url
参数
参数
类型
含义
url
NSString *
推流的目标地址，支持任意推流服务端。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLIVE_ERROR_INVALID_PARAMETER：操作失败，URL 不合法。
V2TXLIVE_ERROR_REFUSED：RTC 不支持同一设备上同时推拉同一个 StreamId。
stopPush
停止推送音视频数据。
- (V2TXLiveCode)stopPush
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
isPushing
当前推流器是否正在推流中。
- (int)isPushing
返回
是否正在播放。
1：正在推流中。
0：已经停止推流。
视频相关接口
setVideoQuality
设置推流视频编码参数。
- (V2TXLiveCode)setVideoQuality:(V2TXLiveVideoEncoderParam *)param;
参数
参数
类型
含义
param
V2TXLiveVideoEncoderParam
视频编码参数。
setRenderRotation
设置本地摄像头预览画面的旋转角度。
- (V2TXLiveCode)setRenderRotation:(V2TXLiveRotation)rotation
参数
参数
类型
含义
rotation
V2TXLiveRotation
旋转角度，默认值：V2TXLiveRotation0。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLiveRotation 枚举值
取值
含义
V2TXLiveRotation0
不旋转。
V2TXLiveRotation90
顺时针旋转90度。
V2TXLiveRotation180
顺时针旋转180度。
V2TXLiveRotation270
顺时针旋转270度。
setRenderMirror
设置本地摄像头预览镜像。
- (V2TXLiveCode)setRenderMirror:(V2TXLiveMirrorType)mirrorType
参数
参数
类型
含义
mirrorType
V2TXLiveMirrorType
摄像头镜像类型，默认值：V2TXLiveMirrorTypeAuto。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLiveMirrorType枚举值
取值
含义
V2TXLiveMirrorTypeAuto
默认镜像类型. 在这种情况下，前置摄像头的画面是镜像的，后置摄像头的画面不是镜像的。
V2TXLiveMirrorTypeEnable
前置摄像头和后置摄像头都切换为镜像模式。
V2TXLiveMirrorTypeDisable
前置摄像头和后置摄像头都切换为非镜像模式。
startCamera
打开本地摄像头。
说明：
startVirtualCamera、startCamera 和 startScreenCapture 同一 Pusher 实例下，仅有一个能上行，三者为覆盖关系。例如先调用 startCamera，后调用 startVirtualCamera。此时表现为暂停摄像头推流，开启图片推流。
- (V2TXLiveCode)startCamera:(BOOL)frontCamera
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
stopCamera
关闭本地摄像头。
- (V2TXLiveCode)stopCamera
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
startVirtualCamera
开启图片推流。
说明：
startVirtualCamera、startCamera 和 startScreenCapture 同一 Pusher 实例下，仅有一个能上行，三者为覆盖关系。例如先调用 startCamera，后调用 startVirtualCamera。此时表现为暂停摄像头推流，开启图片推流。
- (V2TXLiveCode)startVirtualCamera:(TXImage *)image
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
stopVirtualCamera
关闭图片推流。
- (V2TXLiveCode)stopVirtualCamera
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
startScreenCapture
开启屏幕采集。
说明：
iOS 端暂不支持通过此接口开启屏幕采集。
startVirtualCamera、startCamera 和 startScreenCapture 同一 Pusher 实例下，仅有一个能上行，三者为覆盖关系。例如先调用 startCamera，后调用 startVirtualCamera。此时表现为暂停摄像头推流，开启图片推流。
1. 需要通过 iOS Broadcast Upload Extension 来开启屏幕采集。
2. 然后设置 enableCustomVideoCapture 开启自定义采集支持。 
3. 最后通过 sendCustomVideoFrame 把 Broadcast Upload Extension 中采集到的屏幕画面送出去。
- (V2TXLiveCode)startScreenCapture:(NSString *)appGroup
参数
参数
类型
含义
appGroup
NSString *
主 App 与 Broadcast 共享的 Application Group Identifier，可以指定为 nil，但按照文档设置会使功能更加可靠。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
stopScreenCapture
关闭屏幕采集。
- (V2TXLiveCode)stopScreenCapture
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
snapshot
截取推流过程中的本地画面。
说明：
返回值成功后可以在 V2TXLivePusherObserver#onSnapshotComplete:(TXImage *)image 回调中获取截图图片。
- (V2TXLiveCode)snapshot
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLIVE_ERROR_REFUSED：已经停止推流，不允许调用截图操作。
setWatermark
设置推流器水印。默认情况下，水印不开启。
- (V2TXLiveCode)setWatermark:(TXImage *)image x:(float)x y:(float)y scale:(float)scale
参数
参数
类型
含义
image
TXImage *
水印图片。如果该值为null，则等效于禁用水印。
x
float
水印的坐标。
y
float
水印的坐标。
scale
float
水印的缩放比例。
setEncoderMirror
设置视频编码镜像。
- (V2TXLiveCode)setEncoderMirror:(BOOL)mirror
参数
参数
类型
含义
mirror
BOOL
是否镜像。默认值：NO。
enableCustomVideoCapture
开启/关闭自定义视频采集。在自定义视频采集模式下，SDK 不再从摄像头采集图像，只保留编码和发送能力。
- (V2TXLiveCode)enableCustomVideoCapture:(BOOL)enable
参数
参数
类型
含义
enable
BOOL
是否开启自定义采集。默认值：NO。
sendCustomVideoFrame
在自定义视频采集模式下，将采集的视频数据发送到 SDK。
- (V2TXLiveCode)sendCustomVideoFrame:(V2TXLiveVideoFrame *)videoFrame
参数
参数
类型
含义
videoFrame
V2TXLiveVideoFrame *
向 SDK 发送的 视频帧数据。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLIVE_ERROR_INVALID_PARAMETER：发送失败，视频帧数据不合法。
V2TXLIVE_ERROR_REFUSED：发送失败，您必须先调用 enableCustomVideoCapture 开启自定义视频采集。
enableCustomVideoProcess
开启/关闭自定义视频处理。
- (V2TXLiveCode)enableCustomVideoProcess:(BOOL)enable pixelFormat:(V2TXLivePixelFormat)pixelFormat bufferType:(V2TXLiveBufferType)bufferType
参数
参数
类型
含义
enable
BOOL
是否开启自定义视频处理。默认值：NO。
pixelFormat
V2TXLivePixelFormat
视频帧的像素格式。
bufferType
V2TXLiveBufferType
视频数据包装格式。
V2TXLivePixelFormat 枚举值
取值
说明
V2TXLivePixelFormatUnknown
未知。
V2TXLivePixelFormatI420
YUV420P I420。
V2TXLivePixelFormatTexture2D
OpenGL 2D 纹理。
V2TXLiveBufferType 枚举值
取值
说明
V2TXLiveBufferTypeUnknown
未知。
V2TXLiveBufferTypeByteBuffer
DirectBuffer，装载 I420 等 buffer，在 native 层使用。
V2TXLiveBufferTypeByteArray
byte[]，装载 I420 等 buffer，在 Java 层使用。
V2TXLiveBufferTypeTexture
直接操作纹理 ID，性能最好，画质损失最少。
sendSeiMessage
发送 SEI 消息。播放端 V2TXLivePlayer 通过 V2TXLivePlayerObserver 中的 onReceiveSeiMessage 回调来接收该消息。
- (V2TXLiveCode)sendSeiMessage:(int)payloadType data:(NSData *)data;
参数
参数
类型
含义
payloadType
int
数据类型，支持 5、242。推荐填：242
data
NSData *
待发送的数据
返回
 返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
美颜相关接口
getBeautyManager
获取美颜管理对象 TXBeautyManager。
通过美颜管理，您可以使用以下功能：
设置“美颜风格”、“美白”、“红润”、“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“小鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等美容效果。
调整“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”。
设置人脸挂件（素材）等动态效果。
添加美妆。
进行手势识别。
- (TXBeautyManager *)getBeautyManager
音频相关接口
startMicrophone
打开麦克风。
- (V2TXLiveCode)startMicrophone
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
stopMicrophone
关闭麦克风。
- (V2TXLiveCode)stopMicrophone
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
setAudioQuality
设置推流音频质量。
- (V2TXLiveCode)setAudioQuality:(V2TXLiveAudioQuality)quality
参数
参数
类型
含义
quality
V2TXLiveAudioQuality
音频质量。
V2TXLiveAudioQuality 枚举值
取值
说明
V2TXLiveAudioQualitySpeech
语音音质。采样率：16k、单声道、音频码率：16kbps。
适合语音通话为主的场景，例如在线会议，语音通话。
V2TXLiveAudioQualityDefault
默认音质。采样率：48k、单声道、音频码率：50kbps。
SDK 默认的音频质量，如无特殊需求推荐选择之。
V2TXLiveAudioQualityMusic
音乐音质。采样率：48k、双声道 + 全频带、音频码率：128kbps。
适合需要高保真传输音乐的场景，例如 K 歌、音乐直播等。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLIVE_ERROR_REFUSED：推流过程中，不允许调整音质。
enableVolumeEvaluation
启用采集音量大小提示。
说明：
开启后可以在 V2TXLivePusherObserver#onMicrophoneVolumeUpdate:(NSInteger)volume 回调中获取到 SDK 对音量大小值的评估。
- (V2TXLiveCode)enableVolumeEvaluation:(NSInteger)intervalMs;
参数
参数
类型
含义
intervalMs
NSInteger
决定了 onMicrophoneVolumeUpdate 音量大小回调的触发间隔，单位为 ms，最小间隔为 100ms，如果小于等于0则会关闭回调，建议设置为 300ms。默认值：0，不开启。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
音效相关接口
getAudioEffectManager
获取音效管理对象 TXAudioEffectManager。
通过音效管理，您可以使用以下功能：
调整麦克风收集的人声音量。
设置混响和变声效果。
开启耳返，并设置耳返的音量。
添加背景音乐，调整背景音乐的播放效果。
- (TXAudioEffectManager *)getAudioEffectManager
设备管理相关接口
getDeviceManager
获取设备管理对象 TXDeviceManager。
通过设备管理，您可以使用以下功能：
切换前后摄像头。
设置自动聚焦。
设置摄像头缩放倍数。
打开或关闭闪光灯。
- (TXDeviceManager *)getDeviceManager;
更多实用接口
setProperty
调用 V2TXLivePusher 的高级 API 接口。
- (V2TXLiveCode)setProperty:(NSString *)key value:(NSObject *)value
参数
参数
类型
含义
key
NSString *
高级 API 对应的 key。
value
NSObject *
调用 key 所对应的高级 API 时，需要的参数。
返回
返回值 V2TXLiveCode：
V2TXLIVE_OK：成功。
V2TXLIVE_ERROR_INVALID_PARAMETER：操作失败，key 不允许为空。
setMixTranscodingConfig
设置云端的混流转码参数。如果您在 实时音视频控制台 中的功能配置页开启了“启用旁路推流”功能，每一路画面都会有一个默认的直播 CDN 地址。一个直播间中可能有不止一位主播，而且每个主播都有自己的画面和声音，但对于 CDN 观众来说，他们只需要一路直播流，所以您需要将多路音视频流混成一路标准的直播流，这就需要混流转码。
- (V2TXLiveCode)setMixTranscodingConfig:(V2TXLiveTranscodingConfig *)config
参数
参数
类型
含义
config
V2TXLiveTranscodingConfig *
云端混流（转码）配置。
V2TXLiveTranscodingConfig
取值
说明
V2TXLiveBufferTypeUnknown
未知。
V2TXLiveBufferTypeByteBuffer
DirectBuffer，装载 I420 等 buffer，在 native 层使用。
V2TXLiveBufferTypeByteArray
byte[]，装载 I420 等 buffer，在 Java 层使用。
V2TXLiveBufferTypeTexture
直接操作纹理 ID，性能最好，画质损失最少。
showDebugView
显示仪表盘。
- (void)showDebugView:(BOOL)isShow
参数
参数
类型
含义
isShow
BOOL
是否显示，默认值：NO。

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

是

否

文档反馈

参数	类型	含义
liveMode	V2TXLiveMode	推流协议类型：RTMP/ROOM 协议，默认值：RTMP。

取值	含义
V2TXLiveRotation0	不旋转。
V2TXLiveRotation90	顺时针旋转90度。
V2TXLiveRotation180	顺时针旋转180度。
V2TXLiveRotation270	顺时针旋转270度。

取值	含义
V2TXLiveMirrorTypeAuto	默认镜像类型. 在这种情况下，前置摄像头的画面是镜像的，后置摄像头的画面不是镜像的。
V2TXLiveMirrorTypeEnable	前置摄像头和后置摄像头都切换为镜像模式。
V2TXLiveMirrorTypeDisable	前置摄像头和后置摄像头都切换为非镜像模式。

取值	说明
V2TXLivePixelFormatUnknown	未知。
V2TXLivePixelFormatI420	YUV420P I420。
V2TXLivePixelFormatTexture2D	OpenGL 2D 纹理。

取值	说明
V2TXLiveBufferTypeUnknown	未知。
V2TXLiveBufferTypeByteBuffer	DirectBuffer，装载 I420 等 buffer，在 native 层使用。
V2TXLiveBufferTypeByteArray	byte[]，装载 I420 等 buffer，在 Java 层使用。
V2TXLiveBufferTypeTexture	直接操作纹理 ID，性能最好，画质损失最少。

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

tencent cloud

SDK 基础函数

initWithLiveMode

参数

setObserver

参数

推流基础接口

setRenderView

参数

返回

startPush

参数

返回

stopPush

返回

isPushing

返回

视频相关接口

setVideoQuality

参数

setRenderRotation

参数

返回

V2TXLiveRotation 枚举值

setRenderMirror

参数

返回

V2TXLiveMirrorType枚举值

startCamera

返回

stopCamera

返回

startVirtualCamera

返回

stopVirtualCamera

返回

startScreenCapture

参数

返回

stopScreenCapture

返回

snapshot

返回

setWatermark

参数

setEncoderMirror

参数

enableCustomVideoCapture

参数

sendCustomVideoFrame

参数

返回

enableCustomVideoProcess

参数

V2TXLivePixelFormat 枚举值

V2TXLiveBufferType 枚举值

sendSeiMessage

参数

返回

美颜相关接口

getBeautyManager

音频相关接口

startMicrophone

返回

stopMicrophone

返回

setAudioQuality

参数

V2TXLiveAudioQuality 枚举值

返回

enableVolumeEvaluation

参数

返回

音效相关接口

getAudioEffectManager

设备管理相关接口

getDeviceManager

更多实用接口

setProperty

参数