V2TXLivePlayerObserver.h
3.92 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
//
// Copyright © 2020 Tencent. All rights reserved.
//
// Module: V2TXLive
//
#import "V2TXLiveDef.h"
@protocol V2TXLivePlayer;
/// @defgroup V2TXLivePlayerObserver_ios V2TXLivePlayerObserver
/// 腾讯云直播的播放器回调通知。<br/>
/// 可以接收 V2TXLivePlayer 播放器的一些回调通知，包括播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等。
/// @{
@protocol V2TXLivePlayerObserver <NSObject>
@optional
/**
* 直播播放器错误通知，播放器出现错误时，会回调该通知
*
* @param player 回调该通知的播放器对象
* @param code 错误码 {@link V2TXLiveCode}
* @param msg 错误信息
* @param extraInfo 扩展信息
*/
- (void)onError:(id<V2TXLivePlayer>)player code:(V2TXLiveCode)code message:(NSString *)msg extraInfo:(NSDictionary *)extraInfo;
/**
* 直播播放器警告通知
*
* @param player 回调该通知的播放器对象
* @param code 警告码 {@link V2TXLiveCode}
* @param msg 警告信息
* @param extraInfo 扩展信息
*/
- (void)onWarning:(id<V2TXLivePlayer>)player code:(V2TXLiveCode)code message:(NSString *)msg extraInfo:(NSDictionary *)extraInfo;
/**
* 直播播放器视频状态变化通知
*
* @param player 回调该通知的播放器对象
* @param status 状态码 {@link V2TXLivePlayStatus}
* @param reason 状态对应的原因 {@link V2TXLiveStatusChangeReason}
* @param extraInfo 扩展信息
*/
- (void)onVideoPlayStatusUpdate:(id<V2TXLivePlayer>)player status:(V2TXLivePlayStatus)status reason:(V2TXLiveStatusChangeReason)reason extraInfo:(NSDictionary *)extraInfo;
/**
* 直播播放器音频状态变化通知
*
* @param player 回调该通知的播放器对象
* @param status 状态码 {@link V2TXLivePlayStatus}
* @param reason 状态对应的原因 {@link V2TXLiveStatusChangeReason}
* @param extraInfo 扩展信息
*/
- (void)onAudioPlayStatusUpdate:(id<V2TXLivePlayer>)player status:(V2TXLivePlayStatus)status reason:(V2TXLiveStatusChangeReason)reason extraInfo:(NSDictionary *)extraInfo;
/**
* 播放器音量大小回调
*
* @param player 回调该通知的播放器对象
* @param volume 音量大小
* @note 调用 [enableVolumeEvaluation](@ref V2TXLivePlayer#enableVolumeEvaluation:) 开启播放音量大小提示之后，会收到这个回调通知。
*/
- (void)onPlayoutVolumeUpdate:(id<V2TXLivePlayer>)player volume:(NSInteger)volume;
/**
* 直播播放器统计数据回调
*
* @param player 回调该通知的播放器对象
* @param statistics 播放器统计数据 {@link V2TXLivePlayerStatistics}
*/
- (void)onStatisticsUpdate:(id<V2TXLivePlayer>)player statistics:(V2TXLivePlayerStatistics *)statistics;
/**
* 截图回调
*
* @note 调用 [snapshot](@ref V2TXLivePlayer#snapshot) 截图之后，会收到这个回调通知
* @param player 回调该通知的播放器对象
* @param image 已截取的视频画面
*/
- (void)onSnapshotComplete:(id<V2TXLivePlayer>)player image:(TXImage *)image;
/**
* 自定义视频渲染回调
*
* @param player 回调该通知的播放器对象
* @param videoFrame 视频帧数据 {@link V2TXLiveVideoFrame}
* @note 调用 [enableCustomRendering](@ref V2TXLivePlayer#enableCustomRendering:pixelFormat:bufferType:) 开启自定义渲染之后，会收到这个回调通知
*/
- (void)onRenderVideoFrame:(id<V2TXLivePlayer>)player frame:(V2TXLiveVideoFrame *)videoFrame;
/**
* 收到 SEI 消息的回调，发送端通过 {@link V2TXLivePusher} 中的 `sendSeiMessage` 来发送 SEI 消息。
*
* @note 调用 {@link V2TXLivePlayer} 中的 `enableReceiveSeiMessage` 开启接收 SEI 消息之后，会收到这个回调通知
*
* @param player 回调该通知的播放器对象。
* @param payloadType 回调数据的SEI payloadType
* @param data 数据
*/
- (void)onReceiveSeiMessage:(id<V2TXLivePlayer>)player payloadType:(int)payloadType data:(NSData *)data;
@end
/// @}