动态与公告

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

聚焦模式

字号

最后更新时间： 2022-10-13 11:40:06

功能
腾讯云直播的播放器回调通知。
介绍
可以接收 V2TXLivePlayer 播放器的一些回调通知，包括播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等。
SDK 基础回调
onError
直播播放器错误通知，播放器出现错误时，会回调该通知。
- (void)onError:(id<V2TXLivePlayer>)player
            code:(V2TXLiveCode)code
         message:(NSString *)msg
       extraInfo:(NSDictionary *)extraInfo
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
code
V2TXLiveCode
错误码。
msg
NSString *
错误信息。
extraInfo
NSDictionary *
扩展信息。
onWarning
直播播放器警告通知。
- (void)onWarning:(id<V2TXLivePlayer>)player
              code:(V2TXLiveCode)code
           message:(NSString *)msg
         extraInfo:(NSDictionary *)extraInfo
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
code
V2TXLiveCode
警告码。
msg
NSString *
警告码信息。
extraInfo
NSDictionary *
扩展信息。
onConnected
已经成功连接到服务器通知。
- (void)onConnected:(id<V2TXLivePlayer>)player 
          extraInfo:(NSDictionary *)extraInfo
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
extraInfo
NSDictionary *
扩展信息。
视频相关回调
onVideoPlaying
视频播放事件通知。
- (void)onVideoPlaying:(id<V2TXLivePlayer>)player
             firstPlay:(BOOL)firstPlay 
             extraInfo:(NSDictionary *)extraInfo
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
firstPlay
BOOL
第一次播放标志。
extraInfo
NSDictionary *
扩展信息。
onVideoLoading
视频加载事件通知。
- (void)onVideoLoading:(id<V2TXLivePlayer>)player
             extraInfo:(NSDictionary *)extraInfo;
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
extraInfo
NSDictionary *
扩展信息。
onVideoResolutionChanged
直播播放器分辨率变化通知。
- (void)onVideoResolutionChanged:(id<V2TXLivePlayer>)player 
                           width:(NSInteger)width 
                          height:(NSInteger)height;
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
width
NSInteger
视频宽
height
NSInteger
视频高
onSnapshotComplete
截图回调。
- (void)onSnapshotComplete:(id<V2TXLivePlayer>)player image:(TXImage *)image
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
image
TXImage *
已截取的视频画面。
onRenderVideoFrame
自定义视频渲染回调。
说明：
调用 [V2TXLivePlayer enableCustomRendering:pixelFormat:bufferType:] 开启自定义渲染之后，会收到这个回调通知。
- (void)onRenderVideoFrame:(id<V2TXLivePlayer>)player
                     frame:(V2TXLiveVideoFrame *)videoFrame
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
videoFrame
V2TXLiveVideoFrame *
视频帧数据。
音频相关回调
onAudioPlaying
音频播放事件通知。
- (void)onAudioPlaying:(id<V2TXLivePlayer>)player 
             firstPlay:(BOOL)firstPlay 
             extraInfo:(NSDictionary *)extraInfo;
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
firstPlay
BOOL
第一次播放标志。
extraInfo
NSDictionary *
扩展信息。
onAudioLoading
音频加载事件通知。
- (void)onAudioLoading:(id<V2TXLivePlayer>)player 
             extraInfo:(NSDictionary *)extraInfo;
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
extraInfo
NSDictionary *
扩展信息。
onPlayoutVolumeUpdate
播放器音量大小回调。
- (void)onPlayoutVolumeUpdate:(id<V2TXLivePlayer>)player volume:(NSInteger)volume
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
volume
NSInteger
音量大小，取值范围：0 - 100。
统计回调
onStatisticsUpdate
直播播放器统计数据回调。
- (void)onStatisticsUpdate:(id<V2TXLivePlayer>)player
                statistics:(V2TXLivePlayerStatistics *)statistics
参数
参数
类型
含义
player
V2TXLivePlayer
回调该通知的播放器对象。
statistics
V2TXLivePlayerStatistics
播放器统计数据。

帮助和支持

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

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

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

文档反馈

tencent cloud

直播 SDK

V2TXLivePlayerObserver

SDK 基础回调

onError

onWarning

onConnected

视频相关回调

onVideoPlaying

onVideoLoading

onVideoResolutionChanged

onSnapshotComplete

onRenderVideoFrame

音频相关回调

onAudioPlaying

onAudioLoading

onPlayoutVolumeUpdate

统计回调

onStatisticsUpdate

帮助和支持

参数	类型	含义
player	V2TXLivePlayer	回调该通知的播放器对象。
code	V2TXLiveCode	错误码。
msg	NSString *	错误信息。
extraInfo	NSDictionary *	扩展信息。