tencent cloud

Mobile Live Video Broadcasting

Release Notes and Announcements
TUILiveKit Release Notes
Live SDK Release Notes
User Guide
Product Introduction
Overview
Strengths
Performance Statistics
Concepts
Purchase Guide
TRTC Live Billing Overview
Billing of Video Live Component
Activating the Service (TUILiveKit)
Free Demo
Demo
Run Demo（TUILiveKit）
Integration Guide
Video Live Streaming
Preparation
Host Live Streaming
Audience Viewing
Live Stream List Live Stream List
Voice Chat Room
Preparation
Host Live Streaming
Audience Viewing
Live Stream List
Live Streaming Kit
Live Streaming Kit（Electron Desktop Application）
Live Streaming Kit（Web Desktop Browser）
Live Broadcast Monitoring
Monitoring Webpage （Web Desktop Browser React）
Monitoring Webpage （Web Desktop Browser Vue）
UI Customization
Live Stream Video Component
Video Source Editing Canvas
Audience List Component
Barrage Component
Media Source Configuration Panel
Link Management Panel
Live Gift Component
No UI Integration
Video Live Streaming
Voice Chat Room
Feature Guide
Follow Anchors (TUILiveKit)
Ultimate Image Quality (TUILiveKit)
Push Media Stream Into Room (TUILiveKit)
Gift System (TUILiveKit)
Client APIs
Android
iOS
Web
Server APIs (TUILiveKit)
Account System
REST API
Third-Party Webhooks
Error Codes (TUILiveKit)
FAQs
Platform Compilation
User Authentication
Live SDK
Product Introduction
Purchase Guide
Free Demo
Free Trial License
SDK Download
Licenses
Advanced Features
Client API
FAQs
Integration (No UI)
API Documentation
OSS information
OSS Attribution Notice
DocumentaçãoMobile Live Video BroadcastingLive SDKClient APIAndroidV2TXLivePlayer

V2TXLivePlayer

Modo Foco
Tamanho da Fonte
Última atualização: 2026-03-27 17:23:04
Copyright (c) 2021 Tencent. All rights reserved.

Module: V2TXLivePlayer @ TXLiteAVSDK

Function: Tencent Cloud live player


Function

Tencent Cloud Live Player.
It is mainly responsible for pulling audio and video data from the specified live stream address, decoding and rendering locally.

Introduce

The player includes the following capabilities:
Support RTMP, HTTP-FLV, HLS, TRTC, WebRTC protocols.
Screen capture, you can capture the video screen of the current live stream.
Delay adjustment, you can set the minimum and maximum time for automatic adjustment of the player cache.
Customized video data processing, you can process the video data in the live stream according to the needs of the project, and then render and play it.

V2TXLivePlayer

V2TXLivePlayer

FuncList
DESC
Sets the player callback
Sets the rendering view of the player. This control is responsible for presenting the video content
Sets the rendering view of the player. This control is responsible for presenting the video content
Sets the rendering view of the player. This control is responsible for presenting the video content
Sets the rotation angle of the player view
Sets the fill mode of the view
Sets the mirror mode of the player view
Starts playing the audio and video streams
Stops playing the audio and video streams
Indicates whether the player is playing the audio and video streams
Pauses the audio stream of the player
Resumes the audio stream of the player
Pauses the video stream of the player
Resumes the video stream of the player
Sets the volume
Set the minimum time and maximum time (unit: s) for auto adjustment of the player cache
Seamlessly switch live stream urls, supporting FLV and LEB protocols
Get Stream lnfo List
Enables playback volume update
Captures the video view in the playback process
Turn on/off the monitoring callback of the video frame
Turn on/off the monitoring callback of the audio frame
Enables the receiving of SEI messages
Indicates whether the debug view of the player video status information is displayed
Calls the advanced API of V2TXLivePlayer
Start recording audio and video stream
Stop recording audio and video stream

setObserver

setObserver
void setObserver
(V2TXLivePlayerObserver observer)
Sets the player callback
By setting the callback, you can listen to some callback events of V2TXLivePlayer,
including the player status, playback volume callback, first frame audio/video callback, statistics, warnings, and error messages.
Param
DESC
observer
Callback target of the player. For more information, see V2TXLivePlayerObserver.

