动态与公告

TUILiveKit 产品动态

云直播推拉流 SDK 产品动态

新手指引

产品简介

产品概述

产品优势

性能数据

基本概念

购买指南

TRTC Live 价格总览

Live 视频直播计费说明

开通服务（TUILiveKit）

Demo 体验

Demo 体验指引

跑通 Demo（TUILiveKit）

接入指南

视频直播

准备工作

主播开播

观众观看

直播列表

语聊房

准备工作

主播开播

观众观看

直播列表

推流助手

推流助手（Electron 桌面应用）

推流助手（Web 桌面浏览器）

直播监播

监播页面（Web 桌面浏览器 React 版）

监播页面（Web 桌面浏览器 Vue 版）

UI 自定义

直播视频组件

视频源编辑组件

观众列表组件

聊天弹幕组件

媒体源配置面板

连麦管理面板

直播送礼组件

无 UI 集成

搭建视频直播

搭建语聊房

功能指南

关注主播（TUILiveKit）

至臻画质（TUILiveKit）

输入媒体流进房（TUILiveKit）

礼物系统（TUILiveKit）

客户端 API

Android

iOS

Web

服务端 API（TUILiveKit）

账号系统

REST API

第三方回调

错误码（TUILiveKit）

常见问题

平台编译

用户鉴权

云直播推拉流 SDK

产品简介

购买指南

Demo 体验

免费测试

SDK 下载

License 管理

高级功能

客户端 API

常见问题

无 UI 集成方案

API 文档

OSS information

OSS Attribution Notice

V2TXLivePlayerObserver

聚焦模式

字号

最后更新时间： 2026-03-27 17:23:05

