Overview
Tencent Cloud’s live stream publisher
Features
V2TXLivePusher encodes local audio/video and publishes the encoded data to a specified URL. It supports any publishing server.
It has the following capabilities:Custom video capturing. You can customize audio and video data sources based on your project requirements.
Retouching, filters, and stickers.
V2TXLivePusher integrates multiple retouching algorithms (natural & smooth) and color space filters (custom filters are supported).QoS control technology.
V2TXLivePusher can adapt automatically to different upstream network conditions by controlling audio/video traffic in real time based on the network conditions of hosts.Facial feature adjustment and animated widgets. Powered by YouTu’s AI facial recognition technology,
V2TXLivePusher supports animated widgets and fine-tuning of facial features, such as eye enlarging, face slimming, and nose reshaping. You need to purchase a YouTu license to use these live streaming effects.Basic SDK APIs
setObserver
This API is used to set the callbacks of the publisher. After the setting, you can listen for the callback events of V2TXLivePusher, including publisher status, volume, statistics, alerts, and error messages.
public abstract void setObserver(V2TXLivePusherObserver observer);
Parameters
Parameter | Type | Description |
observer | V2TXLivePusherObserver | Target object for the publisher’s callbacks. For more information, please see V2TXLivePusherObserver. |
Basic Publishing APIs
setRenderView
This API is used to set the view for local camera preview. Images captured by the local camera are displayed on the view passed in after retouching, facial feature adjustments, and filter application.
public abstract int setRenderView(TXCloudVideoView view);
Parameters
Parameter | Type | Description |
view | TXCloudVideoView | View for local camera preview |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulsetRenderView
This API is used to set the view for local camera preview. Images captured by the local camera are displayed on the view passed in after retouching, facial feature adjustments, and filter application.
public abstract int setRenderView(SurfaceView view);
Parameters
Parameter | Type | Description |
view | SurfaceView | View for local camera preview |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulsetRenderView
This API is used to set the view for local camera preview. Images captured by the local camera are displayed on the view passed in after retouching, facial feature adjustments, and filter application.
public abstract int setRenderView(TextureView view);
Parameters
Parameter | Type | Description |
view | TextureView | View for local camera preview |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstartPush
This API is used to start publishing audio/video data.
public abstract int startPush(String url);
Parameters
Parameter | Type | Description |
url | String | URL to which data is published. Any publishing server is supported. |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLIVE_ERROR_INVALID_PARAMETER: operation failed because the URL is invalid.V2TXLIVE_ERROR_REFUSED: RTC does not support using the same stream ID for publishing and playback on the same device.stopPush
This API is used to stop publishing audio/video data.
public abstract int stopPush();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulisPushing
This API is used to get whether the publisher is publishing streams.
public abstract int isPushing();
Response
Whether streams are being played
1: yes0: noVideo APIs
setVideoQuality
// Set video encoding parameters for publishing
public abstract int setVideoQuality(V2TXLiveVideoEncoderParam param);
Parameters
Parameter | Type | Description |
param | Video encoding parameters |
setRenderRotation
This API is used to set the rotation of local camera preview.
public abstract int setRenderRotation(V2TXLiveRotation rotation);
Parameters
Parameter | Type | Description |
rotation | Degrees by which the image is rotated. Default value: V2TXLiveRotation0 |
Response
V2TXLiveCode:
V2TXLIVE_OK: successful
V2TXLiveRotation enumerated values
Value | Description |
V2TXLiveRotation0 | No rotation |
V2TXLiveRotation90 | Rotate 90 degrees clockwise |
V2TXLiveRotation180 | Rotate 180 degrees clockwise |
V2TXLiveRotation270 | Rotate 270 degrees clockwise |
setRenderMirror
This API is used to set the mirror mode of local camera preview.
public abstract int setRenderMirror(V2TXLiveMirrorType mirrorType);
Parameters
Parameter | Type | Description |
mirrorType | Mirror mode of the camera. Default value: V2TXLiveMirrorTypeAuto |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLiveMirrorType enumerated values
Value | Description |
V2TXLiveMirrorTypeAuto | The default value. In this mode, the front camera is mirrored, but the rear camera is not. |
V2TXLiveMirrorTypeEnable | Both the front and rear cameras are mirrored. |
V2TXLiveMirrorTypeDisable | Neither the front nor rear camera is mirrored. |
startCamera
This API is used to turn the local camera on.
Note:
Among
startVirtualCamera, startCamera, and startScreenCapture, only one can be used to publish data under the same pusher instance. If, for example, startCamera is called first and then startVirtualCamera, the SDK will pause the publishing of camera data and start image publishing.public abstract int startCamera(boolean frontCamera);
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstopCamera
This API is used to turn the local camera off.
public abstract int stopCamera();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstartVirtualCamera
This API is used to start image publishing.
Note:
Among
startVirtualCamera, startCamera, and startScreenCapture, only one can be used to publish data under the same pusher instance. If, for example, startCamera is called first and then startVirtualCamera, the SDK will pause the publishing of camera data and start image publishing.public abstract int startVirtualCamera(Bitmap image);
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstopVirtualCamera
This API is used to stop image publishing.
public abstract int stopVirtualCamera();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstartScreenCapture
This API is used to start screen recording.
Note:
Among
startVirtualCamera, startCamera, and startScreenCapture, only one can be used to publish data under the same pusher instance. If, for example, startCamera is called first and then startVirtualCamera, the SDK will pause the publishing of camera data and start image publishing.public abstract int startScreenCapture();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstopScreenCapture
This API is used to stop screen recording.
public abstract int stopScreenCapture();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulsnapshot
This API is used to take a screenshot of the local video while it is being published.
Note:
After
V2TXLIVE_OK is returned, you can get the screenshot taken in the V2TXLivePusherObserver.onSnapshotComplete callback.public abstract int snapshot();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLIVE_ERROR_REFUSED: failed to take a screenshot because publishing has stopped.setWatermark
This API is used to set a watermark for the publisher. Watermarking is disabled by default.
public abstract int setWatermark(Bitmap image, float x, float y, float scale);
Parameters
Parameter | Type | Description |
image | Bitmap | Watermark image. If this parameter is null, it means watermarks are disabled. |
x | float | Horizontal coordinate of the watermark |
y | float | Vertical coordinate of the watermark |
scale | float | Scale ratio of the watermark image |
setEncoderMirror
This API is used to set the mirror mode of encoded images.
public abstract int setEncoderMirror(boolean mirror);
Parameters
Parameter | Type | Description |
mirror | Boolean | Whether to mirror encoded images. Default value: false |
enableCustomVideoCapture
This API is used to enable/disable custom video capturing. In the custom video capturing mode, the SDK stops capturing images from the camera, but continues to encode and send images.
public abstract int enableCustomVideoCapture(boolean enable);
Parameters
Parameter | Type | Description |
enable | Boolean | Whether to enable custom video capturing. Default value: false. |
sendCustomVideoFrame
This API is used to send the custom video data captured to the SDK.
public abstract int sendCustomVideoFrame(V2TXLiveVideoFrame videoFrame);
Parameters
Parameter | Type | Description |
videoFrame | V2TXLiveVideoFrame | Video frame sent to the SDK |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLIVE_ERROR_INVALID_PARAMETER: operation failed because the video data is invalid.V2TXLIVE_ERROR_REFUSED: failed. You must call enableCustomVideoCapture to enable custom video capturing first.enableCustomVideoProcess
This API is used to enable/disable custom video processing.
public abstract int enableCustomVideoProcess(boolean enable, V2TXLivePixelFormat pixelFormat, V2TXLiveBufferType bufferType);
Parameters
Parameter | Type | Description |
enable | Boolean | Whether to enable custom video processing. Default value: false |
pixelFormat | Pixel format of video frames | |
bufferType | Video data buffer type |
V2TXLivePixelFormat enumerated values
Value | Description |
V2TXLivePixelFormatUnknown | Unknown |
V2TXLivePixelFormatI420 | YUV420P (I420) |
V2TXLivePixelFormatTexture2D | OpenGL 2D texture |
V2TXLiveBufferType enumerated values
Value | Description |
V2TXLiveBufferTypeUnknown | Unknown |
V2TXLiveBufferTypeByteBuffer | DirectBuffer, which carries buffers in the format of I420 and others and is used at the native layer. |
V2TXLiveBufferTypeByteArray | byte[], which carries buffers in the format of I420 and others and is used at the Java layer. |
V2TXLiveBufferTypeTexture | Texture ID, which allows direct operation. It delivers the best performance and has the smallest impact on video quality. |
sendSeiMessage
This API is used to send SEI messages. The player V2TXLivePlayer can receive SEI messages via the
onReceiveSeiMessage callback in V2TXLivePlayerObserver.public abstract int sendSeiMessage(int payloadType, byte[] data);
Parameters
Parameter | Type | Description |
payloadType | int | Data type. Valid values: 5, 242 (recommended) |
data | byte[] | Data to send |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulBeauty Filter APIs
getBeautyManager
This API is used to get the beauty filter management object TXBeautyManager.
You can do the following using
TXBeautyManager:Set the beauty filter style and apply effects including skin brightening, rosy skin, eye enlarging, face slimming, chin slimming, chin lengthening/shortening, face shortening, nose narrowing, eye brightening, teeth whitening, eye bag removal, wrinkle removal, and smile line removal.
Adjust the hairline, eye spacing, eye corners, lip shape, nose wings, nose position, lip thickness, and face shape.
Apply animated effects such as face widgets (materials).
Add makeup effects.
Recognize gestures.
public TXBeautyManager getBeautyManager()
Audio APIs
startMicrophone
This API is used to turn the mic on.
public abstract int startMicrophone();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulstopMicrophone
This API is used to turn the mic off.
public abstract int stopMicrophone();
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulsetAudioQuality
This API is used to set audio quality.
public abstract int setAudioQuality(V2TXLiveAudioQuality quality);
Parameters
Parameter | Type | Description |
quality | V2TXLiveAudioQuality | Audio quality |
V2TXLiveAudioQuality enumerated values
Value | Description |
V2TXLiveAudioQualitySpeech | Speech. Audio sample rate: 16 kHz; sound channel: mono; bitrate: 16 Kbps<br>This is designed for speech-based call scenarios such as online conferencing and audio call. |
V2TXLiveAudioQualityDefault | Default. Audio sample rate: 48 kHz; sound channel: mono; bitrate: 50 Kbps<br>This is the default audio quality of the SDK and is recommended. |
V2TXLiveAudioQualityMusic | Music. Audio sample rate: 48 kHz; sound channel: dual; bitrate: 128 Kbps<br>This is designed for music-oriented scenarios with hi-fi requirements, such as karaoke and live music streaming. |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLIVE_ERROR_REFUSED: you cannot change audio quality settings when streams are being published.enableVolumeEvaluation
This API is used to enable the volume reminder for audio capturing.
Note:
After enabling the volume reminder, you can get the volume measured by the SDK in the
V2TXLivePusherObserver#onMicrophoneVolumeUpdate(int) callback.public abstract int enableVolumeEvaluation(int intervalMs);
Parameters
Parameter | Type | Description |
intervalMs | int | Interval (ms) for volume callbacks. The minimum interval allowed is 100 ms. If the value is 0 (default) or smaller, the callback is disabled. 300 is recommended. |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulAudio Effect APIs
getAudioEffectManager
This API is used to get the audio effect management object TXAudioEffectManager.
You can do the following using
TXAudioEffectManager:Set the volume of audio captured by the mic.
Set reverb and voice changing effects.
Enable in-ear monitoring and set its volume.
Add background music and specify how to play it.
public TXAudioEffectManager getAudioEffectManager()
Device Management APIs
getDeviceManager
This API is used to get the device management object TXDeviceManager.
You can do the following using
TXDeviceManager:Switch between the front and rear cameras.
Enable autofocus.
Set camera zoom level.
Enable/Disable flashlight.
public abstract TXDeviceManager getDeviceManager();
Other APIs
setProperty
This API is used to call the advanced APIs of
V2TXLivePusher.public abstract int setProperty(String key, Object value);
Parameters
Parameter | Type | Description |
key | String | Key of the advanced API to call |
value | Object | Parameters required by the advanced API |
Response
V2TXLiveCode:
V2TXLIVE_OK: successfulV2TXLIVE_ERROR_INVALID_PARAMETER: operation failed because key is empty.setMixTranscodingConfig
This API is used to set On-Cloud MixTranscoding parameters. If you have enabled relayed push on the Function Configuration page of the TRTC console, then each channel of image will have a default CDN live streaming address. There may be multiple hosts in a room, each sending their own video and audio, but CDN audience needs only one live stream. Therefore, you need to mix multiple audio/video streams into one standard live stream, which requires MixTranscoding.
public abstract int setMixTranscodingConfig(V2TXLiveTranscodingConfig config);
Parameters
Parameter | Type | Description |
config | On-Cloud MixTranscoding configuration |
V2TXLiveTranscodingConfig
Value | Description |
V2TXLiveBufferTypeUnknown | Unknown |
V2TXLiveBufferTypeByteBuffer | DirectBuffer, which carries buffers in the format of I420 and others and is used at the native layer. |
V2TXLiveBufferTypeByteArray | byte[], which carries buffers in the format of I420 and others and is used at the Java layer. |
V2TXLiveBufferTypeTexture | Texture ID, which allows direct operation. It delivers the best performance and has the smallest impact on video quality. |
showDebugView
This API is used to set whether to display the dashboard.
public abstract void showDebugView(boolean isShow);
Parameters
Parameter | Type | Description |
isShow | boolean | Whether to display the dashboard. Default value: false |
Yes
No
Was this page helpful?