setRenderView

setRenderView
int setRenderView
(TXCloudVideoView view)
Sets the rendering view of the player. This control is responsible for presenting the video content
Param
DESC
view
Player rendering view.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setRenderView

setRenderView
int setRenderView
(TextureView view)
Sets the rendering view of the player. This control is responsible for presenting the video content
Param
DESC
view
Player rendering view.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setRenderView

setRenderView
int setRenderView
(SurfaceView view)
Sets the rendering view of the player. This control is responsible for presenting the video content
Param
DESC
view
Player rendering view.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setRenderRotation

setRenderRotation
int setRenderRotation
(V2TXLiveRotation rotation)
Sets the rotation angle of the player view
Param
DESC
rotation
Rotation angle of the view V2TXLiveRotation.
V2TXLiveRotation0 Default: 0 degrees, which means the view is not rotated.
V2TXLiveRotation90: rotate 90 degrees clockwise.
V2TXLiveRotation180: rotate 180 degrees clockwise.
V2TXLiveRotation270: rotate 270 degrees clockwise.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setRenderFillMode

setRenderFillMode
int setRenderFillMode
(V2TXLiveFillMode mode)
Sets the fill mode of the view
Param
DESC
mode
Fill mode of the view V2TXLiveFillMode.
V2TXLiveFillModeFill: Default: fill the screen with the image without leaving any black edges. If the aspect ratio of the view is different from that of the screen, part of the view will be cropped.
V2TXLiveFillModeFit make the view fit the screen without cropping. If the aspect ratio of the view is different from that of the screen, black edges will appear.
V2TXLiveFillModeScaleFill fill the screen with the stretched image, thus the length and width may not change proportionally.
Return Desc:
Return code V2TXLiveCode
V2TXLIVE_OK: successful

setRenderMirrorMode

setRenderMirrorMode
int setRenderMirrorMode
(boolean enable)
Sets the mirror mode of the player view

If you turn on this switch, You can watch the video in the mirror mode.
Param
DESC
enable
Whether to enable the mirror mode of the player view. Default: false.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

startLivePlay

startLivePlay
int startLivePlay
(String url)
Starts playing the audio and video streams
Param
DESC
url
URL of the audio and video streams to be played. The RTMP, HTTP-FLV and TRTC streaming protocols are supported.
Note
Starting from version 10.7, the Licence needs to be set through setLicence or setLicence before it can be played successfully, otherwise the playback will fail (black screen), and it can only be set once globally. Live Licence, UGC Licence, and Player Licence can all be used. If you have not obtained the above Licence, you can purchase the official licence.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: operation succeeded. The player starts connecting to the URL and playing the audio and video streams.
V2TXLIVE_ERROR_INVALID_PARAMETER: operation failed. The URL is invalid.
V2TXLIVE_ERROR_REFUSED: operation failed. Duplicate streamId, please ensure that no other player or pusher is using this streamId now.
V2TXLIVE_ERROR_INVALID_LICENSE: The licence is invalid and the playback fails.

stopPlay

stopPlay
Stops playing the audio and video streamsReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

isPlaying

isPlaying
Indicates whether the player is playing the audio and video streamsReturn Desc:
Indicates whether the player is playing the audio and video streams.
1: yes.
0: no.

pauseAudio

pauseAudio
Pauses the audio stream of the playerReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

resumeAudio

resumeAudio
Resumes the audio stream of the playerReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

pauseVideo

pauseVideo
Pauses the video stream of the playerReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

resumeVideo

resumeVideo
Resumes the video stream of the playerReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setPlayoutVolume

setPlayoutVolume
int setPlayoutVolume
(int volume)
Sets the volume
Param
DESC
volume
Volume. Valid range: 0 - 100. Default: 100.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

setCacheParams

setCacheParams
int setCacheParams
(float minTime

float maxTime)
Set the minimum time and maximum time (unit: s) for auto adjustment of the player cache
Param
DESC
maxTime
Maximum time for auto cache adjustment. The value must be greater than 0. Default: 5.
minTime
Minimum time for auto cache adjustment. The value must be greater than 0. Default: 1.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.
V2TXLIVE_ERROR_INVALID_PARAMETER: operation failed. MinTime and maxTime must be greater than 0.
V2TXLIVE_ERROR_REFUSED: operation failed. Change of cache is not suppoted when playing.