Copyright (c) 2021 Tencent. All rights reserved.
﻿
Module:   V2TXLivePlayerObserver @ TXLiteAVSDK
﻿
Function: 腾讯云直播的播放器回调通知
﻿
功能
腾讯云直播的播放器回调通知。
介绍
可以接收 ﻿V2TXLivePlayer﻿ 播放器的一些回调通知，包括播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等。
﻿
V2TXLivePlayerObserver
V2TXLivePlayerObserver
函数列表
描述
onError
直播播放器错误通知，播放器出现错误时，会回调该通知
onWarning
直播播放器警告通知
onVideoResolutionChanged
直播播放器分辨率变化通知
onConnected
已经成功连接到服务器
onVideoPlaying
视频播放事件
onAudioPlaying
音频播放事件
onVideoLoading
视频加载事件
onAudioLoading
音频加载事件
onPlayoutVolumeUpdate
播放器音量大小回调
onStatisticsUpdate
直播播放器统计数据回调
onSnapshotComplete
截图回调
onRenderVideoFrame
自定义视频渲染回调
onPlayoutAudioFrame
音频数据回调
onReceiveSeiMessage
收到 SEI 消息的回调，发送端通过 ﻿V2TXLivePusher﻿ 中的  sendSeiMessage  来发送 SEI 消息
onStreamSwitched
分辨率无缝切换回调
onLocalRecordBegin
录制任务开始的事件回调
onLocalRecording
录制任务正在进行中的进展事件回调
onLocalRecordComplete
录制任务已经结束的事件回调
onError
onError
void onError
(﻿V2TXLivePlayer﻿ player
﻿
int code
﻿
String msg
﻿
Bundle extraInfo)
直播播放器错误通知，播放器出现错误时，会回调该通知参数
描述
code
错误码 ﻿V2TXLiveCode﻿。
extraInfo
扩展信息。
msg
错误信息。
player
回调该通知的播放器对象。
onWarning
onWarning
void onWarning
(﻿V2TXLivePlayer﻿ player
﻿
int code
﻿
String msg
﻿
Bundle extraInfo)
直播播放器警告通知参数
描述
code
警告码 ﻿V2TXLiveCode﻿。
extraInfo
扩展信息。
msg
警告信息。
player
回调该通知的播放器对象。
onVideoResolutionChanged
onVideoResolutionChanged
void onVideoResolutionChanged
(﻿V2TXLivePlayer﻿ player
﻿
int width
﻿
int height)
直播播放器分辨率变化通知参数
描述
height
视频高。
player
回调该通知的播放器对象。
width
视频宽。
onConnected
onConnected
void onConnected
(﻿V2TXLivePlayer﻿ player
﻿
Bundle extraInfo)
已经成功连接到服务器参数
描述
extraInfo
扩展信息。
player
回调该通知的播放器对象。
onVideoPlaying
onVideoPlaying
void onVideoPlaying
(﻿V2TXLivePlayer﻿ player
﻿
boolean firstPlay
﻿
Bundle extraInfo)
视频播放事件参数
描述
extraInfo
扩展信息。
firstPlay
第一次播放标志。
player
回调该通知的播放器对象。
onAudioPlaying
onAudioPlaying
void onAudioPlaying
(﻿V2TXLivePlayer﻿ player
﻿
boolean firstPlay
﻿
Bundle extraInfo)
音频播放事件参数
描述
extraInfo
扩展信息。
firstPlay
第一次播放标志。
player
回调该通知的播放器对象。
onVideoLoading
onVideoLoading
void onVideoLoading
(﻿V2TXLivePlayer﻿ player
﻿
Bundle extraInfo)
视频加载事件参数
描述
extraInfo
扩展信息。
player
回调该通知的播放器对象。
onAudioLoading
onAudioLoading
void onAudioLoading
(﻿V2TXLivePlayer﻿ player
﻿
Bundle extraInfo)
音频加载事件参数
描述
extraInfo
扩展信息。
player
回调该通知的播放器对象。
onPlayoutVolumeUpdate
onPlayoutVolumeUpdate
void onPlayoutVolumeUpdate
(﻿V2TXLivePlayer﻿ player
﻿
int volume)
播放器音量大小回调参数
描述
player
回调该通知的播放器对象。
volume
音量大小。
注意
调用 ﻿enableVolumeEvaluation﻿ 开启播放音量大小提示之后，会收到这个回调通知。
onStatisticsUpdate
onStatisticsUpdate
void onStatisticsUpdate
(﻿V2TXLivePlayer﻿ player
﻿
﻿V2TXLivePlayerStatistics﻿ statistics)
直播播放器统计数据回调参数
描述
player
回调该通知的播放器对象。
statistics
播放器统计数据 ﻿V2TXLivePlayerStatistics﻿。
onSnapshotComplete
onSnapshotComplete
void onSnapshotComplete
(﻿V2TXLivePlayer﻿ player
﻿
Bitmap image)
截图回调参数
描述
image
已截取的视频画面。
player
回调该通知的播放器对象。
onRenderVideoFrame
onRenderVideoFrame
void onRenderVideoFrame
(﻿V2TXLivePlayer﻿ player
﻿
﻿V2TXLiveVideoFrame﻿ videoFrame)
自定义视频渲染回调参数
描述
player
回调该通知的播放器对象。
videoFrame
视频帧数据 ﻿V2TXLiveVideoFrame﻿。
注意
需要您调用 ﻿enableObserveVideoFrame﻿ 开启回调开关。
onPlayoutAudioFrame
onPlayoutAudioFrame
void onPlayoutAudioFrame
(﻿V2TXLivePlayer﻿ player
﻿
﻿V2TXLiveAudioFrame﻿ audioFrame)
音频数据回调参数
描述
audioFrame
音频帧数据 ﻿V2TXLiveAudioFrame﻿。
player
回调该通知的播放器对象。
注意
需要您调用 ﻿enableObserveAudioFrame﻿ 开启回调开关。请在当前回调中使用 audioFrame 的 data。
onReceiveSeiMessage
onReceiveSeiMessage
void onReceiveSeiMessage
(﻿V2TXLivePlayer﻿ player
﻿
int payloadType
﻿
byte[] data)
收到 SEI 消息的回调，发送端通过 {@link V2TXLivePusher} 中的 `sendSeiMessage` 来发送 SEI 消息参数
描述
data
数据。
payloadType
回调数据的SEI payloadType。
player
回调该通知的播放器对象。
注意
调用 ﻿V2TXLivePlayer﻿ 中的  enableReceiveSeiMessage  开启接收 SEI 消息之后，会收到这个回调通知。
onStreamSwitched
onStreamSwitched
void onStreamSwitched
(﻿V2TXLivePlayer﻿ player
﻿
String url
﻿
int code)
分辨率无缝切换回调参数
描述
code
状态码，0：成功，-1：切换超时，-2：切换失败，服务端错误，-3：切换失败，客户端错误。
player
回调该通知的播放器对象。
url
切换的播放地址。
注意
调用 ﻿V2TXLivePlayer﻿ 中的  switchStream  切换分辨率，会收到这个回调通知。
onLocalRecordBegin
onLocalRecordBegin
void onLocalRecordBegin
(﻿V2TXLivePlayer﻿ player
﻿
int code
﻿
String storagePath)
录制任务开始的事件回调参数
描述
code
状态码。
 0：录制任务启动成功。
 -1：内部错误导致录制任务启动失败。
 -2：文件后缀名有误（例如不支持的录制格式）。
 -6：录制已经启动，需要先停止录制。
 -7：录制文件已存在，需要先删除文件。
 -8：录制目录无写入权限，请检查目录权限问题。
