直播 SDK V2TXLivePlayerObserver-客户端 API-文档中心-腾讯云

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
录制的文件地址。

函数列表	描述
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)

V2TXLivePlayerObserver

本页目录：

功能

介绍

V2TXLivePlayerObserver

onError

直播播放器错误通知，播放器出现错误时，会回调该通知

onWarning

直播播放器警告通知

onVideoResolutionChanged

直播播放器分辨率变化通知

onConnected

已经成功连接到服务器

onVideoPlaying

视频播放事件

onAudioPlaying

音频播放事件

onVideoLoading

视频加载事件

onAudioLoading

音频加载事件

onPlayoutVolumeUpdate

播放器音量大小回调

onStatisticsUpdate

直播播放器统计数据回调

onSnapshotComplete

截图回调

onRenderVideoFrame

自定义视频渲染回调

onPlayoutAudioFrame

音频数据回调

onReceiveSeiMessage

收到 SEI 消息的回调，发送端通过 {@link V2TXLivePusher} 中的 `sendSeiMessage` 来发送 SEI 消息

onStreamSwitched

分辨率无缝切换回调

onLocalRecordBegin

录制任务开始的事件回调

onLocalRecording

录制任务正在进行中的进展事件回调

onLocalRecordComplete

录制任务已经结束的事件回调