switchStream

switchStream
int switchStream
(String newUrl)
Seamlessly switch live stream urls, supporting FLV and LEB protocols
Param
DESC
newUrl
New pull address.

getStreamList

getStreamList
Get Stream lnfo List

enableVolumeEvaluation

enableVolumeEvaluation
int enableVolumeEvaluation
(int intervalMs)
Enables playback volume update
After this feature is enabled, you can obtain the SDK’s volume evaluation through the onPlayoutVolumeUpdate callback.
Param
DESC
intervalMs
Interval for triggering the volume callback. The unit is ms. The minimum interval is 100 ms. If the value is equal to or smaller than 0, the callback is disabled. We recommend that you set this parameter to 300 ms. Default: 0.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

snapshot

snapshot
Captures the video view in the playback processReturn Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.
V2TXLIVE_ERROR_REFUSED: playback is stopped, the snapshot operation cannot be called.

enableObserveVideoFrame

enableObserveVideoFrame
int enableObserveVideoFrame
(boolean enable

V2TXLivePixelFormat pixelFormat

V2TXLiveBufferType bufferType)
Turn on/off the monitoring callback of the video frame
The SDK will no longer render the video after you turn on this switch. You can get the video frame through V2TXLivePlayerObserver and execute custom rendering logic.
Param
DESC
bufferType
Video data format for custom rendering callback V2TXLiveBufferType。
enable
Whether to enable custom rendering. Default: false.
pixelFormat
Video pixel format for custom rendering callback V2TXLivePixelFormat。
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.
V2TXLIVE_ERROR_NOT_SUPPORTED: the pixel format or data format is not supported.

enableObserveAudioFrame

enableObserveAudioFrame
int enableObserveAudioFrame
(boolean enable)
Turn on/off the monitoring callback of the audio frame
if you turn on this switch, You can get the audio frame through V2TXLivePlayerObserver and execute custom logic.
Param
DESC
enable
Whether to enable the callback of the audio frame. Default: false.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

enableReceiveSeiMessage

enableReceiveSeiMessage
int enableReceiveSeiMessage
(boolean enable

int payloadType)
Enables the receiving of SEI messages
Param
DESC
enable
true : enable; false (default): disable.
payloadType
The payload type of SEI messages. Valid values: 5 , 242 , 243 , please be consistent with the payload type of the sender.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.

showDebugView

showDebugView
void showDebugView
(boolean isShow)
Indicates whether the debug view of the player video status information is displayed
Param
DESC
isShow
Specifies whether to display the debug view. Default: false.

setProperty

setProperty
int setProperty
(String key

Object value)
Calls the advanced API of V2TXLivePlayer
Param
DESC
key
Key of the advanced API.
value
Parameter needed to call the advanced API corresponding to the key.
Note
This API is used to call some advanced features.
Return Desc:
Return code V2TXLiveCode.
V2TXLIVE_OK: successful.
V2TXLIVE_ERROR_INVALID_PARAMETER: operation failed. The key cannot be null.

startLocalRecording

startLocalRecording
int startLocalRecording
Start recording audio and video stream
Note
The recording can only be started after the play stream is started, and it is invalid to start the recording in the non-play state.
Do not dynamically switch soft/hard decoding during the recording process, as there is a high probability that the generated video will be abnormal.
Return Desc:
Return code for V2TXLiveCode.
V2TXLIVE_OK : successful.
V2TXLIVE_ERROR_INVALID_PARAMETER : The parameter is invalid, such as filePath is empty.
V2TXLIVE_ERROR_REFUSED : API refuse, you must first call startLivePlay to start playing streaming.

stopLocalRecording

stopLocalRecording
Stop recording audio and video stream
Note
When the play stream is stopped, if the video is still being recorded, the SDK will automatically end the recording.
Anterior: V2TXLivePusherObserverPróximo: V2TXLivePlayerObserver

Ajuda e Suporte

Esta página foi útil?

comentários