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