player
回调该通知的播放器对象。
storagePath
录制的文件地址。
onLocalRecording
onLocalRecording
void onLocalRecording
(﻿V2TXLivePlayer﻿ player
﻿
long durationMs
﻿
String storagePath)
录制任务正在进行中的进展事件回调参数
描述
durationMs
录制时长。
player
回调该通知的播放器对象。
storagePath
录制的文件地址。
onLocalRecordComplete
onLocalRecordComplete
void onLocalRecordComplete
(﻿V2TXLivePlayer﻿ player
﻿
int code
﻿
String storagePath)
录制任务已经结束的事件回调参数
描述
code
状态码。
  0：结束录制任务成功。
 -1：录制失败。
 -2：切换分辨率或横竖屏导致录制结束。
 -3：录制时间太短，或未采集到任何视频或音频数据，请检查录制时长，或是否已开启音、视频采集。
player
回调该通知的播放器对象。
storagePath
录制的文件地址。

帮助和支持

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

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

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

直播 SDK

V2TXLivePlayerObserver

功能

介绍

V2TXLivePlayerObserver

onError

onWarning

onVideoResolutionChanged

onConnected

onVideoPlaying

onAudioPlaying

onVideoLoading

onAudioLoading

onPlayoutVolumeUpdate

onStatisticsUpdate

onSnapshotComplete

onRenderVideoFrame

onPlayoutAudioFrame

onReceiveSeiMessage

onStreamSwitched

onLocalRecordBegin

onLocalRecording

onLocalRecordComplete

帮助和支持

函数列表	描述
onError	直播播放器错误通知，播放器出现错误时，会回调该通知
onWarning	直播播放器警告通知
onVideoResolutionChanged	直播播放器分辨率变化通知
onConnected	已经成功连接到服务器
onVideoPlaying	视频播放事件
onAudioPlaying	音频播放事件
onVideoLoading	视频加载事件
onAudioLoading	音频加载事件
onPlayoutVolumeUpdate	播放器音量大小回调
onStatisticsUpdate	直播播放器统计数据回调
onSnapshotComplete	截图回调
onRenderVideoFrame	自定义视频渲染回调
onPlayoutAudioFrame	音频数据回调
onReceiveSeiMessage	收到 SEI 消息的回调，发送端通过 V2TXLivePusher 中的 `sendSeiMessage` 来发送 SEI 消息
onStreamSwitched	分辨率无缝切换回调
onLocalRecordBegin	录制任务开始的事件回调
onLocalRecording	录制任务正在进行中的进展事件回调
onLocalRecordComplete	录制任务已经结束的事件回调

void onError	(V2TXLivePlayer player
	int code
	String msg
	Bundle extraInfo)

参数	描述
code	错误码 V2TXLiveCode。
extraInfo	扩展信息。
msg	错误信息。
player	回调该通知的播放器对象。

void onWarning	(V2TXLivePlayer player
	int code
	String msg
	Bundle extraInfo)

void onVideoResolutionChanged	(V2TXLivePlayer player
	int width
	int height)

参数	描述
height	视频高。
player	回调该通知的播放器对象。
width	视频宽。

void onVideoPlaying	(V2TXLivePlayer player
	boolean firstPlay
	Bundle extraInfo)

void onAudioPlaying	(V2TXLivePlayer player
	boolean firstPlay
	Bundle extraInfo)

void onStatisticsUpdate	(V2TXLivePlayer player
	V2TXLivePlayerStatistics statistics)

参数	描述
image	已截取的视频画面。
player	回调该通知的播放器对象。

void onRenderVideoFrame	(V2TXLivePlayer player
	V2TXLiveVideoFrame videoFrame)

void onPlayoutAudioFrame	(V2TXLivePlayer player
	V2TXLiveAudioFrame audioFrame)

参数	描述
audioFrame	音频帧数据 V2TXLiveAudioFrame。
player	回调该通知的播放器对象。

void onReceiveSeiMessage	(V2TXLivePlayer player
	int payloadType
	byte[] data)

参数	描述
data	数据。
payloadType	回调数据的SEI payloadType。
player	回调该通知的播放器对象。

void onStreamSwitched	(V2TXLivePlayer player
	String url
	int code)

void onLocalRecordBegin	(V2TXLivePlayer player
	int code
	String storagePath)

void onLocalRecording	(V2TXLivePlayer player
	long durationMs
	String storagePath)

参数	描述
durationMs	录制时长。
player	回调该通知的播放器对象。
storagePath	录制的文件地址。

void onLocalRecordComplete	(V2TXLivePlayer player
	int code
	String storagePath)