@protocol VeLivePlayerObserver <NSObject>

播放事件回调。

成员函数 #

函数说明 #

onError:error: #

- (void)onError:(TVLManager *_Nonnull)player error:(VeLivePlayerError *_Nonnull)error;

播放器错误信息回调，播放器出现错误时，触发此回调。
传入参数

onInfo:info: #

- (void)onInfo:(TVLManager *_Nonnull)player info:(VeLivePlayerError *_Nonnull)info;

播放器信息回调。在播放器有内部错误时，SDK 会触发此回调。
传入参数

onFirstVideoFrameRender:isFirstFrame: #

- (void)onFirstVideoFrameRender:(TVLManager *_Nonnull)player isFirstFrame:(BOOL)isFirstFrame;

视频首帧渲染事件回调。视频首帧渲染成功，或播放过程中发生重试，重试后的第一个视频帧渲染成功，均会触发此回调。
传入参数

onFirstAudioFrameRender:isFirstFrame: #

- (void)onFirstAudioFrameRender:(TVLManager *_Nonnull)player isFirstFrame:(BOOL)isFirstFrame;

音频首帧渲染事件回调。音频首帧渲染成功，或播放过程中发生重试，重试后的第一个音频帧渲染成功，均会触发此回调。
传入参数

onStallStart: #

- (void)onStallStart:(TVLManager *_Nonnull)player;

播放卡顿开始回调。
传入参数

onStallEnd: #

- (void)onStallEnd:(TVLManager *_Nonnull)player;

播放卡顿结束回调。音频缓冲区达到起播条件且开始播放后，触发此回调。
传入参数

onVideoRenderStall:stallTime: #

- (void)onVideoRenderStall:(TVLManager *_Nonnull)player stallTime:(int64_t)stallTime;

视频渲染卡顿回调。视频渲染发生卡顿时，触发此回调。
传入参数

onAudioRenderStall:stallTime: #

- (void)onAudioRenderStall:(TVLManager *_Nonnull)player stallTime:(int64_t)stallTime;

音频渲染卡顿回调。音频渲染发生卡顿时，触发此回调。
传入参数

onResolutionSwitch:resolution:error:reason: #

- (void)onResolutionSwitch:(TVLManager *_Nonnull)player resolution:(VeLivePlayerResolution)resolution error:(VeLivePlayerError *)error reason:(VeLivePlayerResolutionSwitchReason)reason;

清晰度档位发生变化回调。
传入参数

onVideoSizeChanged:width:height: #

- (void)onVideoSizeChanged:(TVLManager *_Nonnull)player width:(int)width height:(int)height;

视频分辨率变化回调。视频大小发生变化时，触发此回调。
传入参数

onReceiveSeiMessage:message: #

- (void)onReceiveSeiMessage:(TVLManager *_Nonnull)player message:(NSString *_Nonnull)message;

字符串 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableSei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。
传入参数

onReceiveBinarySeiMessage:message: #

- (void)onReceiveBinarySeiMessage:(TVLManager *_Nonnull)player message:(NSData *_Nonnull)message;

二级制 SEI 消息回调，当播放器 SDK 接收到 SEI 消息时，触发该回调。需要开启 VeLivePlayerConfiguration 中 enableBinarySei 属性。当 enableBinarySei 属性开启时，字符串 SEI 消息将不再发送。
传入参数

onMainBackupSwitch:streamType:error: #

- (void)onMainBackupSwitch:(TVLManager *_Nonnull)player streamType:(VeLivePlayerStreamType)streamType error:(VeLivePlayerError *)error;

主备流切换回调。
传入参数

onStreamFormatSwitch:fromStreamFormat:toStreamFormat:error:extraInfo: #

- (void)onStreamFormatSwitch:(TVLManager *_Nonnull)player fromStreamFormat:(VeLivePlayerFormat)fromStreamType toStreamFormat:(VeLivePlayerFormat)toStreamType error:(VeLivePlayerError *)error extraInfo:(NSDictionary *)extraInfo;

当播放器切换流的格式时，SDK 会触发此回调。
传入参数

onPlayerStatusUpdate:status: #

- (void)onPlayerStatusUpdate:(TVLManager *_Nonnull)player status:(VeLivePlayerStatus)status;

播放状态发生变化时，触发此回调。
传入参数

onStatistics:statistics: #

- (void)onStatistics:(TVLManager *_Nonnull)player statistics:(VeLivePlayerStatistics *_Nonnull)statistics;

播放信息周期性回调。播放器 SDK 会周期性地回调本方法，您可以通过本方法获取当前播放器的播放地址、码率和帧率等信息。
传入参数

onSnapshotComplete:image: #

- (void)onSnapshotComplete:(TVLManager *_Nonnull)player image:(UIImage *_Nonnull)image;

截图成功回调。当播放器调用 snapshot 截图成功后，触发此回调。
传入参数

onRenderVideoFrame:videoFrame: #

- (void)onRenderVideoFrame:(TVLManager *_Nonnull)player videoFrame:(VeLivePlayerVideoFrame *_Nonnull)videoFrame;

视频帧回调。调用 enableVideoFrameObserver:pixelFormat:bufferType: 开启视频帧解析回调后，当播放器成功解码视频帧时，会触发此回调。
传入参数

注意
如果自定义渲染使用纹理格式，建议在视频帧回调线程中执行渲染操作。

onRenderAudioFrame:audioFrame: #

- (void)onRenderAudioFrame:(TVLManager *_Nonnull)player audioFrame:(VeLivePlayerAudioFrame *_Nonnull)audioFrame;

音频帧回调。调用 enableAudioFrameObserver:enableRendering:开启音频帧解析回调后，当播放器成功解码音频帧时，会触发此回调。
传入参数

注意
回调的音频帧数据为 float32 格式，大端字节序存储。

onStreamFailedOpenSuperResolution:error: #

- (void)onStreamFailedOpenSuperResolution:(TVLManager *_Nonnull)player error:(VeLivePlayerError *_Nullable)error;

超分开启失败。调用 setEnableSuperResolution:开启超分后，当播放器不支持超分开启或者超分处理出错时，会触发此回调。
传入参数

getDrmResourceLoaderCertificateData: #

- (nullable NSData *)getDrmResourceLoaderCertificateData:(nonnull TVLManager *_Nonnull)player;

您需要在此回调中返回 FairPlay 证书的 NSData 数据。
传入参数

getDrmResourceLoaderLicenseUrl: #

- (nullable NSString *)getDrmResourceLoaderLicenseUrl:(nonnull TVLManager *_Nonnull)player;

您需要在此回调中返回 DRM license 的 URL。
传入参数