hh_public / hhvDoctorSDK.ios

Go to a project
Toggle navigation Toggle navigation pinning
wangguolei
7ba0724f 1 parent 417b4396

3.1.4.10211533

Inline Side-by-side
Showing 29 changed files with 2996 additions and 447 deletions

Too many changes to show.
Reload with full diff Plain diff Email patch

To preserve performance only 29 of 29+ files are displayed.

Pod::Spec.new do |s|
s.name = "HHVDoctorSDK"
s.version = "3.1.4.092217"
s.version = "3.1.4.10211533"
s.summary = "和缓视频医生 SDK"
s.description = <<-DESC
... ...
This diff could not be displayed because it is too large.
This diff could not be displayed because it is too large.
/*
* Module: 网络音频包UDT自定义数据回调
*
* Function: 给客户回调发送前、接收后的 UDT 自定义数据
*
*/
#ifndef LITEAV_ITRTCAUDIOPACKETLISTENER_H
#define LITEAV_ITRTCAUDIOPACKETLISTENER_H
#include <stdio.h>
#include "TXLiteAVBuffer.h"
namespace liteav {
struct TRTCAudioPacket {
const char *userId;
liteav::TXLiteAVBuffer* extraData;
};
class ITRTCAudioPacketListener {
public:
virtual ~ITRTCAudioPacketListener() {}
/*网络层接收到音频数据包*/
virtual bool onRecvAudioPacket(TRTCAudioPacket &data) { return false; }
/*网络层即将发送的音频数据包*/
virtual bool onSendAudioPacket(TRTCAudioPacket &data) { return false; }
};
}
#endif //LITEAV_ITRTCAUDIOPACKETLISTENER_H
... ...
This diff could not be displayed because it is too large.
This diff could not be displayed because it is too large.
/*
/**
* Module: TRTCCloudDelegate @ TXLiteAVSDK
*
* Function: 腾讯云视频通话功能的事件回调接口
*
* Function: 腾讯云实时音视频的事件回调接口
*/
/// @defgroup TRTCCloudDelegate_ios TRTCCloudDelegate
/// 腾讯云实时音视频的事件回调接口
/// @{
#import <Foundation/Foundation.h>
#import "TRTCCloudDef.h"
#import "TXLiteAVCode.h"
... ... @@ -14,58 +14,61 @@ NS_ASSUME_NONNULL_BEGIN
@class TRTCCloud;
@class TRTCStatistics;
/// @defgroup TRTCCloudDelegate_ios TRTCCloudDelegate
/// 腾讯云视频通话功能的事件回调接口
/// @{
@protocol TRTCCloudDelegate <NSObject>
@optional
/////////////////////////////////////////////////////////////////////////////////
//
// （一）错误事件和警告事件
// 错误和警告事件
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 错误事件和警告事件
/// @name 错误和警告事件
/// @{
/**
* 1.1 错误回调：SDK 不可恢复的错误，一定要监听，并分情况给用户适当的界面提示。
* 1.1 错误事件回调
*
* 错误事件，表示 SDK 抛出的不可恢复的错误，比如进入房间失败或设备开启失败等。
* 参考文档：[错误码表](https://cloud.tencent.com/document/product/647/32257)
*
* @param errCode 错误码
* @param errMsg 错误信息
* @param extInfo 扩展信息字段，个别错误码可能会带额外的信息帮助定位问题
*/
- (void)onError:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary*)extInfo;
- (void)onError:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary *)extInfo;
/**
* 1.2 警告回调：用于告知您一些非严重性问题，例如出现了卡顿或者可恢复的解码失败。
* 1.2 警告事件回调
*
* 警告事件，表示 SDK 抛出的提示性问题，比如视频出现卡顿或 CPU 使用率太高等。
* 参考文档：[错误码表](https://cloud.tencent.com/document/product/647/32257)
*
* @param warningCode 警告码
* @param warningMsg 警告信息
* @param extInfo 扩展信息字段，个别警告码可能会带额外的信息帮助定位问题
*/
- (void)onWarning:(TXLiteAVWarning)warningCode warningMsg:(nullable NSString *)warningMsg extInfo:(nullable NSDictionary*)extInfo;
- (void)onWarning:(TXLiteAVWarning)warningCode warningMsg:(nullable NSString *)warningMsg extInfo:(nullable NSDictionary *)extInfo;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （二）房间事件回调
// 房间相关事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 房间事件回调
/// @name 房间相关事件回调
/// @{
/**
* 2.1 已加入房间的回调
*
* 调用 TRTCCloud 中的 enterRoom() 接口执行进房操作后，会收到来自 SDK 的 onEnterRoom(result) 回调：
* 2.1 进入房间成功与否的事件回调
*
* - 如果加入成功，result 会是一个正数（result > 0），代表加入房间的时间消耗，单位是毫秒（ms）。
* - 如果加入失败，result 会是一个负数（result < 0），代表进房失败的错误码。
* 进房失败的错误码含义请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
* 调用 TRTCCloud 中的 enterRoom() 接口执行进房操作后，会收到来自 TRTCCloudDelegate 的 onEnterRoom(result) 回调：
* - 如果加入成功，回调 result 会是一个正数（result > 0），代表进入房间所消耗的时间，单位是毫秒（ms）。
* - 如果加入失败，回调 result 会是一个负数（result < 0），代表失败原因的错误码。
* 进房失败的错误码含义请参见[错误码表](https://cloud.tencent.com/document/product/647/32257)。
*
* @note 在 Ver6.6 之前的版本，只有进房成功会抛出 onEnterRoom(result) 回调，进房失败由 onError() 回调抛出。
* 在 Ver6.6 及之后改为：进房成功返回正的 result，进房失败返回负的 result，同时进房失败也会有 onError() 回调抛出。
* @note
* 1. 在 Ver6.6 之前的版本，只有进房成功会抛出 onEnterRoom(result) 回调，进房失败由 onError() 回调抛出。
* 2. 在 Ver6.6 之后的版本：无论进房成功或失败，均会抛出 onEnterRoom(result) 回调，同时进房失败也会有 onError() 回调抛出。
*
* @param result result > 0 时为进房耗时（ms），result < 0 时为进房错误码。
*/
... ... @@ -75,12 +78,12 @@ NS_ASSUME_NONNULL_BEGIN
* 2.2 离开房间的事件回调
*
* 调用 TRTCCloud 中的 exitRoom() 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等。
* 待资源释放完毕，SDK 会通过 onExitRoom() 回调通知到您。
* 待 SDK 占用的所有资源释放完毕后，SDK 会抛出 onExitRoom() 回调通知到您。
*
* 如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来之后再执行相关操作。
* 否则可能会遇到音频设备（例如 iOS 里的 AudioSession）被占用等各种异常问题。
* 如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来后再执行相关操作。
* 否则可能会遇到例如摄像头、麦克风设备被强占等各种异常问题。
*
* @param reason 离开房间原因，0：主动调用 exitRoom 退房；1：被服务器踢出当前房间；2：当前房间整个被解散。
* @param reason 离开房间原因，0：主动调用 exitRoom 退出房间；1：被服务器踢出当前房间；2：当前房间整个被解散。
*/
- (void)onExitRoom:(NSInteger)reason;
... ... @@ -96,285 +99,370 @@ NS_ASSUME_NONNULL_BEGIN
- (void)onSwitchRole:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg;
/**
* 2.4 请求跨房通话（主播 PK）的结果回调
* 2.4 切换房间的结果回调
*
* 调用 TRTCCloud 中的 switchRoom() 接口可以让用户快速地从一个房间切换到另一个房间，
* 待 SDK 切换完成后，会抛出 onSwitchRoom() 事件回调。
*
* @param errCode 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
* @param errMsg 错误信息。
*/
- (void)onSwitchRoom:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg;
/**
* 2.5 请求跨房通话的结果回调
*
* 调用 TRTCCloud 中的 connectOtherRoom() 接口会将两个不同房间中的主播拉通视频通话，也就是所谓的“主播PK”功能。
* 调用者会收到 onConnectOtherRoom() 回调来获知跨房通话是否成功，
* 如果成功，两个房间中的所有用户都会收到 PK 主播的 onUserVideoAvailable() 回调。
* 如果成功，两个房间中的所有用户都会收到来自另一个房间中的 PK 主播的 onUserVideoAvailable() 回调。
*
* @param userId 要 PK 的目标主播 userid。
* @param userId 要跨房通话的另一个房间中的主播的用户 ID。
* @param errCode 错误码，ERR_NULL 代表切换成功，其他请参见[错误码](https://cloud.tencent.com/document/product/647/32257)。
* @param errMsg 错误信息。
*/
- (void)onConnectOtherRoom:(NSString*)userId errCode:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg;
- (void)onConnectOtherRoom:(NSString *)userId errCode:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg;
/**
* 2.5 结束跨房通话（主播 PK）的结果回调
* 2.6 结束跨房通话的结果回调
*/
- (void)onDisconnectOtherRoom:(TXLiteAVError)errCode errMsg:(nullable NSString *)errMsg;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （三）成员事件回调
// 用户相关事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 成员事件回调
/// @name 用户相关事件回调
/// @{
/**
* 3.1 有用户加入当前房间
*
* 出于性能方面的考虑，在两种不同的应用场景下，该通知的行为会有差别：
* - 通话场景（TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall）：该场景下用户没有角色的区别，任何用户进入房间都会触发该通知。
* - 直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）：该场景不限制观众的数量，如果任何用户进出都抛出回调会引起很大的性能损耗，所以该场景下只有主播进入房间时才会触发该通知，观众进入房间不会触发该通知。
*
* 出于性能方面的考虑，在 TRTC 两种不同的应用场景（即 AppScene，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
* - 直播类场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）：该场景下的用户区分主播和观众两种角色，只有主播进入房间时才会触发该通知，观众进入房间时不会触发该通知。
* - 通话类场景（TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall）：该场景下的用户没有角色的区分（可认为都是主播），任何用户进入房间都会触发该通知。
*
* @note 注意 onRemoteUserEnterRoom 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“成员列表”，如果需要显示远程画面，建议使用监听 onUserVideoAvailable() 事件回调。
*
* @param userId 用户标识
* @note
* 1. 事件回调 onRemoteUserEnterRoom 和 onRemoteUserLeaveRoom 只适用于维护当前房间里的“用户列表”，有此事件回调不代表一定有视频画面。
* 2. 如果需要显示远程画面，请监听代表某个用户是否有视频画面的 onUserVideoAvailable() 事件回调。
* @param userId 远端用户的用户标识
*/
- (void)onRemoteUserEnterRoom:(NSString *)userId;
/**
* 3.2 有用户离开当前房间
*
* 与 onRemoteUserEnterRoom 相对应，在两种不同的应用场景下，该通知的行为会有差别：
* - 通话场景（TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall）：该场景下用户没有角色的区别，任何用户的离开都会触发该通知。
* - 直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）：只有主播离开房间时才会触发该通知，观众离开房间不会触发该通知。
* 与 onRemoteUserEnterRoom 相对应，在两种不同的应用场景（即 AppScene，在 enterRoom 时通过第二个参数指定）下，该通知的行为会有差别：
* - 直播类场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom）：只有主播离开房间时才会触发该通知，观众离开房间不会触发该通知。
* - 通话类场景（TRTCAppSceneVideoCall 和 TRTCAppSceneAudioCall）：该场景下用户没有角色的区别，任何用户的离开都会触发该通知。
*
* @param userId 用户标识
* @param userId 远端用户的用户标识
* @param reason 离开原因，0表示用户主动退出房间，1表示用户超时退出，2表示被踢出房间。
*/
- (void)onRemoteUserLeaveRoom:(NSString *)userId reason:(NSInteger)reason;
/**
* 3.3 用户是否开启摄像头视频
* 3.3 某远端用户发布/取消了主路视频画面
*
* 当您收到 onUserVideoAvailable(userid, YES) 通知时，表示该路画面已经有可用的视频数据帧到达。
* 此时，您需要调用 startRemoteView(userid) 接口加载该用户的远程画面。
* 然后，您会收到名为 onFirstVideoFrame(userid) 的首帧画面渲染回调。
* “主路画面”一般被用于承载摄像头画面。当您收到 onUserVideoAvailable(userId, true) 通知时，表示该路画面已经有可播放的视频帧到达。
* 此时，您需要调用 {@link startRemoteView} 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 onFirstVideoFrame(userid)。
*
* 当您收到 onUserVideoAvailable(userid, NO) 通知时，表示该路远程画面已被关闭，
* 可能由于该用户调用了 muteLocalVideo() 或 stopLocalPreview()。
* 当您收到 onUserVideoAvailable(userId, false) 通知时，表示该路远程画面已经被关闭，关闭的原因可能是该用户调用了 {@link muteLocalVideo} 或 {@link stopLocalPreview}。
*
* @param userId 用户标识
* @param available 画面是否开启
* @param userId 远端用户的用户标识
* @param available 该用户是否发布（或取消发布）了主路视频画面，true: 发布；false：取消发布。
*/
- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available;
/**
* 3.4 用户是否开启屏幕分享
* 3.4 某远端用户发布/取消了辅路视频画面
*
* @note 显示辅路画面使用的函数是 startRemoteSubStreamView() 而非 startRemoteView()。
* @param userId 用户标识
* @param available 屏幕分享是否开启
* “辅路画面”一般被用于承载屏幕分享的画面。当您收到 onUserSubStreamAvailable(userId, true) 通知时，表示该路画面已经有可播放的视频帧到达。
* 此时，您需要调用 {@link startRemoteSubStreamView} 接口订阅该用户的远程画面，订阅成功后，您会继续收到该用户的首帧画面渲染回调 onFirstVideoFrame(userid)。
*
* @note 显示辅路画面使用的函数是 {@link startRemoteSubStreamView} 而非 {@link startRemoteView}。
*
* @param userId 远端用户的用户标识
* @param available 该用户是否发布（或取消发布）了辅路视频画面，true: 发布；false：取消发布。
*/
- (void)onUserSubStreamAvailable:(NSString *)userId available:(BOOL)available;
/**
* 3.5 用户是否开启音频上行
* 3.5 某远端用户发布/取消了自己的音频
*
* @param userId 用户标识
* @param available 声音是否开启
* 当您收到 onUserAudioAvailable(userId, true) 通知时，表示该用户发布了自己的声音，此时 SDK 的表现为：
* - 在自动订阅模式下，您无需做任何操作，SDK 会自动播放该用户的声音。
* - 在手动订阅模式下，您可以通过 {@link muteRemoteAudio}(userid, false) 来播放该用户的声音。
*
* @note SDK 默认使用自动订阅模式，您可以通过 {@link setDefaultStreamRecvMode} 设置为手动订阅，但需要在您进入房间之前调用才生效。
*
* @param userId 远端用户的用户标识
* @param available 该用户是否发布（或取消发布）了自己的音频，true: 发布；false：取消发布。
*/
- (void)onUserAudioAvailable:(NSString *)userId available:(BOOL)available;
/**
* 3.6 开始渲染本地或远程用户的首帧画面
* 3.6 SDK 开始渲染自己本地或远端用户的首帧画面
*
* 如果 userId == nil，代表开始渲染本地采集的摄像头画面，需要您先调用 startLocalPreview 触发。
* 如果 userId != nil，代表开始渲染远程用户的首帧画面，需要您先调用 startRemoteView 触发。
* SDK 会在渲染自己本地或远端用户的首帧画面时抛出该事件，您可以通过回调事件中的 userId 参数来判断事件来自于“本地”还是来自于“远端”。
* - 如果 userId 为空值，代表 SDK 已经开始渲染自己本地的视频画面，不过前提是您已经调用了 {@link startLocalPreview} 或 {@link startScreenCapture}。
* - 如果 userId 不为空，代表 SDK 已经开始渲染远端用户的视频画面，不过前提是您已经调用了 {@link startRemoteView} 订阅了该用户的视频画面。
*
* @note 只有当您调用 startLocalPreivew()、startRemoteView() 或 startRemoteSubStreamView() 之后，才会触发该回调。
* @note
* 1. 只有当您调用了 {@link startLocalPreview} 或 {@link startScreenCapture} 之后，才会触发自己本地的首帧画面事件回调。
* 2. 只有当您调用了 {@link startRemoteView} 或 {@link startRemoteSubStreamView} 之后，才会触发远端用户的首帧画面事件回调。
*
* @param userId 本地或远程用户 ID，如果 userId == nil 代表本地，userId != nil 代表远程。
* @param streamType 视频流类型：摄像头或屏幕分享。
* @param width 画面宽度
* @param height 画面高度
* @param userId 本地或远端的用户标识，如果 userId 为空值代表自己本地的首帧画面已到来，userId 不为空则代表远端用户的首帧画面已到来。
* @param streamType 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。
* @param width 画面的宽度。
* @param height 画面的高度。
*/
- (void)onFirstVideoFrame:(NSString*)userId streamType:(TRTCVideoStreamType)streamType width:(int)width height:(int)height;
- (void)onFirstVideoFrame:(NSString *)userId streamType:(TRTCVideoStreamType)streamType width:(int)width height:(int)height;
/**
* 3.7 开始播放远程用户的首帧音频（本地声音暂不通知）
* 3.7 SDK 开始播放远端用户的首帧音频
*
* SDK 会在播放远端用户的首帧音频时抛出该事件，本地音频的首帧事件暂不抛出。
*
* @param userId 远程用户 ID。
* @param userId 远端用户的用户标识
*/
- (void)onFirstAudioFrame:(NSString*)userId;
- (void)onFirstAudioFrame:(NSString *)userId;
/**
* 3.8 首帧本地视频数据已经被送出
* 3.8 自己本地的首个视频帧已被发布出去
*
* SDK 会在 enterRoom() 并 startLocalPreview() 成功后开始摄像头采集，并将采集到的画面进行编码。
* 当 SDK 成功向云端送出第一帧视频数据后，会抛出这个回调事件。
* 当您成功进入房间并通过 {@link startLocalPreview} 或 {@link startScreenCapture} 开启本地视频采集之后（开启采集和进入房间的先后顺序无影响），
* SDK 就会开始进行视频编码，并通过自身的网络模块向云端发布自己本地的视频数据。
* 当 SDK 成功地向云端送出自己的第一帧视频数据帧以后，就会抛出 onSendFirstLocalVideoFrame 事件回调。
*
* @param streamType 视频流类型，主画面、小画面或辅流画面（屏幕分享）
* @param streamType 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。
*/
- (void)onSendFirstLocalVideoFrame: (TRTCVideoStreamType)streamType;
- (void)onSendFirstLocalVideoFrame:(TRTCVideoStreamType)streamType;
/**
* 3.9 首帧本地音频数据已经被送出
* 3.9 自己本地的首个音频帧已被发布出去
*
* SDK 会在 enterRoom() 并 startLocalAudio() 成功后开始麦克风采集，并将采集到的声音进行编码。
* 当 SDK 成功向云端送出第一帧音频数据后，会抛出这个回调事件。
* 当您成功进入房间并通过 {@link startLocalAudio} 开启本地音频采集之后（开启采集和进入房间的先后顺序无影响），
* SDK 就会开始进行音频编码，并通过自身的网络模块向云端发布自己本地的音频数据。
* 当 SDK 成功地向云端送出自己的第一帧音频数据帧以后，就会抛出 onSendFirstLocalAudioFrame 事件回调。
*/
- (void)onSendFirstLocalAudioFrame;
/**
* 3.10 废弃接口：有主播加入当前房间
*
* 该回调接口可以被看作是 onRemoteUserEnterRoom 的废弃版本，不推荐使用。请使用 onUserVideoAvailable 或 onRemoteUserEnterRoom 进行替代。
*
* @note 该接口已被废弃，不推荐使用
* 3.10 远端视频状态变化的事件回调
*
* 您可以通过此事件回调获取远端每一路画面的播放状态（包括 Playing、Loading 和 Stopped 三种状态），从而进行相应的 UI 展示。
* @param userId 用户标识
* @param streamType 视频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。
* @param status 视频状态：包括 Playing、Loading 和 Stopped 三种状态。
* @param reason 视频状态改变的原因
* @param extrainfo 额外信息
*/
- (void)onUserEnter:(NSString *)userId DEPRECATED_ATTRIBUTE;
/**
* 3.11 废弃接口： 有主播离开当前房间
*
* 该回调接口可以被看作是 onRemoteUserLeaveRoom 的废弃版本，不推荐使用。请使用 onUserVideoAvailable 或 onRemoteUserEnterRoom 进行替代。
*
* @note 该接口已被废弃，不推荐使用
*
* @param userId 用户标识
* @param reason 离开原因。
*/
- (void)onUserExit:(NSString *)userId reason:(NSInteger)reason DEPRECATED_ATTRIBUTE;
- (void)onRemoteVideoStatusUpdated:(NSString *)userId streamType:(TRTCVideoStreamType)streamType streamStatus:(TRTCAVStatusType)status reason:(TRTCAVStatusChangeReason)reason extrainfo:(nullable NSDictionary *)info;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （四）统计和质量回调
// 网络和技术指标统计回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 统计和质量回调
/// @name 网络和技术指标统计回调
/// @{
/**
* 4.1 网络质量：该回调每2秒触发一次，统计当前网络的上行和下行质量
* 4.1 网络质量的实时统计回调
*
* 该统计回调每间隔2秒抛出一次，用于通知 SDK 感知到的当前网络的上行和下行质量。
* SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽大小以及稳定情况进行评估，并计算出一个的评估结果：
* 如果评估结果为 1（Excellent） 代表当前的网络情况非常好，如果评估结果为 6（Down）代表当前网络无法支撑 TRTC 的正常通话。
*
* @note userId == nil 代表自己当前的视频质量
* @note 回调参数 localQuality 和 remoteQuality 中的 userId 如果为空置，代表本组数据统计的是自己本地的网络质量，否则是代表远端用户的网络质量。
*
* @param localQuality 上行网络质量
* @param remoteQuality 下行网络质量
*/
- (void)onNetworkQuality: (TRTCQualityInfo*)localQuality remoteQuality:(NSArray<TRTCQualityInfo*>*)remoteQuality;
- (void)onNetworkQuality:(TRTCQualityInfo *)localQuality remoteQuality:(NSArray<TRTCQualityInfo *> *)remoteQuality;
/**
* 4.2 技术指标统计回调
* 4.2 音视频技术指标的实时统计回调
*
* 如果您是熟悉音视频领域相关术语，可以通过这个回调获取 SDK 的所有技术指标。
* 如果您是首次开发音视频相关项目，可以只关注 onNetworkQuality 回调。
* 该统计回调每间隔2秒抛出一次，用于通知 SDK 内部音频、视频以及网络相关的专业技术指标，这些信息在 {@link TRTCStatistics} 均有罗列：
* - 视频统计信息：视频的分辨率（resolution）、帧率（FPS）和比特率（bitrate）等信息。
* - 音频统计信息：音频的采样率（samplerate）、声道（channel）和比特率（bitrate）等信息。
* - 网络统计信息：SDK 和云端一次往返（SDK => Cloud => SDK）的网络耗时（rtt）、丢包率（loss）、上行流量（sentBytes）和下行流量（receivedBytes）等信息。
*
* @param statistics 统计数据，包括本地和远程的
* @note 每2秒回调一次
* @note 如果您只需要获知当前网络质量的好坏，并不需要花太多时间研究本统计回调，更推荐您使用 {@link onNetworkQuality} 来解决问题。
* @param statistics 统计数据，包括自己本地的统计信息和远端用户的统计信息，详情请参考 {@link TRTCStatistics}。
*/
- (void)onStatistics: (TRTCStatistics *)statistics;
- (void)onStatistics:(TRTCStatistics *)statistics;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （五）服务器事件回调
// 与云端连接情况的事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 服务器事件回调
/// @name 与云端连接情况的事件回调
/// @{
/**
* 5.1 SDK 跟服务器的连接断开
* 5.1 SDK 与云端的连接已经断开
*
* SDK 会在跟云端的连接断开时抛出此事件回调，导致断开的原因大多是网络不可用或者网络切换所致，比如用户在通话中走进电梯时就可能会遇到此事件。
* 在抛出此事件之后，SDK 会努力跟云端重新建立连接，重连过程中会抛出 {@link onTryToReconnect}，连接恢复后会抛出 {@link onConnectionRecovery} 。
* 所以，SDK 会在如下三个连接相关的事件中按如下规律切换：
* <pre>
* [onConnectionLost] =====> [onTryToReconnect] =====> [onConnectionRecovery]
* /|\ |
* |------------------------------------------------------|
* </pre>
*/
- (void)onConnectionLost;
/**
* 5.2 SDK 尝试重新连接到服务器
* 5.2 SDK 正在尝试重新连接到云端
*
* SDK 会在跟云端的连接断开时抛出 {@link onConnectionLost}，之后会努力跟云端重新建立连接并抛出本事件，连接恢复后会抛出 {@link onConnectionRecovery}。
*/
- (void)onTryToReconnect;
/**
* 5.3 SDK 跟服务器的连接恢复
* 5.3 SDK 与云端的连接已经恢复
*
* SDK 会在跟云端的连接断开时抛出 {@link onConnectionLost}，之后会努力跟云端重新建立连接并抛出{@link onTryToReconnect}，连接恢复后会抛出本事件回调。
*/
- (void)onConnectionRecovery;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （六）硬件设备事件回调
// 硬件设备相关事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 硬件设备事件回调
/// @name 硬件设备相关事件回调
/// @{
/**
* 6.1 摄像头准备就绪
*
* 当您调用 {@link startLocalPreivew} 之后，SDK 会尝试启动摄像头，如果摄像头能够启动成功就会抛出本事件。
* 如果启动失败，大概率是因为当前应用没有获得访问摄像头的权限，或者摄像头当前正在被其他程序独占使用中。
* 您可以通过捕获 {@link onError} 事件回调获知这些异常情况并通过 UI 界面提示用户。
*/
- (void)onCameraDidReady;
/**
* 6.2 麦克风准备就绪
*
* 当您调用 {@link startLocalAudio} 之后，SDK 会尝试启动麦克风，如果麦克风能够启动成功就会抛出本事件。
* 如果启动失败，大概率是因为当前应用没有获得访问麦克风的权限，或者麦克风当前正在被其他程序独占使用中。
* 您可以通过捕获 {@link onError} 事件回调获知这些异常情况并通过 UI 界面提示用户。
*/
- (void)onMicDidReady;
#if TARGET_OS_IPHONE
/**
* 6.3 音频路由发生变化（仅 iOS），音频路由即声音由哪里输出（扬声器、听筒）
* 6.3 当前音频路由发生变化（仅适用于移动设备）
*
* 所谓“音频路由”，是指声音是从手机的扬声器还是从听筒中播放出来，音频路由变化也就是声音的播放位置发生了变化。
* - 当音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
* - 当音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。
*
* @param route 当前音频路由
* @param fromRoute 变更前的音频路由
* @param route 音频路由，即声音由哪里输出（扬声器、听筒）。
* @param fromRoute 变更前的音频路由。
*/
#if TARGET_OS_IPHONE
- (void)onAudioRouteChanged:(TRTCAudioRoute)route fromRoute:(TRTCAudioRoute)fromRoute;
#endif
/**
* 6.4 用于提示音量大小的回调,包括每个 userId 的音量和远端总音量
* 6.4 音量大小的反馈回调
*
* 您可以通过调用 TRTCCloud 中的 enableAudioVolumeEvaluation 接口来开关这个回调或者设置它的触发间隔。
* 需要注意的是，调用 enableAudioVolumeEvaluation 开启音量回调后，无论频道内是否有人说话，都会按设置的时间间隔调用这个回调;
* 如果没有人说话，则 userVolumes 为空，totalVolume 为0。
* SDK 可以评估每一路音频的音量大小，并每隔一段时间抛出该事件回调，您可以根据音量大小在 UI 上做出相应的提示，比如“波形图”或“音量槽”。
* 要完成这个功能， 您需要先调用 {@link enableAudioVolumeEvaluation} 开启这个能力并设定事件抛出的时间间隔。
* 需要补充说明的是，无论当前房间中是否有人说话，SDK 都会按照您设定的时间间隔定时抛出此事件回调，只不过当没有人说话时，userVolumes 为空，totalVolume 为 0。
*
* @param userVolumes 所有正在说话的房间成员的音量，取值范围0 - 100。
* @param totalVolume 所有远端成员的总音量, 取值范围0 - 100。
* @note userId 为 nil 时表示自己的音量，userVolumes 内仅包含正在说话（音量不为0）的用户音量信息。
* @note userVolumes 为一个数组，对于数组中的每一个元素，当 userId 为空时表示本地麦克风采集的音量大小，当 userId 不为空时代表远端用户的音量大小。
*
* @param userVolumes 是一个数组，用于承载所有正在说话的用户的音量大小，取值范围 0 - 100。
* @param totalVolume 所有远端用户的总音量大小, 取值范围 0 - 100。
*/
- (void)onUserVoiceVolume:(NSArray<TRTCVolumeInfo *> *)userVolumes totalVolume:(NSInteger)totalVolume;
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
/**
* 6.5 本地设备通断回调
* 6.5 本地设备的通断状态发生变化（仅适用于桌面系统）
*
* 当本地设备（包括摄像头、麦克风以及扬声器）被插入或者拔出时，SDK 便会抛出此事件回调。
*
* @param deviceId 设备 ID
* @param deviceType 设备类型
* @param state 0：设备断开；1：设备连接
* @param state 通断状态，0：设备断开；1：设备连接。
*/
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
- (void)onDevice:(NSString *)deviceId type:(TRTCMediaDeviceType)deviceType stateChanged:(NSInteger)state;
#endif
/**
* 6.6 当前麦克风的系统采集音量发生变化
*
* 在 Mac 或 Windows 这样的桌面操作系统上，用户可以在设置中心找到声音相关的设置面板，并设置麦克风的采集音量大小。
* 用户将麦克风的采集音量设置得越大，麦克风采集到的声音的原始音量也就会越大，反之就会越小。
* 在有些型号的键盘以及笔记本电脑上，用户还可以通过按下“禁用麦克风”按钮（图标是一个话筒上上叠加了一道代表禁用的斜线）来将麦克风静音。
*
* 当用户通过系统设置界面或者通过键盘上的快捷键设定操作系统的麦克风采集音量时，SDK 便会抛出此事件。
*
* @note 您需要调用 {@link enableAudioVolumeEvaluation} 接口并设定（interval>0）开启次事件回调，设定（interval == 0）关闭此事件回调。
*
* @param volume 系统采集音量，取值范围 0 - 100，用户可以在系统的声音设置面板上进行拖拽调整。
* @param muted 麦克风是否被用户禁用了：true 被禁用，false 被启用。
*/
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
- (void)onAudioDeviceCaptureVolumeChanged:(NSInteger)volume muted:(BOOL)muted;
#endif
/// @}
/**
* 6.7 当前系统的播放音量发生变化
*
* 在 Mac 或 Windows 这样的桌面操作系统上，用户可以在设置中心找到声音相关的设置面板，并设置系统的播放音量大小。
* 在有些型号的键盘以及笔记本电脑上，用户还可以通过按下“静音”按钮（图标是一个喇叭上叠加了一道代表禁用的斜线）来将系统静音。
*
* 当用户通过系统设置界面或者通过键盘上的快捷键设定操作系统的播放音量时，SDK 便会抛出此事件。
*
* @note 您需要调用 {@link enableAudioVolumeEvaluation} 接口并设定（interval>0）开启次事件回调，设定（interval == 0）关闭此事件回调。
*
* @param volume 系统播放音量，取值范围 0 - 100，用户可以在系统的声音设置面板上进行拖拽调整。
* @param muted 系统是否被用户静音了：true 被静音，false 已恢复。
*/
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
- (void)onAudioDevicePlayoutVolumeChanged:(NSInteger)volume muted:(BOOL)muted;
#endif
/**
* 6.8 系统声音采集是否被成功开启的事件回调（仅适用于 Mac 系统）
*
* 在 Mac 系统上，您可以通过调用 {@link startSystemAudioLoopback} 为当前系统安装一个音频驱动，并让 SDK 通过该音频驱动捕获当前 Mac 系统播放出的声音。
* 当用于播片教学或音乐直播中，比如老师端可以使用此功能，让 SDK 能够采集老师所播放的电影中的声音，使同房间的学生端也能听到电影中的声音。
* SDK 会将统声音采集是否被成功开启的结果，通过本事件回调抛出，需要您关注参数中的错误码。
*
* @param err ERR_NULL 表示成功，其余值表示失败。
*/
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
- (void)onSystemAudioLoopbackError:(TXLiteAVError)err;
#endif
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （七）自定义消息的接收回调
// 自定义消息的接收事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 自定义消息的接收回调
/// @name 自定义消息的接收事件回调
/// @{
/**
* 7.1 收到自定义消息回调
* 7.1 收到自定义消息的事件回调
*
* 当房间中的某个用户使用 sendCustomCmdMsg 发送自定义消息时，房间中的其它用户可以通过 onRecvCustomCmdMsg 接口接收消息
* 当房间中的某个用户使用 {@link sendCustomCmdMsg} 发送自定义 UDP 消息时，房间中的其它用户可以通过 onRecvCustomCmdMsg 事件回调接收到该条消息。
*
* @param userId 用户标识
* @param cmdID 命令 ID
... ... @@ -384,9 +472,9 @@ NS_ASSUME_NONNULL_BEGIN
- (void)onRecvCustomCmdMsgUserId:(NSString *)userId cmdID:(NSInteger)cmdID seq:(UInt32)seq message:(NSData *)message;
/**
* 7.2 自定义消息丢失回调
* 7.2 自定义消息丢失的事件回调
*
* 实时音视频使用 UDP 通道，即使设置了可靠传输（reliable），也无法确保100@%不丢失，只是丢消息概率极低，能满足常规可靠性要求。
* 当您使用 {@link sendCustomCmdMsg} 发送自定义 UDP 消息时，即使设置了可靠传输（reliable），也无法确保100@%不丢失，只是丢消息概率极低，能满足常规可靠性要求。
* 在发送端设置了可靠运输（reliable）后，SDK 都会通过此回调通知过去时间段内（通常为5s）传输途中丢失的自定义消息数量统计信息。
*
* @note 只有在发送端设置了可靠传输（reliable），接收方才能收到消息的丢失回调
... ... @@ -400,212 +488,395 @@ NS_ASSUME_NONNULL_BEGIN
/**
* 7.3 收到 SEI 消息的回调
*
* 当房间中的某个用户使用 sendSEIMsg 发送数据时，房间中的其它用户可以通过 onRecvSEIMsg 接口接收数据。
* 当房间中的某个用户使用 {@link sendSEIMsg} 借助视频数据帧发送 SEI 消息时，房间中的其它用户可以通过 onRecvSEIMsg 事件回调接收到该条消息。
*
* @param userId 用户标识
* @param message 数据
*/
- (void)onRecvSEIMsg:(NSString *)userId message:(NSData*)message;
- (void)onRecvSEIMsg:(NSString *)userId message:(NSData *)message;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （八）CDN 旁路回调
// CDN 相关事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name CDN 旁路转推回调
/// @name CDN 相关事件回调
/// @{
/**
* 8.1 开始向腾讯云的直播 CDN 推流的回调，对应于 TRTCCloud 中的 startPublishing() 接口
* 8.1 开始向腾讯云直播 CDN 上发布音视频流的事件回调
*
* 当您调用 {@link startPublishing} 开始向腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
* 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
*
* @param err 0表示成功，其余值表示失败
* @param errMsg 具体错误原因
*/
- (void)onStartPublishing:(int)err errMsg:(NSString*)errMsg;
- (void)onStartPublishing:(int)err errMsg:(NSString *)errMsg;
/**
* 8.2 停止向腾讯云的直播 CDN 推流的回调，对应于 TRTCCloud 中的 stopPublishing() 接口
* 8.2 停止向腾讯云直播 CDN 上发布音视频流的事件回调
*
* 当您调用 {@link stopPublishing} 停止向腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
* 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
*
* @param err 0表示成功，其余值表示失败
* @param errMsg 具体错误原因
*/
- (void)onStopPublishing:(int)err errMsg:(NSString*)errMsg;
- (void)onStopPublishing:(int)err errMsg:(NSString *)errMsg;
/**
* 8.3 启动旁路推流到 CDN 完成的回调
* 8.3 开始向非腾讯云 CDN 上发布音视频流的事件回调
*
* 对应于 TRTCCloud 中的 startPublishCDNStream() 接口
* 当您调用 {@link startPublishCDNStream} 开始向非腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
* 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
*
* @note Start 回调如果成功，只能说明转推请求已经成功告知给腾讯云，如果目标 CDN 有异常，还是有可能会转推失败。
* @note 当您收到成功的事件回调时，只是说明您的发布指令已经同步到腾讯云后台服务器，但如果目标 CDN 厂商的服务器不接收该条视频流，依然可能导致发布失败。
* @param err 0表示成功，其余值表示失败
* @param errMsg 具体错误原因
*/
- (void)onStartPublishCDNStream:(int)err errMsg:(NSString *)errMsg;
/**
* 8.4 停止旁路推流到 CDN 完成的回调
* 8.4 停止向非腾讯云 CDN 上发布音视频流的事件回调
*
* 对应于 TRTCCloud 中的 stopPublishCDNStream() 接口
* 当您调用 {@link stopPublishCDNStream} 开始向非腾讯云直播 CDN 上发布音视频流时，SDK 会立刻将这一指令同步给云端服务器。
* 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
*
* @param err 0表示成功，其余值表示失败
* @param errMsg 具体错误原因
*/
- (void)onStopPublishCDNStream:(int)err errMsg:(NSString *)errMsg;
/**
* 8.5 设置云端的混流转码参数的回调，对应于 TRTCCloud 中的 setMixTranscodingConfig() 接口
* 8.5 设置云端混流的排版布局和转码参数的事件回调
*
* @param err 0表示成功，其余值表示失败
* @param errMsg 具体错误原因
* 当您调用 {@link setMixTranscodingConfig} 调整云端混流的排版布局和转码参数时，SDK 会立刻将这一调整指令同步给云端服务器。
* 随后 SDK 会收到来自云端服务器的处理结果，并将指令的执行结果通过本事件回调通知给您。
*
* @param err 错误码：0表示成功，其余值表示失败。
* @param errMsg 具体的错误原因。
*/
- (void)onSetMixTranscodingConfig:(int)err errMsg:(NSString*)errMsg;
- (void)onSetMixTranscodingConfig:(int)err errMsg:(NSString *)errMsg;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （九）音效回调
// 屏幕分享相关事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 音效回调
/// @name 屏幕分享相关事件回调
/// @{
/**
* 9.1 屏幕分享开启的事件回调
*
* 当您通过 {@link startScreenCapture} 等相关接口启动屏幕分享时，SDK 便会抛出此事件回调。
*/
- (void)onScreenCaptureStarted;
/**
* 9.2 屏幕分享暂停的事件回调
*
* 当您通过 {@link pauseScreenCapture} 暂停屏幕分享时，SDK 便会抛出此事件回调。
* @param reason 原因。
* - 0：用户主动暂停。
* - 1：注意此字段的含义在 MAC 和 Windows 平台有稍微差异。屏幕窗口不可见暂停（Mac）。表示设置屏幕分享参数导致的暂停（Windows）。
* - 2：表示屏幕分享窗口被最小化导致的暂停（仅 Windows）。
* - 3：表示屏幕分享窗口被隐藏导致的暂停（仅 Windows）。
*/
- (void)onScreenCapturePaused:(int)reason;
/**
* 播放音效结束回调
* 9.3 屏幕分享恢复的事件回调
*
* @param effectId 音效 ID
* @param code 0表示播放正常结束；其他表示异常结束
* 当您通过 {@link resumeScreenCapture} 恢复屏幕分享时，SDK 便会抛出此事件回调。
* @param reason 恢复原因。
* - 0：用户主动恢复。
* - 1：注意此字段的含义在 MAC 和 Windows 平台有稍微差异。屏幕窗口恢复可见从而恢复分享（Mac）。屏幕分享参数设置完毕后自动恢复（Windows）
* - 2：表示屏幕分享窗口从最小化被恢复（仅 Windows）。
* - 3：表示屏幕分享窗口从隐藏被恢复（仅 Windows）。
*/
- (void)onAudioEffectFinished:(int) effectId code:(int) code;
- (void)onScreenCaptureResumed:(int)reason;
/**
* 9.4 屏幕分享停止的事件回调
*
* 当您通过 {@link stopScreenCapture} 停止屏幕分享时，SDK 便会抛出此事件回调。
* @param reason 停止原因，0：用户主动停止；1：屏幕窗口关闭导致停止；2：表示屏幕分享的显示屏状态变更（如接口被拔出、投影模式变更等）。
*/
- (void)onScreenCaptureStoped:(int)reason;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （十）屏幕分享回调
// 本地录制和本地截图的事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 屏幕分享回调
/// @name 本地录制和本地截图的事件回调
/// @{
/**
* 10.1 当屏幕分享开始时，SDK 会通过此回调通知
* 10.1 本地录制任务已经开始的事件回调
*
* 当您调用 {@link startLocalRecording} 启动本地媒体录制任务时，SDK 会抛出该事件回调，用于通知您录制任务是否已经顺利启动。
* @param errCode 错误码 0：初始化录制成功；-1：初始化录制失败；-2: 文件后缀名有误。
* @param storagePath 录制文件存储路径
*/
- (void)onScreenCaptureStarted;
- (void)onLocalRecordBegin:(NSInteger)errCode storagePath:(NSString *)storagePath;
/**
* 10.2 当屏幕分享暂停时，SDK 会通过此回调通知
* 10.2 本地录制任务正在进行中的进展事件回调
*
* 当您调用 {@link startLocalRecording} 成功启动本地媒体录制任务后，SDK 变会定时地抛出本事件回调。
* 您可通过捕获该事件回调来获知录制任务的健康状况。
* 您可以在 {@link startLocalRecording} 时设定本事件回调的抛出间隔。
*
* @param reason 原因，0：用户主动暂停；1：屏幕窗口不可见暂停
* @param duration 已经录制的累计时长，单位毫秒
* @param storagePath 录制文件存储路径
*/
- (void)onScreenCapturePaused:(int)reason;
- (void)onLocalRecording:(NSInteger)duration storagePath:(NSString *)storagePath;
/**
* 10.3 当屏幕分享恢复时，SDK 会通过此回调通知
* 10.3 本地录制任务已经结束的事件回调
*
* @param reason 恢复原因，0：用户主动恢复；1：屏幕窗口恢复可见从而恢复分享
* 当您调用 {@link stopLocalRecording} 停止本地媒体录制任务时，SDK 会抛出该事件回调，用于通知您录制任务的最终结果。
* @param errCode 错误码 0：录制成功；-1：录制失败；-2：切换分辨率或横竖屏导致录制结束。
* @param storagePath 录制文件存储路径
*/
- (void)onScreenCaptureResumed:(int)reason;
- (void)onLocalRecordComplete:(NSInteger)errCode storagePath:(NSString *)storagePath;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 废弃的事件回调（建议使用对应的新回调）
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 废弃的事件回调（建议使用对应的新回调）
/// @{
/**
* 10.4 当屏幕分享停止时，SDK 会通过此回调通知
* 有主播加入当前房间（已废弃）
*
* @param reason 停止原因，0：用户主动停止；1：屏幕窗口关闭导致停止
* @deprecated 新版本开始不推荐使用，建议使用 {@link onRemoteUserEnterRoom} 替代之。
*/
- (void)onScreenCaptureStoped:(int)reason;
/// @}
@end
- (void)onUserEnter:(NSString *)userId __attribute__((deprecated("use onRemoteUserLeaveRoom instead")));
/**
* 有主播离开当前房间（已废弃）
*
* @deprecated 新版本开始不推荐使用，建议使用 {@link onRemoteUserLeaveRoom} 替代之。
*/
- (void)onUserExit:(NSString *)userId reason:(NSInteger)reason __attribute__((deprecated("use onRemoteUserLeaveRoom instead")));
/**
* 音效播放已结束（已废弃）
*
* @deprecated 新版本开始不推荐使用，建议使用 {@link ITXAudioEffectManager} 接口替代之。
* 新的接口中不再区分背景音乐和音效，而是统一用 {@link startPlayMusic} 取代之。
*/
- (void)onAudioEffectFinished:(int)effectId code:(int)code __attribute__((deprecated("use ITXAudioEffectManager.startPlayMusic instead")));
/// @}
@end // End of class TRTCCloudDelegate
/////////////////////////////////////////////////////////////////////////////////
//
// （十一）自定义视频渲染回调
// 视频数据自定义回调
//
/////////////////////////////////////////////////////////////////////////////////
#pragma mark - TRTCVideoRenderDelegate
/// @addtogroup TRTCCloudDelegate_ios
/// @name 视频数据自定义回调
/// @{
/**
* 视频数据帧的自定义处理回调
*/
@protocol TRTCVideoRenderDelegate <NSObject>
/**
* 自定义视频渲染回调
*
* 当您设置了本地或者远端的视频自定义渲染回调之后，SDK 就会将原本要交给渲染控件进行渲染的视频帧通过此回调接口抛送给您，以便于您进行自定义渲染。
* @param frame 待渲染的视频帧信息
* @param userId 视频源的 userId，如果是本地视频回调（setLocalVideoRenderDelegate），该参数可以忽略
* @param streamType 视频源类型，例如，使用摄像头画面或屏幕分享画面等
* @param streamType 频流类型：主路（Main）一般用于承载摄像头画面，辅路（Sub）一般用于承载屏幕分享画面。
*/
@optional
- (void)onRenderVideoFrame:(TRTCVideoFrame *_Nonnull)frame userId:(NSString *__nullable)userId streamType:(TRTCVideoStreamType)streamType;
@end // End of class TRTCVideoRenderDelegate
@protocol TRTCVideoFrameDelegate <NSObject>
/**
* 用于对接第三方美颜组件的视频处理回调
*
* 如果您选购了第三方美颜组件，就需要在 TRTCCloud 中设置第三方美颜回调，之后 TRTC 就会将原本要进行预处理的视频帧通过此回调接口抛送给您。
* 之后您就可以将 TRTC 抛出的视频帧交给第三方美颜组件进行图像处理，由于抛出的数据是可读且可写的，因此第三方美颜的处理结果也可以同步给 TRTC 进行后续的编码和发送。
*
* @param srcFrame 用于承载 TRTC 采集到的摄像头画面
* @param dstFrame 用于接收第三方美颜处理过的视频画面
* @note 目前仅支持 OpenGL 纹理方案（ PC 仅支持 TRTCVideoBufferType_Buffer 格式）。
*
* 情况一：美颜组件自身会产生新的纹理
* 如果您使用的美颜组件会在处理图像的过程中产生一帧全新的纹理（用于承载处理后的图像），那请您在回调函数中将 dstFrame.textureId 设置为新纹理的 ID：
* <pre>
* uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVideoFrame * _Nonnull)dstFrame{
* self.frameID += 1;
* dstFrame.pixelBuffer = [[FURenderer shareRenderer] renderPixelBuffer:srcFrame.pixelBuffer
* withFrameId:self.frameID
* items:self.renderItems
* itemCount:self.renderItems.count];
* return 0;
* }
* </pre>
*
*
* 情况二：美颜组件需要您提供目标纹理
* 如果您使用的第三方美颜模块并不生成新的纹理，而是需要您设置给该模块一个输入纹理和一个输出纹理，则可以考虑如下方案：
* ```ObjectiveC
* uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVideoFrame * _Nonnull)dstFrame{
* thirdparty_process(srcFrame.textureId, srcFrame.width, srcFrame.height, dstFrame.textureId);
* return 0;
* }
* ```
* ```java
* int onProcessVideoFrame(TRTCCloudDef.TRTCVideoFrame srcFrame, TRTCCloudDef.TRTCVideoFrame dstFrame) {
* thirdparty_process(srcFrame.texture.textureId, srcFrame.width, srcFrame.height, dstFrame.texture.textureId);
* return 0;
* }
* ```
*/
@optional
- (void) onRenderVideoFrame:(TRTCVideoFrame * _Nonnull)frame userId:(NSString* __nullable)userId streamType:(TRTCVideoStreamType)streamType;
- (uint32_t)onProcessVideoFrame:(TRTCVideoFrame *_Nonnull)srcFrame dstFrame:(TRTCVideoFrame *_Nonnull)dstFrame;
@end
/**
* SDK 内部 OpenGL 环境被销的通知
*/
@optional
- (void)onGLContextDestory;
@end // End of class TRTCVideoFrameDelegate
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （十二）音频数据回调
// 音频数据自定义回调
//
/////////////////////////////////////////////////////////////////////////////////
/**
* 声音数据帧的自定义处理回调
*/
/// @name 音频数据自定义回调
/// @{
@protocol TRTCAudioFrameDelegate <NSObject>
@optional
/**
* 本地麦克风采集到的原始音频数据回调
*
* 当您设置完音频数据自定义回调之后，SDK 内部会把刚从麦克风采集到的原始音频数据，以 PCM 格式的形式通过本接口回调给您。
* - 此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
* - 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
* - 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
*
* @param frame PCM 格式的音频数据帧
* @note
* 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
* 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
* 3. 此接口回调出的音频数据**不包含**背景音、音效、混响等前处理效果，延迟极低。
*/
- (void)onCapturedRawAudioFrame:(TRTCAudioFrame *)frame;
/**
* 本地麦克风采集到的音频数据回调
* 本地采集并经过音频模块前处理后的音频数据回调
*
* 当您设置完音频数据自定义回调之后，SDK 内部会把刚采集到并经过前处理(ANS、AEC、AGC）之后的数据，以 PCM 格式的形式通过本接口回调给您。
* - 此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
* - 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
* - 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
*
* 特殊说明：
* 您可以通过设置接口中的 `TRTCAudioFrame.extraData` 字段，达到传输信令的目的。
* 由于音频帧头部的数据块不能太大，建议您写入 `extraData` 时，尽量将信令控制在几个字节的大小，如果超过 100 个字节，写入的数据不会被发送。
* 房间内其他用户可以通过 {@link TRTCAudioFrameDelegate} 中的 `onRemoteUserAudioFrame` 中的 `TRTCAudioFrame.extraData` 字段回调接收数据。
*
* @param frame 音频数据
* @note - 请不要在此回调函数中做任何耗时操作，建议直接拷贝到另一线程进行处理，否则会导致各种声音问题。
* @note - 此接口回调出的音频数据支持修改。
* @note - 此接口回调出的音频时间帧长固定为0.02s。
由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
以SDK默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
* @note - 此接口回调出的音频数据包含背景音、音效、混响等前处理效果。
* @param frame PCM 格式的音频数据帧
* @note
* 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
* 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
* 3. 此接口回调出的数据已经经过了回声抑制（AEC）处理，但声音的延迟相比于 {@link onCapturedRawAudioFrame} 要高一些。
*/
- (void) onCapturedAudioFrame:(TRTCAudioFrame *)frame;
- (void)onLocalProcessedAudioFrame:(TRTCAudioFrame *)frame;
/**
* 混音前的每一路远程用户的音频数据（例如您要对某一路的语音进行文字转换，必须要使用这里的原始数据，而不是混音之后的数据）
* 混音前的每一路远程用户的音频数据
*
* @param frame 音频数据
* 当您设置完音频数据自定义回调之后，SDK 内部会把远端的每一路原始数据，在最终混音之前，以 PCM 格式的形式通过本接口回调给您。
* - 此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
* - 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
* - 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
*
* @param frame PCM 格式的音频数据帧
* @param userId 用户标识
* @note - 请不要在此回调函数中做任何耗时操作，建议直接拷贝到另一线程进行处理，否则会导致各种声音问题。
* @note - 此接口回调出的音频数据是只读的，不支持修改。
* @note 此接口回调出的音频数据是只读的，不支持修改
*/
- (void)onRemoteUserAudioFrame:(TRTCAudioFrame *)frame userId:(NSString *)userId;
/**
* 将各路待播放音频混合之后并在最终提交系统播放之前的数据回调
*
* 当您设置完音频数据自定义回调之后，SDK 内部会把各路待播放的音频混合之后的音频数据，在提交系统播放之前，以 PCM 格式的形式通过本接口回调给您。
* - 此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
* - 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
* - 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
*
* @param frame PCM 格式的音频数据帧
* @note
* 1. 请不要在此回调函数中做任何耗时操作，由于 SDK 每隔 20ms 就要处理一帧音频数据，如果您的处理时间超过 20ms，就会导致声音异常。
* 2. 此接口回调出的音频数据是可读写的，也就是说您可以在回调函数中同步修改音频数据，但请保证处理耗时。
* 3. 此接口回调出的是对各路待播放音频数据的混合，但其中并不包含耳返的音频数据。
*/
- (void) onPlayAudioFrame:(TRTCAudioFrame *)frame userId:(NSString *)userId;
- (void)onMixedPlayAudioFrame:(TRTCAudioFrame *)frame;
/**
* 各路音频数据混合后的音频数据
* SDK 所有音频混合后的音频数据（包括采集到的和待播放的）
*
* @param frame 音频数据
* @note - 请不要在此回调函数中做任何耗时操作，建议直接拷贝到另一线程进行处理，否则会导致各种声音问题。
* @note - 此接口回调出的音频数据支持修改。
* @note - 此接口回调出的音频时间帧长固定为0.02s。
由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
以SDK默认的音频播放格式48000采样率、双声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 2 × 16bit = 30720bit = 3840字节】。
* @note - 此接口回调出的音频数据是各路音频播放数据的混合,不包含耳返的音频数据。
* 当您设置完音频数据自定义回调之后，SDK 内部会把所有采集到的和待播放的音频数据混合起来，以 PCM 格式的形式通过本接口回调给您，便于您进行自定义录制。
* - 此接口回调出的音频时间帧长固定为0.02s，格式为 PCM 格式。
* - 由时间帧长转化为字节帧长的公式为【采样率 × 时间帧长 × 声道数 × 采样点位宽】。
* - 以 TRTC 默认的音频录制格式48000采样率、单声道、16采样点位宽为例，字节帧长为【48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
*
* @param frame PCM 格式的音频数据帧
* @note
* 1. 此接口回调出的是SDK所有音频数据的混合数据，包括：经过 3A 前处理、特效叠加以及背景音乐混音后的本地音频，所有远端音频，但不包括耳返音频。
* 2. 此接口回调出的音频数据不支持修改。
*/
- (void) onMixedPlayAudioFrame:(TRTCAudioFrame *)frame;
- (void)onMixedAllAudioFrame:(TRTCAudioFrame *)frame;
@end
@end // End of class TRTCAudioFrameDelegate
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （十三）Log 信息回调
// 更多事件回调接口
//
/////////////////////////////////////////////////////////////////////////////////
/**
* 日志相关回调
*
* 建议在一个比较早初始化的类中设置回调委托对象，例如 AppDelegate
*/
/// @name 更多事件回调接口
/// @{
@protocol TRTCLogDelegate <NSObject>
@optional
/**
* 有日志打印时的回调
* 本地 LOG 的打印回调
*
* 如果您希望捕获 SDK 的本地日志打印行为，可以通过设置日志回调，让 SDK 将要打印的日志都通过本回调接口抛送给您。
* @param log 日志内容
* @param level 日志等级，参见 TRTCLogLevel
* @param module 值暂无具体意义，目前为固定值 TXLiteAVSDK
* @param level 日志等级 参见 TRTC_LOG_LEVEL
* @param module 保留字段，暂无具体意义，目前为固定值 TXLiteAVSDK
*/
@optional
-(void) onLog:(nullable NSString*)log LogLevel:(TRTCLogLevel)level WhichModule:(nullable NSString*)module;
- (void)onLog:(nullable NSString *)log LogLevel:(TRTCLogLevel)level WhichModule:(nullable NSString *)module;
@end
@end // End of class TRTCLogDelegate
/// @}
NS_ASSUME_NONNULL_END
/// @}
... ...
/*
* Module: TRTCStatistics @ TXLiteAVSDK
*
* Function: 腾讯云视频通话功能的质量统计相关接口
*
/**
* Module: TRTC 音视频统计指标（只读）
* Function: TRTC SDK 会以两秒钟一次的频率向您汇报当前实时的音视频指标（帧率、码率、卡顿情况等）
*/
///@addtogroup TRTCCloudDef_ios
///@{
/// @defgroup TRTCStatisic_ios TRTCStatisic
/// TRTC 音视频统计指标
/// @{
/////////////////////////////////////////////////////////////////////////////////
//
// 本地的音视频统计指标
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 本地的音视频统计指标
/// @{
/// 自己本地的音视频统计信息
@interface TRTCLocalStatistics : NSObject
///视频宽度
@property (nonatomic, assign) uint32_t width;
///【字段含义】本地视频的宽度，单位 px
@property(nonatomic, assign) uint32_t width;
///【字段含义】本地视频的高度，单位 px
@property(nonatomic, assign) uint32_t height;
///视频高度
@property (nonatomic, assign) uint32_t height;
///【字段含义】本地视频的帧率，即每秒钟会有多少视频帧，单位：FPS
@property(nonatomic, assign) uint32_t frameRate;
///帧率（fps）
@property (nonatomic, assign) uint32_t frameRate;
///【字段含义】远端视频的码率，即每秒钟新产生视频数据的多少，单位 Kbps
@property(nonatomic, assign) uint32_t videoBitrate;
///视频发送码率（Kbps）
@property (nonatomic, assign) uint32_t videoBitrate;
///【字段含义】远端音频的采样率，单位 Hz
@property(nonatomic, assign) uint32_t audioSampleRate;
///音频采样率（Hz）
@property (nonatomic, assign) uint32_t audioSampleRate;
///【字段含义】本地音频的码率，即每秒钟新产生音频数据的多少，单位 Kbps
@property(nonatomic, assign) uint32_t audioBitrate;
///音频发送码率（Kbps）
@property (nonatomic, assign) uint32_t audioBitrate;
///【字段含义】视频流类型（高清大画面|低清小画面|辅流画面）
@property(nonatomic, assign) TRTCVideoStreamType streamType;
///流类型（大画面 | 小画面 | 辅路画面）
@property (nonatomic, assign) TRTCVideoStreamType streamType;
///【字段含义】音频设备采集状态（用于检测音频外设的健康度）
/// 0：采集设备状态正常；1：检测到长时间静音；2：检测到破音；3：检测到声音异常间断。
@property(nonatomic, assign) uint32_t audioCaptureState;
@end
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 远端的音视频统计指标
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 远端的音视频统计指标
/// @{
/// 远端成员的音视频统计信息
@interface TRTCRemoteStatistics : NSObject
/// 用户 ID，指定是哪个用户的视频流
@property (nonatomic, retain) NSString* userId;
///【字段含义】用户 ID
@property(nonatomic, retain) NSString* userId;
/** 该线路的总丢包率（％）
*
* 这个值越小越好，例如，丢包率为0表示网络很好。
* 丢包率是该线路的 userId 从上行到服务器再到下行的总丢包率。
* 如果 downLoss 为0，但是 finalLoss 不为0，说明该 userId 上行时出现了无法恢复的丢包。
*/
@property (nonatomic, assign) uint32_t finalLoss;
///【字段含义】音频流的总丢包率（％）
/// audioPacketLoss 代表音频流历经“主播 => 云端 => 观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。
/// audioPacketLoss 越小越好，丢包率为0即表示该路音频流的所有数据均已经完整地到达了观众端。
///如果出现了 downLoss == 0 但 audioPacketLoss != 0 的情况，说明该路音频流在“云端=>观众”这一段链路上没有出现丢包，但是在“主播=>云端”这一段链路上出现了不可恢复的丢包。
@property(nonatomic, assign) uint32_t audioPacketLoss;
///【字段含义】该路视频流的总丢包率（％）
/// videoPacketLoss 代表该路视频流历经“主播 => 云端 => 观众”这样一条完整的传输链路后，最终在观众端统计到的丢包率。
/// videoPacketLoss 越小越好，丢包率为0即表示该路视频流的所有数据均已经完整地到达了观众端。
///如果出现了 downLoss == 0 但 videoPacketLoss != 0 的情况，说明该路视频流在“云端=>观众”这一段链路上没有出现丢包，但是在“主播=>云端”这一段链路上出现了不可恢复的丢包。
@property(nonatomic, assign) uint32_t videoPacketLoss;
///【字段含义】远端视频的宽度，单位 px
@property(nonatomic, assign) uint32_t width;
///【字段含义】远端视频的高度，单位 px
@property(nonatomic, assign) uint32_t height;
///【字段含义】远端视频的帧率，单位：FPS
@property(nonatomic, assign) uint32_t frameRate;
///【字段含义】远端视频的码率，单位 Kbps
@property(nonatomic, assign) uint32_t videoBitrate;
///视频宽度
@property (nonatomic, assign) uint32_t width;
///【字段含义】本地音频的采样率，单位 Hz
@property(nonatomic, assign) uint32_t audioSampleRate;
///视频高度
@property (nonatomic, assign) uint32_t height;
///【字段含义】本地音频的码率，单位 Kbps
@property(nonatomic, assign) uint32_t audioBitrate;
///接收帧率（fps）
@property (nonatomic, assign) uint32_t frameRate;
///【字段含义】播放延迟，单位 ms
///为了避免网络抖动和网络包乱序导致的声音和画面卡顿，TRTC 会在播放端管理一个播放缓冲区，用于对接收到的网络数据包进行整理，
///该缓冲区的大小会根据当前的网络质量进行自适应调整，该缓冲区的大小折算成以毫秒为单位的时间长度，也就是 jitterBufferDelay。
@property(nonatomic, assign) uint32_t jitterBufferDelay;
///视频码率（Kbps）
@property (nonatomic, assign) uint32_t videoBitrate;
///【字段含义】端到端延迟，单位 ms
/// point2PointDelay 代表 “主播=>云端=>观众” 的延迟，更准确地说，它代表了“采集=>编码=>网络传输=>接收=>缓冲=>解码=>播放” 全链路的延迟。
/// point2PointDelay 需要本地和远端的 SDK 均为 8.5 及以上的版本才生效，若远端用户为 8.5 以前的版本，此数值会一直为0，代表无意义。
@property(nonatomic, assign) uint32_t point2PointDelay;
///音频采样率（Hz）
@property (nonatomic, assign) uint32_t audioSampleRate;
///【字段含义】音频播放的累计卡顿时长，单位 ms
@property(nonatomic, assign) uint32_t audioTotalBlockTime;
///音频码率（Kbps）
@property (nonatomic, assign) uint32_t audioBitrate;
///【字段含义】音频播放卡顿率，单位 (%)
///音频播放卡顿率（audioBlockRate） = 音频播放的累计卡顿时长（audioTotalBlockTime） / 音频播放的总时长
@property(nonatomic, assign) uint32_t audioBlockRate;
///流类型（大画面 | 小画面 | 辅路画面）
@property (nonatomic, assign) TRTCVideoStreamType streamType;
///【字段含义】视频播放的累计卡顿时长，单位 ms
@property(nonatomic, assign) uint32_t videoTotalBlockTime;
///【字段含义】视频播放卡顿率，单位 (%)
///视频播放卡顿率（videoBlockRate） = 视频播放的累计卡顿时长（videoTotalBlockTime） / 视频播放的总时长
@property(nonatomic, assign) uint32_t videoBlockRate;
///【字段含义】该路音视频流的总丢包率（％）
///已废弃，不推荐使用；建议使用 audioPacketLoss、videoPacketLoss 替代
@property(nonatomic, assign) uint32_t finalLoss __attribute__((deprecated("Use audioPacketLoss and videoPacketLoss instead.")));
///【字段含义】视频流类型（高清大画面|低清小画面|辅流画面）
@property(nonatomic, assign) TRTCVideoStreamType streamType;
@end
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 网络和性能的汇总统计指标
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 网络和性能的汇总统计指标
/// @{
/// 统计数据
@interface TRTCStatistics : NSObject
/** C -> S 上行丢包率（％），
* 该值越小越好，例如，丢包率为0表示网络很好，
* 丢包率为30@%则意味着 SDK 向服务器发送的数据包中会有30@%丢失在上行传输中。
*/
@property (nonatomic, assign) uint32_t upLoss;
///【字段含义】当前应用的 CPU 使用率，单位 (%)
@property(nonatomic, assign) uint32_t appCpu;
/** S -> C 下行丢包率（％），
* 该值越小越好，例如，丢包率为0表示网络很好，
* 丢包率为30@%则意味着 SDK 向服务器发送的数据包中会有30@%丢失在下行传输中。
*/
@property (nonatomic, assign) uint32_t downLoss;
///【字段含义】当前系统的 CPU 使用率，单位 (%)
@property(nonatomic, assign) uint32_t systemCpu;
///【字段含义】从 SDK 到云端的上行丢包率，单位 (%)
///该数值越小越好，如果 upLoss 为 0%，则意味着上行链路的网络质量很好，上传到云端的数据包基本不发生丢失。
///如果 upLoss 为 30%，则意味着 SDK 向云端发送的音视频数据包中，会有 30% 丢失在传输链路中。
@property(nonatomic, assign) uint32_t upLoss;
///当前 App 的 CPU 使用率（％）
@property (nonatomic, assign) uint32_t appCpu;
///【字段含义】从云端到 SDK 的下行丢包率，单位 (%)
///该数值越小越好，如果 downLoss 为 0%，则意味着下行链路的网络质量很好，从云端接收的数据包基本不发生丢失。
///如果 downLoss 为 30%，则意味着云端向 SDK 传输的音视频数据包中，会有 30% 丢失在传输链路中。
@property(nonatomic, assign) uint32_t downLoss;
///当前系统的 CPU 使用率（％）
@property (nonatomic, assign) uint32_t systemCpu;
///【字段含义】从 SDK 到云端的往返延时，单位 ms
///该数值代表从 SDK 发送一个网络包到云端，再从云端回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK=>云端=>SDK” 的总耗时。
///该数值越小越好：如果 rtt < 50ms，意味着较低的音视频通话延迟；如果 rtt > 200ms，则意味着较高的音视频通话延迟。
///需要特别解释的是，rtt 代表 “SDK=>云端=>SDK” 的总耗时，所不需要区分 upRtt 和 downRtt。
@property(nonatomic, assign) uint32_t rtt;
/// 延迟（毫秒），
/// 指 SDK 到腾讯云服务器的一次网络往返时间，该值越小越好。
/// 一般低于50ms的 rtt 相对理想，而高于100ms的 rtt 会引入较大的通话延时。
/// 由于数据上下行共享一条网络连接，所以 local 和 remote 的 rtt 相同。
@property (nonatomic, assign) uint32_t rtt;
///【字段含义】从 SDK 到本地路由器的往返时延，单位 ms
///该数值代表从 SDK 发送一个网络包到本地路由器网关，再从网关回送一个网络包到 SDK 的总计耗时，也就是一个网络包经历 “SDK=>网关=>SDK” 的总耗时。
///该数值越小越好：如果 gatewayRtt < 50ms，意味着较低的音视频通话延迟；如果 gatewayRtt > 200ms，则意味着较高的音视频通话延迟。
///当网络类型为蜂窝网时，该值无效。
@property(nonatomic, assign) uint32_t gatewayRtt;
/// 总接收字节数（包含信令及音视频）
@property (nonatomic, assign) uint64_t receivedBytes;
///【字段含义】总发送字节数（包含信令数据和音视频数据），单位：字节数（Bytes）
@property(nonatomic, assign) uint64_t sentBytes;
/// 总发送字节数（包含信令及音视频）
@property (nonatomic, assign) uint64_t sentBytes;
///【字段含义】总接收字节数（包含信令数据和音视频数据），单位：字节数（Bytes）
@property(nonatomic, assign) uint64_t receivedBytes;
///自己本地的音视频统计信息，可能有主画面、小画面以及辅路画面等多路的情况，因此是一个数组
@property (nonatomic, strong) NSArray<TRTCLocalStatistics*>* localStatistics;
///【字段含义】本地的音视频统计信息
///由于本地可能有三路音视频流（即高清大画面，低清小画面，以及辅流画面），因此本地的音视频统计信息是一个数组。
@property(nonatomic, strong) NSArray<TRTCLocalStatistics*>* localStatistics;
///【字段含义】远端的音视频统计信息
///因为同时可能有多个远端用户，而且每个远端用户同时可能有多路音视频流（即高清大画面，低清小画面，以及辅流画面），因此远端的音视频统计信息是一个数组。
@property(nonatomic, strong) NSArray<TRTCRemoteStatistics*>* remoteStatistics;
///远端成员的音视频统计信息，可能有主画面、小画面以及辅路画面等多路的情况，因此是一个数组
@property (nonatomic, strong) NSArray<TRTCRemoteStatistics*>* remoteStatistics;
@end
///@}
/// @}
/// @}
... ...
/**
* Module: TRTC 背景音乐、短音效和人声特效的管理类
* Function: 用于对背景音乐、短音效和人声特效进行设置的管理类
*/
/// @defgroup TXAudioEffectManager_ios TXAudioEffectManager
/// TRTC 背景音乐、短音效和人声特效的管理类
/// @{
#import <Foundation/Foundation.h>
/////////////////////////////////////////////////////////////////////////////////
//
// 音效相关的枚举值定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 音效相关的枚举值定义
/// @{
/**
* 1.1 混响特效
*
* 混响特效可以作用于人声之上，通过声学算法对声音进行叠加处理，模拟出各种不同环境下的临场感受，目前支持如下几种混响效果：
* 0：关闭；1：KTV；2：小房间；3：大会堂；4：低沉；5：洪亮；6：金属声；7：磁性；8：空灵；9：录音棚；10：悠扬。
*/
typedef NS_ENUM(NSInteger, TXVoiceReverbType) {
TXVoiceReverbType_0 = 0, ///< disable
TXVoiceReverbType_1 = 1, ///< KTV
TXVoiceReverbType_2 = 2, ///< small room
TXVoiceReverbType_3 = 3, ///< great hall
TXVoiceReverbType_4 = 4, ///< deep voice
TXVoiceReverbType_5 = 5, ///< loud voice
TXVoiceReverbType_6 = 6, ///< metallic sound
TXVoiceReverbType_7 = 7, ///< magnetic sound
TXVoiceReverbType_8 = 8, ///< ethereal
TXVoiceReverbType_9 = 9, ///< studio
TXVoiceReverbType_10 = 10, ///< melodious
};
/**
* 1.2 变声特效
*
* 变声特效可以作用于人声之上，通过声学算法对人声进行二次处理，以获得与原始声音所不同的音色，目前支持如下几种变声特效：
* 0：关闭；1：熊孩子；2：萝莉；3：大叔；4：重金属；5：感冒；6：外语腔；7：困兽；8：肥宅；9：强电流；10：重机械；11：空灵。
*/
typedef NS_ENUM(NSInteger, TXVoiceChangeType) {
TXVoiceChangeType_0 = 0, ///< disable
TXVoiceChangeType_1 = 1, ///< naughty kid
TXVoiceChangeType_2 = 2, ///< Lolita
TXVoiceChangeType_3 = 3, ///< uncle
TXVoiceChangeType_4 = 4, ///< heavy metal
TXVoiceChangeType_5 = 5, ///< catch cold
TXVoiceChangeType_6 = 6, ///< foreign accent
TXVoiceChangeType_7 = 7, ///< caged animal trapped beast
TXVoiceChangeType_8 = 8, ///< indoorsman
TXVoiceChangeType_9 = 9, ///< strong current
TXVoiceChangeType_10 = 10, ///< heavy machinery
TXVoiceChangeType_11 = 11, ///< intangible
};
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 背景音乐的播放事件回调
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 背景音乐的事件回调接口
/// @{
// Playback progress block of background music
///背景音乐开始播放
typedef void (^TXAudioMusicStartBlock)(NSInteger errCode);
///背景音乐的播放进度
typedef void (^TXAudioMusicProgressBlock)(NSInteger progressMs, NSInteger durationMs);
///背景音乐已经播放完毕
typedef void (^TXAudioMusicCompleteBlock)(NSInteger errCode);
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 背景音乐的播放控制信息
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 背景音乐的播放控制信息
/// @{
/**
* 背景音乐的播放控制信息
*
* 该信息用于在接口 {@link startPlayMusic} 中指定背景音乐的相关信息，包括播放 ID、文件路径和循环次数等：
* 1. 如果要多次播放同一首背景音乐，请不要每次播放都分配一个新的 ID，我们推荐使用相同的 ID。
* 2. 若您希望同时播放多首不同的音乐，请为不同的音乐分配不同的 ID 进行播放。
* 3. 如果使用同一个 ID 播放不同音乐，SDK 会先停止播放旧的音乐，再播放新的音乐。
*/
@interface TXAudioMusicParam : NSObject
///【字段含义】音乐 ID <br/>
///【特殊说明】SDK 允许播放多路音乐，因此需要使用 ID 进行标记，用于控制音乐的开始、停止、音量等。
@property(nonatomic) int32_t ID;
///【字段含义】音效文件的完整路径或 URL 地址。支持的音频格式包括 MP3、AAC、M4A、WAV
@property(nonatomic, copy) NSString *path;
///【字段含义】音乐循环播放的次数 <br/>
///【推荐取值】取值范围为0 - 任意正整数，默认值：0。0表示播放音乐一次；1表示播放音乐两次；以此类推
@property(nonatomic) NSInteger loopCount;
///【字段含义】是否将音乐传到远端 <br/>
///【推荐取值】YES：音乐在本地播放的同时，远端用户也能听到该音乐；NO：主播只能在本地听到该音乐，远端观众听不到。默认值：NO。
@property(nonatomic) BOOL publish;
///【字段含义】播放的是否为短音乐文件 <br/>
///【推荐取值】YES：需要重复播放的短音乐文件；NO：正常的音乐文件。默认值：NO
@property(nonatomic) BOOL isShortFile;
///【字段含义】音乐开始播放时间点，单位：毫秒。
@property(nonatomic) NSInteger startTimeMS;
///【字段含义】音乐结束播放时间点，单位毫秒，0表示播放至文件结尾。
@property(nonatomic) NSInteger endTimeMS;
@end
/// @}
// Definition of audio effect management module
@interface TXAudioEffectManager : NSObject
/**
* TXAudioEffectManager对象不可直接被创建
* 要通过 `TRTCCloud` 或 `TXLivePush` 中的 `getAudioEffectManager` 接口获取
*/
- (instancetype)init NS_UNAVAILABLE;
/////////////////////////////////////////////////////////////////////////////////
//
// 人声相关的特效接口
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 人声相关的特效接口
/// @{
/**
* 1.1 开启耳返
*
* 主播开启耳返后，可以在耳机里听到麦克风采集到的自己发出的声音，该特效适用于主播唱歌的应用场景中。
*
* 需要您注意的是，由于蓝牙耳机的硬件延迟非常高，所以在主播佩戴蓝牙耳机时无法开启此特效，请尽量在用户界面上提示主播佩戴有线耳机。
* 同时也需要注意，并非所有的手机开启此特效后都能达到优秀的耳返效果，我们已经对部分耳返效果不佳的手机屏蔽了该特效。
*
* @note 仅在主播佩戴耳机时才能开启此特效，同时请您提示主播佩戴有线耳机。
* @param enable true：开启；false：关闭。
*/
- (void)enableVoiceEarMonitor:(BOOL)enable;
/**
* 1.2 设置耳返音量
*
* 通过该接口您可以设置耳返特效中声音的音量大小。
*
* @param volume 音量大小，取值范围为0 - 100，默认值：100。
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (void)setVoiceEarMonitorVolume:(NSInteger)volume;
/**
* 1.3 设置人声的混响效果
*
* 通过该接口您可以设置人声的混响效果，具体特效请参考枚举定义{@link TXVoiceReverbType}。
*
* @note 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
*/
- (void)setVoiceReverbType:(TXVoiceReverbType)reverbType;
/**
* 1.4 设置人声的变声特效
*
* 通过该接口您可以设置人声的变声特效，具体特效请参考枚举定义{@link TXVoiceChangeType}。
*
* @note 设置的效果在退出房间后会自动失效，如果下次进房还需要对应特效，需要调用此接口再次进行设置。
*/
- (void)setVoiceChangerType:(TXVoiceChangeType)changerType;
/**
* 1.5 设置语音音量
*
* 该接口可以设置语音音量的大小，一般配合音乐音量的设置接口 {@link setAllMusicVolume} 协同使用，用于调谐语音和音乐在混音前各自的音量占比。
*
* @param volume 音量大小，取值范围为0 - 100，默认值：100。
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (void)setVoiceVolume:(NSInteger)volume;
/**
* 1.6 设置语音音调
*
* 该接口可以设置语音音调，用于实现变调不变速的目的。
*
* @param pitch 音调，取值范围为-1.0f~1.0f，默认值：0.0f。
*/
- (void)setVoicePitch:(double)pitch;
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 背景音乐的相关接口
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 背景音乐的相关接口
/// @{
/**
* 2.1 开始播放背景音乐
*
* 每个音乐都需要您指定具体的 ID，您可以通过该 ID 对音乐的开始、停止、音量等进行设置。
*
* @note
* 1. 如果要多次播放同一首背景音乐，请不要每次播放都分配一个新的 ID，我们推荐使用相同的 ID。
* 2. 若您希望同时播放多首不同的音乐，请为不同的音乐分配不同的 ID 进行播放。
* 3. 如果使用同一个 ID 播放不同音乐，SDK 会先停止播放旧的音乐，再播放新的音乐。
*
* @param musicParam 音乐参数
* @param startBlock 播放开始回调
* @param progressBlock 播放进度回调
* @param completeBlock 播放结束回调
*/
- (void)startPlayMusic:(TXAudioMusicParam *)musicParam onStart:(TXAudioMusicStartBlock _Nullable)startBlock onProgress:(TXAudioMusicProgressBlock _Nullable)progressBlock onComplete:(TXAudioMusicCompleteBlock _Nullable)completeBlock;
/**
* 2.2 停止播放背景音乐
*
* @param id 音乐 ID
*/
- (void)stopPlayMusic:(int32_t)id;
/**
* 2.3 暂停播放背景音乐
*
* @param id 音乐 ID
*/
- (void)pausePlayMusic:(int32_t)id;
/**
* 2.4 恢复播放背景音乐
*
* @param id 音乐 ID
*/
- (void)resumePlayMusic:(int32_t)id;
/**
* 2.5 设置所有背景音乐的本地音量和远端音量的大小
*
* 该接口可以设置所有背景音乐的本地音量和远端音量。
* - 本地音量：即主播本地可以听到的背景音乐的音量大小。
* - 远端音量：即观众端可以听到的背景音乐的音量大小。
*
* @param volume 音量大小，取值范围为0 - 100，默认值：100。
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (void)setAllMusicVolume:(NSInteger)volume;
/**
* 2.6 设置某一首背景音乐的远端音量的大小
*
* 该接口可以细粒度地控制每一首背景音乐的远端音量，也就是观众端可听到的背景音乐的音量大小。
*
* @param id 音乐 ID
* @param volume 音量大小，取值范围为0 - 100；默认值：100
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (void)setMusicPublishVolume:(int32_t)id volume:(NSInteger)volume;
/**
* 2.7 设置某一首背景音乐的本地音量的大小
*
* 该接口可以细粒度地控制每一首背景音乐的本地音量，也就是主播本地可以听到的背景音乐的音量大小。
*
* @param id 音乐 ID
* @param volume 音量大小，取值范围为0 - 100，默认值：100。
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (void)setMusicPlayoutVolume:(int32_t)id volume:(NSInteger)volume;
/**
* 2.8 调整背景音乐的音调高低
*
* @param id 音乐 ID
* @param pitch 音调，默认值是0.0f，范围是：[-1 ~ 1] 之间的浮点数；
*/
- (void)setMusicPitch:(int32_t)id pitch:(double)pitch;
/**
* 2.9 调整背景音乐的变速效果
*
* @param id 音乐 ID
* @param speedRate 速度，默认值是1.0f，范围是：[0.5 ~ 2] 之间的浮点数；
*/
- (void)setMusicSpeedRate:(int32_t)id speedRate:(double)speedRate;
/**
* 2.10 获取背景音乐的播放进度（单位：毫秒）
*
* @param id 音乐 ID
* @return 成功返回当前播放时间，单位：毫秒，失败返回-1
*/
- (NSInteger)getMusicCurrentPosInMS:(int32_t)id;
/**
* 2.11 获取背景音乐的总时长（单位：毫秒）
*
* @param path 音乐文件路径。
* @return 成功返回时长，失败返回-1
*/
- (NSInteger)getMusicDurationInMS:(NSString *)path;
/**
* 2.12 设置背景音乐的播放进度（单位：毫秒）
*
* @note 请尽量避免过度频繁地调用该接口，因为该接口可能会再次读写音乐文件，耗时稍高。
* 因此，当用户拖拽音乐的播放进度条时，请在用户完成拖拽操作后再调用本接口。
* 因为 UI 上的进度条控件往往会以很高的频率反馈用户的拖拽进度，如不做频率限制，会导致较差的用户体验。
*
* @param id 音乐 ID
* @param pts 单位: 毫秒
*/
- (void)seekMusicToPosInMS:(int32_t)id pts:(NSInteger)pts;
/// @}
@end // End of interface TXAudioEffectManager
/// @}
... ...
//
// TXBeautyManager.h
// TXLiteAVSDK
//
// Created by cui on 2019/10/24.
// Copyright © 2019 Tencent. All rights reserved.
//
/**
* Module: 美颜与图像处理参数设置类
* Function: 修改美颜、滤镜、绿幕等参数
*/
#import <Foundation/Foundation.h>
#import <TargetConditionals.h>
#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
typedef UIImage TXImage;
#else
#import <AppKit/AppKit.h>
typedef NSImage TXImage;
#endif
NS_ASSUME_NONNULL_BEGIN
/// @defgroup TXBeautyManager_ios TXBeautyManager
/// 美颜及动效参数管理
/// 美颜与图像处理参数设置类
/// @{
/**
* 美颜（磨皮）算法
* SDK 内置了多种不同的磨皮算法，您可以选择最适合您产品定位的方案。
* TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案。
*/
typedef NS_ENUM(NSInteger, TXBeautyStyle) {
TXBeautyStyleSmooth = 0, ///< 光滑，适用于美女秀场，效果比较明显。
TXBeautyStyleNature = 1, ///< 自然，磨皮算法更多地保留了面部细节，主观感受上会更加自然。
TXBeautyStylePitu = 2 ///< 企业版美颜算法（企业版有效，其它版本设置此参数无效）
///光滑，算法比较激进，磨皮效果比较明显，适用于秀场直播。
TXBeautyStyleSmooth = 0,
///自然，算法更多地保留了面部细节，磨皮效果更加自然，适用于绝大多数直播场景。
TXBeautyStyleNature = 1,
///优图，由优图实验室提供，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高。
TXBeautyStylePitu = 2
};
/// 美颜及动效参数管理
@interface TXBeautyManager : NSObject
/**
* 设置美颜（磨皮）算法
*
* SDK 内部集成了两套风格不同的磨皮算法，一套我们取名叫“光滑”，适用于美女秀场，效果比较明显。
* 另一套我们取名“自然”，磨皮算法更多地保留了面部细节，主观感受上会更加自然。
* TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位的方案：
*
* @param beautyStyle 美颜风格，光滑或者自然，光滑风格磨皮更加明显，适合娱乐场景。
* @param beautyStyle 美颜风格，TXBeautyStyleSmooth：光滑；TXBeautyStyleNature：自然；TXBeautyStylePitu：优图。
*/
- (void)setBeautyStyle:(TXBeautyStyle)beautyStyle;
/**
* 设置美颜级别
* @param level 美颜级别，取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显。
*
* @param beautyLevel 美颜级别，取值范围0 - 9； 0表示关闭，9表示效果最明显。
*/
- (void)setBeautyLevel:(float)level;
- (void)setBeautyLevel:(float)beautyLevel;
/**
* 设置美白级别
*
* @param level 美白级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param whitenessLevel 美白级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
*/
- (void)setWhitenessLevel:(float)whitenessLevel;
/**
* 开启清晰度增强
*/
- (void)setWhitenessLevel:(float)level;
- (void)enableSharpnessEnhancement:(BOOL)enable;
/**
* 设置红润级别
*
* @param level 红润级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param ruddyLevel 红润级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
*/
- (void)setRuddyLevel:(float)ruddyLevel;
/**
* 设置色彩滤镜效果
*
* 色彩滤镜，是一副包含色彩映射关系的颜色查找表图片，您可以在我们提供的官方 Demo 中找到预先准备好的几张滤镜图片。
* SDK 会根据该查找表中的映射关系，对摄像头采集出的原始视频画面进行二次处理，以达到预期的滤镜效果。
* @param image 包含色彩映射关系的颜色查找表图片，必须是 png 格式。
*/
- (void)setRuddyLevel:(float)level;
- (void)setFilter:(nullable TXImage *)image;
/**
* 设置色彩滤镜的强度
*
* 该数值越高，色彩滤镜的作用强度越明显，经过滤镜处理后的视频画面跟原画面的颜色差异越大。
* 我默认的滤镜浓度是0.5，如果您觉得默认的滤镜效果不明显，可以设置为 0.5 以上的数字，最大值为1。
*
* @param strength 从0到1，数值越大滤镜效果越明显，默认值为0.5。
*/
- (void)setFilterStrength:(float)strength;
/**
* 设置绿幕背景视频，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* 此接口所开启的绿幕功能不具备智能去除背景的能力，需要被拍摄者的背后有一块绿色的幕布来辅助产生特效。
*
* @param path MP4格式的视频文件路径; 设置空值表示关闭特效。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (int)setGreenScreenFile:(nullable NSString *)path;
/**
* 设置大眼级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param eyeScaleLevel 大眼级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
#if TARGET_OS_IPHONE
- (int)setEyeScaleLevel:(float)eyeScaleLevel;
#endif
/**
* 设置大眼级别（企业版有效，其它版本设置此参数无效）
* 设置瘦脸级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 大眼级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param faceSlimLevel 瘦脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setEyeScaleLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setFaceSlimLevel:(float)faceSlimLevel;
#endif
/**
* 设置瘦脸级别（企业版有效，其它版本设置此参数无效）
* 设置 V 脸级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 瘦脸级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param faceVLevel V脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setFaceSlimLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setFaceVLevel:(float)faceVLevel;
#endif
/**
* 设置V脸级别（企业版有效，其它版本设置此参数无效）
* 设置下巴拉伸或收缩，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level V脸级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param chinLevel 下巴拉伸或收缩级别，取值范围-9 - 9；0 表示关闭，小于0表示收缩，大于0表示拉伸。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setFaceVLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setChinLevel:(float)chinLevel;
#endif
/**
* 设置下巴拉伸或收缩（企业版有效，其它版本设置此参数无效）
* 设置短脸级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 下巴拉伸或收缩级别，取值范围-9 - 9；0 表示关闭，小于0表示收缩，大于0表示拉伸。
* @param faceShortLevel 短脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setChinLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setFaceShortLevel:(float)faceShortLevel;
#endif
/**
* 设置短脸级别（企业版有效，其它版本设置此参数无效）
* 设置窄脸级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 短脸级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param level 窄脸级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setFaceShortLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setFaceNarrowLevel:(float)faceNarrowLevel;
#endif
/**
* 设置瘦鼻级别（企业版有效，其它版本设置此参数无效）
* 设置瘦鼻级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 瘦鼻级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param noseSlimLevel 瘦鼻级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setNoseSlimLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setNoseSlimLevel:(float)noseSlimLevel;
#endif
/**
* 设置亮眼 （企业版有效，其它版本设置此参数无效）
* 设置亮眼级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 亮眼级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param eyeLightenLevel 亮眼级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setEyeLightenLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setEyeLightenLevel:(float)eyeLightenLevel;
#endif
/**
* 设置白牙 （企业版有效，其它版本设置此参数无效）
* 设置牙齿美白级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 白牙级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param toothWhitenLevel 白牙级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setToothWhitenLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setToothWhitenLevel:(float)toothWhitenLevel;
#endif
/**
* 设置祛皱 （企业版有效，其它版本设置此参数无效）
* 设置祛皱级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 祛皱级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param wrinkleRemoveLevel 祛皱级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setWrinkleRemoveLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setWrinkleRemoveLevel:(float)wrinkleRemoveLevel;
#endif
/**
* 设置祛眼袋 （企业版有效，其它版本设置此参数无效）
* 设置祛眼袋级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 祛眼袋级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param pounchRemoveLevel 祛眼袋级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setPounchRemoveLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setPounchRemoveLevel:(float)pounchRemoveLevel;
#endif
/**
* 设置法令纹 （企业版有效，其它版本设置此参数无效）
* 设置法令纹去除级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 法令纹级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @param smileLinesRemoveLevel 法令纹级别，取值范围0 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setSmileLinesRemoveLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setSmileLinesRemoveLevel:(float)smileLinesRemoveLevel;
#endif
/**
* 设置发际线 （企业版有效，其它版本设置此参数无效）
* 设置发际线调整级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 发际线级别，取值范围-9 - 9；0表示关闭，小于0表示抬高，大于0表示降低。
* @param foreheadLevel 发际线级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setForeheadLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setForeheadLevel:(float)foreheadLevel;
#endif
/**
* 设置眼距 （企业版有效，其它版本设置此参数无效）
* 设置眼距，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 眼距级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @param eyeDistanceLevel 眼距级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setEyeDistanceLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setEyeDistanceLevel:(float)eyeDistanceLevel;
#endif
/**
* 设置眼角 （企业版有效，其它版本设置此参数无效）
* 设置眼角调整级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 眼角级别，取值范围-9 - 9；0表示关闭，小于0表示降低，大于0表示抬高。
* @param eyeAngleLevel 眼角调整级别，取值范围-9 - 9；0表示关闭，9表示效果最明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setEyeAngleLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setEyeAngleLevel:(float)eyeAngleLevel;
#endif
/**
* 设置嘴型 （企业版有效，其它版本设置此参数无效）
* 设置嘴型调整级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 嘴型级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @param mouthShapeLevel 嘴型级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setMouthShapeLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setMouthShapeLevel:(float)mouthShapeLevel;
#endif
/**
* 设置鼻翼 （企业版有效，其它版本设置此参数无效）
* 设置鼻翼调整级别，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param level 鼻翼级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @param noseWingLevel 鼻翼调整级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setNoseWingLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setNoseWingLevel:(float)noseWingLevel;
#endif
/**
* 设置鼻子位置 （企业版有效，其它版本设置此参数无效）
* @param level 鼻子位置级别，取值范围-9 - 9；0表示关闭，小于0表示抬高，大于0表示降低。
* 设置鼻子位置，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param nosePositionLevel 鼻子位置级别，取值范围-9 - 9；0表示关闭，小于0表示抬高，大于0表示降低。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setNosePositionLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setNosePositionLevel:(float)nosePositionLevel;
#endif
/**
* 设置嘴唇厚度 （企业版有效，其它版本设置此参数无效）
* @param level 嘴唇厚度级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* 设置嘴唇厚度，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param lipsThicknessLevel 嘴唇厚度级别，取值范围-9 - 9；0表示关闭，小于0表示拉伸，大于0表示收缩。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setLipsThicknessLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setLipsThicknessLevel:(float)lipsThicknessLevel;
#endif
/**
* 设置脸型（企业版有效，其它版本设置此参数无效）
* @param level 美型级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* 设置脸型，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param faceBeautyLevel 美型级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。
* @return 0：成功；-5：当前 License 对应 feature 不支持。
*/
- (void)setFaceBeautyLevel:(float)level;
#if TARGET_OS_IPHONE
- (int)setFaceBeautyLevel:(float)faceBeautyLevel;
#endif
/**
* 选择 AI 动效挂件（企业版有效，其它版本设置此参数无效）
* 选择 AI 动效挂件，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
*
* @param tmplName 动效名称
* @param tmplDir 动效所在目录
* @param tmplName 动效挂件名称
* @param tmplDir 动效素材文件所在目录
*/
#if TARGET_OS_IPHONE
- (void)setMotionTmpl:(nullable NSString *)tmplName inDir:(nullable NSString *)tmplDir;
#endif
/**
* 设置动效静音（企业版有效，其它版本设置此参数无效）
*
* 是否在动效素材播放时静音，该接口仅在 [企业版 SDK](https://cloud.tencent.com/document/product/647/32689#Enterprise) 中生效
* 有些挂件本身会有声音特效，通过此 API 可以关闭这些特效播放时所带的声音效果。
*
* @param motionMute YES：静音；NO：不静音。
*/
#if TARGET_OS_IPHONE
- (void)setMotionMute:(BOOL)motionMute;
#endif
... ...
/**
* Module: TRTC 音视频设备管理模块
* Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬件设备
*/
/// @defgroup TXDeviceManager_ios TXDeviceManager
/// TRTC 音视频设备管理模块
/// @{
#import <Foundation/Foundation.h>
#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
#elif TARGET_OS_MAC
#import <AppKit/AppKit.h>
#endif
/////////////////////////////////////////////////////////////////////////////////
//
// 音视频设备相关的类型定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 音视频设备相关的类型定义
/// @{
/**
* 系统音量类型（仅适用于移动设备）
*
* 现代智能手机中一般都具备两套系统音量类型，即“通话音量”和“媒体音量”。
* - 通话音量：手机专门为接打电话所设计的音量类型，自带回声抵消（AEC）功能，并且支持通过蓝牙耳机上的麦克风进行拾音，缺点是音质比较一般。
* 当您通过手机侧面的音量按键下调手机音量时，如果无法将其调至零（也就是无法彻底静音），说明您的手机当前出于通话音量。
* - 媒体音量：手机专门为音乐场景所设计的音量类型，无法使用系统的 AEC 功能，并且不支持通过蓝牙耳机的麦克风进行拾音，但具备更好的音乐播放效果。
* 当您通过手机侧面的音量按键下调手机音量时，如果能够将手机音量调至彻底静音，说明您的手机当前出于媒体音量。
*
* SDK 目前提供了三种系统音量类型的控制模式：自动切换模式、全程通话音量模式、全程媒体音量模式。
*/
#if TARGET_OS_IPHONE
typedef NS_ENUM(NSInteger, TXSystemVolumeType) {
///自动切换模式：
///也被称为“麦上通话，麦下媒体”，即主播上麦时使用通话音量，观众不上麦则使用媒体音量，适合在线直播场景。
TXSystemVolumeTypeAuto = 0,
///全程媒体音量：
///通话全程使用媒体音量，并不是非常常用的音量类型，适用于对音质要求比较苛刻的音乐场景中。
///如果您的用户大都使用外接设备（比如外接声卡）为主，可以使用该模式，否则请慎用。
TXSystemVolumeTypeMedia = 1,
///全程通话音量：
///该方案的优势在于用户在上下麦时音频模块无需切换工作模式，可以做到无缝上下麦，适合于用户需要频繁上下麦的应用场景。
TXSystemVolumeTypeVOIP = 2,
};
#endif
/**
* 音频路由（即声音的播放模式）
*
* 音频路由，即声音是从手机的扬声器还是从听筒中播放出来，因此该接口仅适用于手机等移动端设备。
* 手机有两个扬声器：一个是位于手机顶部的听筒，一个是位于手机底部的立体声扬声器。
* - 设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
* - 设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。
*/
#if TARGET_OS_IPHONE
typedef NS_ENUM(NSInteger, TXAudioRoute) {
/// Speakerphone：使用扬声器播放（即“免提”），扬声器位于手机底部，声音偏大，适合外放音乐。
TXAudioRouteSpeakerphone = 0,
/// Earpiece：使用听筒播放，听筒位于手机顶部，声音偏小，适合需要保护隐私的通话场景。
TXAudioRouteEarpiece = 1,
};
#endif
/**
* 设备类型（仅适用于桌面平台）
*
* 该枚举值用于定义三种类型的音视频设备，即摄像头、麦克风和扬声器，以便让一套设备管理接口可以操控三种不同类型的设备。
*/
#if TARGET_OS_MAC && !TARGET_OS_IPHONE
typedef NS_ENUM(NSInteger, TXMediaDeviceType) {
TXMediaDeviceTypeUnknown = -1, ///< undefined device type
TXMediaDeviceTypeAudioInput = 0, ///< microphone
TXMediaDeviceTypeAudioOutput = 1, ///< speaker or earpiece
TXMediaDeviceTypeVideoCamera = 2, ///< camera
};
#endif
/**
* 设备操作
*
* 该枚举值用于本地设备的状态变化通知{@link onDeviceChanged}。
*/
#if TARGET_OS_MAC && !TARGET_OS_IPHONE
typedef NS_ENUM(NSInteger, TXMediaDeviceState) {
///设备已被插入
TXMediaDeviceStateAdd = 0,
///设备已被移除
TXMediaDeviceStateRemove = 1,
///设备已启用
TXMediaDeviceStateActive = 2,
};
#endif
/**
* 音视频设备的相关信息（仅适用于桌面平台）
*
* 该结构体用于描述一个音视频设备的关键信息，比如设备ID、设备名称等等，以便用户能够在用户界面上选择自己期望使用的音视频设备。
*/
#if TARGET_OS_MAC && !TARGET_OS_IPHONE
@interface TXMediaDeviceInfo : NSObject
/// device type
@property(assign, nonatomic) TXMediaDeviceType type;
/// device id
@property(copy, nonatomic, nullable) NSString *deviceId;
/// device name
@property(copy, nonatomic, nullable) NSString *deviceName;
/// device properties
@property(copy, nonatomic, nullable) NSString *deviceProperties;
@end
#endif
/// @}
/**
* 本地设备的通断状态发生变化（仅适用于桌面系统）
*
* 当本地设备（包括摄像头、麦克风以及扬声器）被插入或者拔出时，SDK 便会抛出此事件回调。
*
* @param deviceId 设备 ID
* @param type 设备类型
* @param state 通断状态，0：设备已添加；1：设备已被移除；2：设备已启用。
*/
#if TARGET_OS_MAC && !TARGET_OS_IPHONE
@protocol TXDeviceObserver <NSObject>
- (void)onDeviceChanged:(NSString *)deviceId type:(TXMediaDeviceType)mediaType state:(TXMediaDeviceState)mediaState;
@end
#endif
@interface TXDeviceManager : NSObject
/////////////////////////////////////////////////////////////////////////////////
//
// 移动端设备操作接口（iOS Android）
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 移动端设备操作接口
/// @{
/**
* 1.1 判断当前是否为前置摄像头（仅适用于移动端）
*/
#if TARGET_OS_IPHONE
- (BOOL)isFrontCamera;
/**
* 1.2 切换前置或后置摄像头（仅适用于移动端）
*/
- (NSInteger)switchCamera:(BOOL)frontCamera;
/**
* 1.3 查询当前摄像头是否支持缩放（仅适用于移动端）
*/
- (BOOL)isCameraZoomSupported;
/**
* 1.3 获取摄像头的最大缩放倍数（仅适用于移动端）
*/
- (CGFloat)getCameraZoomMaxRatio;
/**
* 1.4 设置摄像头的缩放倍数（仅适用于移动端）
*
* @param zoomRatio 取值范围1 - 5，取值为1表示最远视角（正常镜头），取值为5表示最近视角（放大镜头）。
*/
- (NSInteger)setCameraZoomRatio:(CGFloat)zoomRatio;
/**
* 1.5 查询是否支持自动识别人脸位置（仅适用于移动端）
*/
- (BOOL)isAutoFocusEnabled;
/**
* 1.6 开启自动对焦功能（仅适用于移动端）
*
* 开启后，SDK 会自动检测画面中的人脸位置，并将摄像头的焦点始终对焦在人脸位置上。
*/
- (NSInteger)enableCameraAutoFocus:(BOOL)enabled;
/**
* 1.7 设置摄像头的对焦位置（仅适用于移动端）
*
* 您可以通过该接口实现如下交互：
* 1. 在本地摄像头的预览画面上，允许用户单击操作。
* 2. 在用户的单击位置显示一个矩形方框，以示摄像头会在此处对焦。
* 3. 随后将用户点击位置的坐标通过本接口传递给 SDK，之后 SDK 会操控摄像头按照用户期望的位置进行对焦。
* @note 使用该接口的前提是先通过 {@link enableCameraAutoFocus} 关闭自动对焦功能。
* @param position 对焦位置，请传入期望对焦点的坐标值
* @return 0：操作成功；负数：操作失败。
*/
- (NSInteger)setCameraFocusPosition:(CGPoint)position;
/**
* 1.8 查询是否支持开启闪光灯（仅适用于移动端）
*/
- (BOOL)isCameraTorchSupported;
/**
* 1.8 开启/关闭闪光灯，也就是手电筒模式（仅适用于移动端）
*/
- (NSInteger)enableCameraTorch:(BOOL)enabled;
/**
* 1.9 设置音频路由（仅适用于移动端）
*
* 手机有两个音频播放设备：一个是位于手机顶部的听筒，一个是位于手机底部的立体声扬声器。
* 设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
* 设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。
*/
- (NSInteger)setAudioRoute:(TXAudioRoute)route;
/**
* 1.10 设置系统音量类型（仅适用于移动端）
*/
- (NSInteger)setSystemVolumeType:(TXSystemVolumeType)type;
#endif
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// 桌面端设备操作接口（Windows Mac）
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 桌面端设备操作接口
/// @{
/**
* 2.1 获取设备列表（仅适用于桌面端）
*
* @param type 设备类型，指定需要获取哪种设备的列表。详见 TXMediaDeviceType 定义。
* @note
* - 使用完毕后请调用 release 方法释放资源，这样可以让 SDK 维护 ITXDeviceCollection 对象的生命周期。
* - 不要使用 delete 释放返回的 Collection 对象，delete ITXDeviceCollection* 指针会导致异常崩溃。
* - type 只支持 TXMediaDeviceTypeMic、TXMediaDeviceTypeSpeaker、TXMediaDeviceTypeCamera。
* - 此接口只支持 Mac 和 Windows 平台
*/
#if !TARGET_OS_IPHONE && TARGET_OS_MAC
- (NSArray<TXMediaDeviceInfo *> *_Nullable)getDevicesList:(TXMediaDeviceType)type;
/**
* 2.2 设置当前要使用的设备（仅适用于桌面端）
*
* @param type 设备类型，详见 TXMediaDeviceType 定义。
* @param deviceId 设备ID，您可以通过接口 {@link getDevicesList} 获得设备 ID。
* @return 0：操作成功；负数：操作失败。
*/
- (NSInteger)setCurrentDevice:(TXMediaDeviceType)type deviceId:(NSString *)deviceId;
/**
* 2.3 获取当前正在使用的设备（仅适用于桌面端）
*/
- (TXMediaDeviceInfo *_Nullable)getCurrentDevice:(TXMediaDeviceType)type;
/**
* 2.4 设置当前设备的音量（仅适用于桌面端）
*
* 这里的音量指的是麦克风的采集音量或者扬声器的播放音量，摄像头是不支持设置音量的。
*
* @param volume 音量大小，取值范围为0 - 100，默认值：100。
* @note 如果将 volume 设置成 100 之后感觉音量还是太小，可以将 volume 最大设置成 150，但超过 100 的 volume 会有爆音的风险，请谨慎操作。
*/
- (NSInteger)setCurrentDeviceVolume:(NSInteger)volume deviceType:(TXMediaDeviceType)type;
/**
* 2.5 获取当前设备的音量（仅适用于桌面端）
*
* 这里的音量指的是麦克风的采集音量或者扬声器的播放音量，摄像头是不支持获取音量的。
*/
- (NSInteger)getCurrentDeviceVolume:(TXMediaDeviceType)type;
/**
* 2.6 设置当前设备的静音状态（仅适用于桌面端）
*
* 这里的音量指的是麦克风和扬声器，摄像头是不支持静音操作的。
*/
- (NSInteger)setCurrentDeviceMute:(BOOL)mute deviceType:(TXMediaDeviceType)type;
/**
* 2.7 获取当前设备的静音状态（仅适用于桌面端）
*
* 这里的音量指的是麦克风和扬声器，摄像头是不支持静音操作的。
*/
- (BOOL)getCurrentDeviceMute:(TXMediaDeviceType)type;
/**
* 2.8 开始摄像头测试（仅适用于桌面端）
*
* @note 在测试过程中可以使用 {@link setCurrentDevice} 接口切换摄像头。
*/
- (NSInteger)startCameraDeviceTest:(NSView *)view;
/**
* 2.9 结束摄像头测试（仅适用于桌面端）
*/
- (NSInteger)stopCameraDeviceTest;
/**
* 2.10 开始麦克风测试（仅适用于桌面端）
*
* 该接口可以测试麦克风是否能正常工作，测试到的麦克风采集音量的大小，会以回调的形式通知给您，其中 volume 的取值范围为0 - 100。
* @param interval 麦克风音量的回调间隔。
*/
- (NSInteger)startMicDeviceTest:(NSInteger)interval testEcho:(void (^)(NSInteger volume))testEcho;
/**
* 2.11 结束麦克风测试（仅适用于桌面端）
*/
- (NSInteger)stopMicDeviceTest;
/**
* 2.12 开始扬声器测试（仅适用于桌面端）
*
* 该接口通过播放指定的音频文件，用于测试播放设备是否能正常工作。如果用户在测试时能听到声音，说明播放设备能正常工作。
* @param filePath 声音文件的路径
*/
- (NSInteger)startSpeakerDeviceTest:(NSString *)audioFilePath onVolumeChanged:(void (^)(NSInteger volume, BOOL isLastFrame))volumeBlock;
/**
* 2.13 结束扬声器测试（仅适用于桌面端）
*/
- (NSInteger)stopSpeakerDeviceTest;
/**
* 2.14 设备热插拔回调（仅适用于 Mac 系统）
*/
- (void)setObserver:(nullable id<TXDeviceObserver>)observer;
#endif
/// @}
@end
/// @}
... ...
#ifndef TXLiteAVBuffer_h
#define TXLiteAVBuffer_h
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
namespace liteav {
/**
* Buffer 数据类型
*/
class TXLiteAVBuffer {
public:
virtual ~TXLiteAVBuffer() {}
/**
* 获取 buffer 的内存地址
*/
virtual uint8_t * data() = 0;
/**
* 获取 buffer 的内存地址
*/
virtual const uint8_t * cdata() const = 0;
/**
* 获取 buffer 的内存size
*/
virtual size_t size() const = 0;
/**
* 设置 buffe 的有效数据 size
* 如果此 size 超过当前 capacity，会造成重新分配内存，并复制数据
*/
virtual void SetSize(size_t size) = 0;
/**
* 确保 buffer 分配的内存空间足够，不用多次分配拷贝内存。此方法会引起内存分配，data / cdata 方法获取的指针失效
* @param capacity buffer 预分配的内存size
*/
virtual void EnsureCapacity(size_t capacity) = 0;
};
}
#endif /* TXLiteAVBuffer_h */
... ...
... ... @@ -22,15 +22,18 @@ typedef enum TXLiteAVError
// NOTE: 通过回调函数 TRTCCloudDelegate##onEnterRoom() 和 TRTCCloudDelegate##OnError() 通知
//
/////////////////////////////////////////////////////////////////////////////////
ERR_ROOM_ENTER_FAIL = -3301, ///< 进入房间失败
ERR_ENTER_ROOM_PARAM_NULL = -3316, ///< 进房参数为空，请检查 enterRoom:appScene: 接口调用是否传入有效的 param
ERR_SDK_APPID_INVALID = -3317, ///< 进房参数 sdkAppId 错误
ERR_ROOM_ID_INVALID = -3318, ///< 进房参数 roomId 错误
ERR_USER_ID_INVALID = -3319, ///< 进房参数 userID 不正确
ERR_USER_SIG_INVALID = -3320, ///< 进房参数 userSig 不正确
ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT = -3308, ///< 请求进房超时，请检查网络
ERR_SERVER_INFO_SERVICE_SUSPENDED = -100013, ///< 服务不可用。请检查：套餐包剩余分钟数是否大于0，腾讯云账号是否欠费
ERR_ROOM_ENTER_FAIL = -3301, ///< 进入房间失败，请查看 onError 中的 -3301 对应的 msg 提示确认失败原因
ERR_ROOM_REQUEST_IP_TIMEOUT = -3307, ///< 请求 IP 和 sig 超时，请检查网络是否正常，或网络防火墙是否放行 UDP。可尝试访问下列 IP：162.14.22.165:8000 162.14.6.105:8000 和域名：default-query.trtc.tencent-cloud.com:8000
ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT = -3308, ///< 请求进房超时，请检查是否断网或者是否开启vpn，您也可以切换4G进行测试确认
ERR_ENTER_ROOM_PARAM_NULL = -3316, ///< 进房参数为空，请检查： enterRoom:appScene: 接口调用是否传入有效的 param
ERR_SDK_APPID_INVALID = -3317, ///< 进房参数 sdkAppId 错误，请检查 TRTCParams.sdkAppId 是否为空
ERR_ROOM_ID_INVALID = -3318, ///< 进房参数 roomId 错误，请检查 TRTCParams.roomId 或 TRTCParams.strRoomId 是否为空，注意 roomId 和 strRoomId 不可混用
ERR_USER_ID_INVALID = -3319, ///< 进房参数 userId 不正确，请检查 TRTCParams.userId 是否为空
ERR_USER_SIG_INVALID = -3320, ///< 进房参数 userSig 不正确，请检查 TRTCParams.userSig 是否为空
ERR_ROOM_REQUEST_ENTER_ROOM_REFUSED = -3340, ///< 进房请求被拒绝，请检查是否连续调用 enterRoom 进入相同 Id 的房间
ERR_SERVER_INFO_PRIVILEGE_FLAG_ERROR = -100006, ///< 您开启了高级权限控制，但参数 TRTCParams.privateMapKey 校验失败，您可参考 https://cloud.tencent.com/document/product/647/32240 进行检查
ERR_SERVER_INFO_SERVICE_SUSPENDED = -100013, ///< 服务不可用。请检查：套餐包剩余分钟数是否大于0，腾讯云账号是否欠费。您可参考 https://cloud.tencent.com/document/product/647/50492 进行查看与配置
ERR_SERVER_INFO_ECDH_GET_TINYID = -100018, ///< UserSig 校验失败，请检查参数 TRTCParams.userSig 是否填写正确，或是否已经过期。您可参考 https://cloud.tencent.com/document/product/647/50686 进行校验
/////////////////////////////////////////////////////////////////////////////////
//
... ... @@ -40,11 +43,11 @@ typedef enum TXLiteAVError
/////////////////////////////////////////////////////////////////////////////////
ERR_ROOM_REQUEST_QUIT_ROOM_TIMEOUT = -3325, ///< 请求退房超时
/////////////////////////////////////////////////////////////////////////////////
//
// 设备（摄像头、麦克风、扬声器）相关错误码
// NOTE: 通过回调函数 TRTCCloudDelegate##OnError() 通知
// 区段：-6000 ~ -6999
//
/////////////////////////////////////////////////////////////////////////////////
ERR_CAMERA_START_FAIL = -1301, ///< 打开摄像头失败，例如在 Windows 或 Mac 设备，摄像头的配置程序（驱动程序）异常，禁用后重新启用设备，或者重启机器，或者更新配置程序
... ... @@ -60,6 +63,15 @@ typedef enum TXLiteAVError
ERR_SPEAKER_SET_PARAM_FAIL = -1322, ///< 扬声器设置参数失败
ERR_SPEAKER_STOP_FAIL = -1323, ///< 停止扬声器失败
/////////////////////////////////////////////////////////////////////////////////
//
// 系统声音采集相关错误码
// NOTE: 通过回调函数 TRTCCloudDelegate##onSystemAudioLoopbackError() 通知
//
/////////////////////////////////////////////////////////////////////////////////
ERR_AUDIO_PLUGIN_START_FAIL = -1330, ///< 开启系统声音录制失败，例如音频驱动插件不可用
ERR_AUDIO_PLUGIN_INSTALL_NOT_AUTHORIZED = -1331, ///< 安装音频驱动插件未授权
ERR_AUDIO_PLUGIN_INSTALL_FAILED = -1332, ///< 安装音频驱动插件失败
/////////////////////////////////////////////////////////////////////////////////
//
... ... @@ -68,10 +80,10 @@ typedef enum TXLiteAVError
//
/////////////////////////////////////////////////////////////////////////////////
ERR_SCREEN_CAPTURE_START_FAIL = -1308, ///< 开始录屏失败，如果在移动设备出现，可能是权限被用户拒绝了，如果在 Windows 或 Mac 系统的设备出现，请检查录屏接口的参数是否符合要求
ERR_SCREEN_CAPTURE_UNSURPORT = -1309, ///< 录屏失败，在 Android 平台，需要5.0以上的系统
ERR_SCREEN_CAPTURE_UNSURPORT = -1309, ///< 录屏失败，在 Android 平台，需要5.0以上的系统，在 iOS 平台，需要11.0以上的系统
ERR_SERVER_CENTER_NO_PRIVILEDGE_PUSH_SUB_VIDEO = -102015, ///< 没有权限上行辅路
ERR_SERVER_CENTER_ANOTHER_USER_PUSH_SUB_VIDEO = -102016, ///< 其他用户正在上行辅路
ERR_SCREEN_CAPTURE_STOPPED = -7001, ///< 录屏被系统中止
/////////////////////////////////////////////////////////////////////////////////
//
... ... @@ -84,7 +96,6 @@ typedef enum TXLiteAVError
ERR_AUDIO_ENCODE_FAIL = -1304, ///< 音频帧编码失败，例如传入自定义音频数据，SDK 无法处理
ERR_UNSUPPORTED_SAMPLERATE = -1306, ///< 不支持的音频采样率
/////////////////////////////////////////////////////////////////////////////////
//
// 自定义采集相关错误码
... ... @@ -94,7 +105,6 @@ typedef enum TXLiteAVError
ERR_PIXEL_FORMAT_UNSUPPORTED = -1327, ///< 设置的 pixel format 不支持
ERR_BUFFER_TYPE_UNSUPPORTED = -1328, ///< 设置的 buffer type 不支持
/////////////////////////////////////////////////////////////////////////////////
//
// CDN 绑定和混流相关错误码
... ... @@ -110,7 +120,6 @@ typedef enum TXLiteAVError
ERR_ROOM_REQUEST_STOP_PUBLISHING_TIMEOUT = -3335, ///< 停止向腾讯云的直播 CDN 推流信令超时
ERR_ROOM_REQUEST_STOP_PUBLISHING_ERROR = -3336, ///< 停止向腾讯云的直播 CDN 推流信令异常
/////////////////////////////////////////////////////////////////////////////////
//
// 跨房连麦（ConnectOtherRoom）相关错误码
... ... @@ -143,7 +152,6 @@ typedef enum TXLiteAVError
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL = -102050, ///< 被连麦用户达到资源上限
ERR_SERVER_CENTER_CONN_ROOM_INVALID_SEQ = -102051, ///< 连麦请求序号错乱
/////////////////////////////////////////////////////////////////////////////////
//
// 客户无需关心的内部错误码
... ... @@ -166,13 +174,15 @@ typedef enum TXLiteAVError
ERR_PLAY_LIVE_STREAM_SWITCH_FAIL = -2307, ///< 直播，切流失败（切流可以播放不同画面大小的视频）
ERR_PLAY_LIVE_STREAM_SERVER_REFUSE = -2308, ///< 直播，服务器拒绝连接请求
ERR_RTMP_ACC_FETCH_STREAM_FAIL = -2309, ///< 直播，RTMPACC 低延时拉流失败，且经过多次重试无法恢复
ERR_HEVC_ENCODE_FAIL = -2310, ///< 265编码失败
ERR_HEVC_ENCODE_NOT_SUPPORT = -2311, ///< 265编码判断不支持
ERR_HEVC_SOFTDECODER_START_FAIL = -2312, ///< 265软解启动失败
ERR_ROOM_HEARTBEAT_FAIL = -3302, ///< 心跳失败，客户端定时向服务器发送数据包，告诉服务器自己活着，这个错误通常是发包超时
ERR_ROOM_REQUEST_IP_FAIL = -3303, ///< 拉取接口机服务器地址失败
ERR_ROOM_CONNECT_FAIL = -3304, ///< 连接接口机服务器失败
ERR_ROOM_REQUEST_AVSEAT_FAIL = -3305, ///< 请求视频位失败
ERR_ROOM_REQUEST_TOKEN_HTTPS_TIMEOUT = -3306, ///< 请求 token HTTPS 超时，请检查网络是否正常，或网络防火墙是否放行 HTTPS 访问 official.opensso.tencent-cloud.com:443
ERR_ROOM_REQUEST_IP_TIMEOUT = -3307, ///< 请求 IP 和 sig 超时，请检查网络是否正常，或网络防火墙是否放行 UDP 访问下列 IP 和域名 query.tencent-cloud.com:8000 162.14.23.140:8000 162.14.7.49:8000
ERR_ROOM_REQUEST_VIDEO_FLAG_TIMEOUT = -3309, ///< 请求视频位超时
ERR_ROOM_REQUEST_VIDEO_DATA_ROOM_TIMEOUT = -3310, ///< 请求视频数据超时
ERR_ROOM_REQUEST_CHANGE_ABILITY_TIMEOUT = -3311, ///< 请求修改视频能力项超时
... ... @@ -180,6 +190,7 @@ typedef enum TXLiteAVError
ERR_ROOM_REQUEST_CLOSE_VIDEO_TIMEOUT = -3313, ///< 请求关闭视频超时
ERR_ROOM_REQUEST_SET_RECEIVE_TIMEOUT = -3314, ///< 请求接收视频项超时
ERR_ROOM_REQUEST_TOKEN_INVALID_PARAMETER = -3315, ///< 请求 token 无效参数，请检查 TRTCParams.userSig 是否填写正确
ERR_ROOM_REQUEST_EXIT_ROOM_WHEN_ENTERING_ROOM = -3341, ///< 进房尚未成功时，收到了退房请求
ERR_ROOM_REQUEST_AES_TOKEN_RETURN_ERROR = -3329, ///< 请求 AES TOKEN 时，server 返回的内容是空的
ERR_ACCIP_LIST_EMPTY = -3331, ///< 请求接口机 IP 返回的列表为空的
... ... @@ -192,7 +203,6 @@ typedef enum TXLiteAVError
ERR_SERVER_INFO_GENERATE_SIGN_FAILED = -100003, ///< 生成签名错误
ERR_SERVER_INFO_TOKEN_TIMEOUT = -100004, ///< HTTPS token 超时
ERR_SERVER_INFO_INVALID_COMMAND = -100005, ///< 无效的命令字
ERR_SERVER_INFO_PRIVILEGE_FLAG_ERROR = -100006, ///< 权限位校验失败
ERR_SERVER_INFO_GENERATE_KEN_ERROR = -100007, ///< HTTPS 请求时，生成加密 key 错误
ERR_SERVER_INFO_GENERATE_TOKEN_ERROR = -100008, ///< HTTPS 请求时，生成 token 错误
ERR_SERVER_INFO_DATABASE = -100009, ///< 数据库查询失败（房间相关存储信息）
... ... @@ -203,7 +213,6 @@ typedef enum TXLiteAVError
ERR_SERVER_INFO_LACK_SDKAPPID = -100015, ///< 非法SDKAppid
ERR_SERVER_INFO_INVALID = -100016, ///< 无效请求, 分配接口机失败
ERR_SERVER_INFO_ECDH_GET_KEY = -100017, ///< 生成公钥失败
ERR_SERVER_INFO_ECDH_GET_TINYID = -100018, ///< userSig 校验失败，请检查 TRTCParams.userSig 是否填写正确
// Access 接口机
ERR_SERVER_ACC_TOKEN_TIMEOUT = -101000, ///< token 过期
... ... @@ -274,6 +283,13 @@ typedef enum TXLiteAVError
ERR_SERVER_SSO_TICKET_EXPIRED = -70347, ///< 票据因过期原因校验失败
ERR_SERVER_SSO_ACCOUNT_EXCEED_PURCHASES = -70398, ///< 创建账号数量超过已购买预付费数量限制
ERR_SERVER_SSO_INTERNAL_ERROR = -70500, ///< 服务器内部错误，请重试
//秒级监控上报错误码
ERR_REQUEST_QUERY_CONFIG_TIMEOUT = -4001, ///< 请求通用配置超时
ERR_CUSTOM_STREAM_INVALID = -4002, ///< 自定义流id错误
ERR_USER_DEFINE_RECORD_ID_INVALID = -4003, ///< userDefineRecordId错误
ERR_MIX_PARAM_INVALID = -4004, ///< 混流参数校验失败
ERR_REQUEST_ACC_BY_HOST_IP = -4005, ///< 通过域名进行0x1请求
// - /Remove From Head
} TXLiteAVError;
... ... @@ -288,10 +304,19 @@ typedef enum TXLiteAVError
typedef enum TXLiteAVWarning
{
WARNING_HW_ENCODER_START_FAIL = 1103, ///< 硬编码启动出现问题，自动切换到软编码
WARNING_CURRENT_ENCODE_TYPE_CHANGED = 1104, ///< 当前编码格式, 通过key 为type获取，值为1时是265编码，值为0时是264编码
WARNING_VIDEO_ENCODER_SW_TO_HW = 1107, ///< 当前 CPU 使用率太高，无法满足软件编码需求，自动切换到硬件编码
WARNING_INSUFFICIENT_CAPTURE_FPS = 1108, ///< 摄像头采集帧率不足，部分自带美颜算法的 Android 手机上会出现
WARNING_SW_ENCODER_START_FAIL = 1109, ///< 软编码启动失败
WARNING_REDUCE_CAPTURE_RESOLUTION = 1110, ///< 摄像头采集分辨率被降低，以满足当前帧率和性能最优解。
WARNING_CAMERA_DEVICE_EMPTY = 1111, ///< 没有检测到可用的摄像头设备
WARNING_CAMERA_NOT_AUTHORIZED = 1112, ///< 用户未授权当前应用使用摄像头
WARNING_MICROPHONE_DEVICE_EMPTY = 1201, ///< 没有检测到可用的麦克风设备
WARNING_SPEAKER_DEVICE_EMPTY = 1202, ///< 没有检测到可用的扬声器设备
WARNING_MICROPHONE_NOT_AUTHORIZED = 1203, ///< 用户未授权当前应用使用麦克风
WARNING_MICROPHONE_DEVICE_ABNORMAL = 1204, ///< 音频采集设备不可用（例如被占用或者PC判定无效设备）
WARNING_SPEAKER_DEVICE_ABNORMAL = 1205, ///< 音频播放设备不可用（例如被占用或者PC判定无效设备）
WARNING_SCREEN_CAPTURE_NOT_AUTHORIZED = 1206, ///< 用户未授权当前应用使用屏幕录制
WARNING_VIDEO_FRAME_DECODE_FAIL = 2101, ///< 当前视频帧解码失败
WARNING_AUDIO_FRAME_DECODE_FAIL = 2102, ///< 当前音频帧解码失败
WARNING_VIDEO_PLAY_LAG = 2105, ///< 当前视频播放出现卡顿
... ... @@ -299,6 +324,7 @@ typedef enum TXLiteAVWarning
WARNING_VIDEO_DECODER_HW_TO_SW = 2108, ///< 当前流硬解第一个 I 帧失败，SDK 自动切软解
WARNING_SW_DECODER_START_FAIL = 2109, ///< 软解码器启动失败
WARNING_VIDEO_RENDER_FAIL = 2110, ///< 视频渲染失败
WARNING_START_CAPTURE_IGNORED = 4000, ///< 已经在采集，启动采集被忽略
WARNING_AUDIO_RECORDING_WRITE_FAIL = 7001, ///< 音频录制写入文件失败
WARNING_ROOM_DISCONNECT = 5101, ///< 网络断开连接
WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE = 6001, ///< 当前是观众角色，忽略上行音视频数据
... ... @@ -379,6 +405,10 @@ typedef enum TXLiteAVEvent
EVT_MIC_START_SUCC = 2027, ///< 麦克风启动成功
EVT_PLAY_GET_METADATA = 2028, ///< 视频流MetaData事件
EVT_MIC_RELEASE_SUCC = 2029, ///< 释放麦克风占用
EVT_AUDIO_DEVICE_ROUTE_CHANGED = 2030, ///< 音频设备的route发生改变，即当前的输入输出设备发生改变，比如耳机被拔出
EVT_PLAY_GET_FLVSESSIONKEY = 2031, ///< TXLivePlayer 接收到http响应头中的 flvSessionKey 信息
EVT_AUDIO_SESSION_INTERRUPT = 2032, ///< Audio Session Interrupt事件
EVT_ROOM_ENTER = 1018, ///< 进入房间成功
EVT_ROOM_EXIT = 1019, ///< 退出房间
... ...
/*
* Module: live 编码数据回调
*
* Function: 回调推流端编码完，和 播放端解码前的数据
*
*/
#ifndef TXLiteAVEncodedDataProcessingListener_h
#define TXLiteAVEncodedDataProcessingListener_h
#include <stdio.h>
#include "TXLiteAVBuffer.h"
namespace liteav {
struct TXLiteAVEncodedData {
const char * userId; // didEncodeVideo 和 didEncodeAudio 回调时，此字段为null；
int streamType; // 视频流类型，参考 TRTCVideoStreamType，audio时，此字段为0
const liteav::TXLiteAVBuffer * originData; // 原始数据
liteav::TXLiteAVBuffer * processedData; // 写回处理后的数据
};
class ITXLiteAVEncodedDataProcessingListener {
public:
virtual ~ITXLiteAVEncodedDataProcessingListener() {}
/**
* 回调编码完的视频数据。
* @note videoData.userId = nullptr
*/
virtual bool didEncodeVideo(TXLiteAVEncodedData & videoData) { return false; }
/**
* 回调解码前的视频数据。
* @note videoData.userId 表示对应的user，当userId 为 nullptr时，表示此时先接收到数据了，对应的userId还未完成同步。获取到userId之后会回调正确的userId
*/
virtual bool willDecodeVideo(TXLiteAVEncodedData & videoData) { return false; }
/**
* 回调编码完的音频数据。
* @note audioData.userId = nullptr
*/
virtual bool didEncodeAudio(TXLiteAVEncodedData & audioData) { return false; }
/**
* 回调解码前的音频数据。
* @note audioData.userId 表示对应的user，当userId 为 nullptr时，表示此时先接收到数据了，对应的userId还未完成同步。获取到userId之后会回调正确的userId
*/
virtual bool willDecodeAudio(TXLiteAVEncodedData & audioData) { return false; }
};
}
#endif /* TXLiteAVEncodedDataProcessingListener_h */
... ...
... ... @@ -13,8 +13,10 @@
#import <TXLiteAVSDK_TRTC/TRTCCloudDelegate.h>
#import <TXLiteAVSDK_TRTC/TRTCStatistics.h>
#import <TXLiteAVSDK_TRTC/TXAudioCustomProcessDelegate.h>
#import <TXLiteAVSDK_TRTC/TXAudioEffectManager.h>
#import <TXLiteAVSDK_TRTC/TXAudioRawDataDelegate.h>
#import <TXLiteAVSDK_TRTC/TXBeautyManager.h>
#import <TXLiteAVSDK_TRTC/TXDeviceManager.h>
#import <TXLiteAVSDK_TRTC/TXLiteAVCode.h>
#import <TXLiteAVSDK_TRTC/TXLiveAudioSessionDelegate.h>
#import <TXLiteAVSDK_TRTC/TXLiveBase.h>
... ... @@ -26,3 +28,8 @@
#import <TXLiteAVSDK_TRTC/TXLiveSDKEventDef.h>
#import <TXLiteAVSDK_TRTC/TXLiveSDKTypeDef.h>
#import <TXLiteAVSDK_TRTC/TXVideoCustomProcessDelegate.h>
#import <TXLiteAVSDK_TRTC/V2TXLiveCode.h>
#import <TXLiteAVSDK_TRTC/V2TXLiveDef.h>
#import <TXLiteAVSDK_TRTC/V2TXLivePlayer.h>
#import <TXLiteAVSDK_TRTC/V2TXLivePlayerObserver.h>
#import <TXLiteAVSDK_TRTC/V2TXLivePremier.h>
... ...
... ... @@ -10,6 +10,9 @@
- (BOOL)setActive:(BOOL)active error:(NSError **)outError;
@optional
- (BOOL)setActive:(BOOL)active withOptions:(AVAudioSessionSetActiveOptions)options error:(NSError **)outError;
@optional
- (BOOL)setMode:(NSString *)mode error:(NSError **)outError;
@optional
... ... @@ -27,7 +30,14 @@
- (BOOL)setPreferredSampleRate:(double)sampleRate error:(NSError **)outError;
@optional
- (BOOL)setPreferredOutputNumberOfChannels:(NSInteger)count error:(NSError **)outError;
@optional
- (BOOL)overrideOutputAudioPort:(AVAudioSessionPortOverride)portOverride error:(NSError **)outError;
@optional
- (BOOL)setPreferredInput:(nullable AVAudioSessionPortDescription *)inPort error:(NSError **)outError;
#endif
@end
#endif /* TXLiveAudioSessionDelegate_h */
... ...
... ... @@ -28,7 +28,20 @@ typedef NS_ENUM(NSInteger, TX_Enum_Type_LogLevel) {
3.level类型参见TX_Enum_Type_LogLevel
4.module值暂无具体意义，目前为固定值TXLiteAVSDK
*/
-(void) onLog:(NSString*)log LogLevel:(int)level WhichModule:(NSString*)module;
- (void)onLog:(NSString*)log LogLevel:(int)level WhichModule:(NSString*)module;
/**
* @brief NTP 校时回调，调用 TXLiveBase updateNetworkTime 后会触发
* @param errCode 0：表示校时成功且偏差在30ms以内，1：表示校时成功但偏差可能在 30ms 以上，-1：表示校时失败
*/
- (void)onUpdateNetworkTime:(int)errCode message:(NSString *)errMsg;
/**
@brief setLicenceURL 接口回调, result = 0 成功，负数失败。
@discussion
需在调用 setLicenceURL 前设置 delegate
*/
- (void)onLicenceLoaded:(int)result Reason:(NSString *)reason;
@end
... ... @@ -37,36 +50,85 @@ typedef NS_ENUM(NSInteger, TX_Enum_Type_LogLevel) {
/// 通过这个delegate将全部log回调给SDK使用者，由SDK使用者来决定log如何处理
@property (nonatomic, weak) id<TXLiveBaseDelegate> delegate;
+ (instancetype) sharedInstance;
+ (instancetype)sharedInstance;
/** 设置log输出级别
* @param level 参见 LOGLEVEL
/**
* 设置 liteav SDK 接入的环境。
* 腾讯云在全球各地区部署的环境，按照各地区政策法规要求，需要接入不同地区接入点。
*
* @param env_config 需要接入的环境，SDK 默认接入的环境是：默认正式环境。
* @return 0：成功；其他：错误
*
* @note 目标市场为中国大陆的客户请不要调用此接口，如果目标市场为海外用户，请通过技术支持联系我们，了解 env_config 的配置方法，以确保 App 遵守 GDPR 标准。
*/
+ (void) setLogLevel:(TX_Enum_Type_LogLevel)level;
+ (int)setGlobalEnv:(const char *)env_config;
/**
* 设置 log 输出级别
* @param level 参见 LOGLEVEL
*/
+ (void)setLogLevel:(TX_Enum_Type_LogLevel)level;
/**
* 启用或禁用控制台日志打印
* @param enabled 指定是否启用
*/
+ (void) setConsoleEnabled:(BOOL)enabled;
+ (void)setConsoleEnabled:(BOOL)enabled;
+ (void) setAppVersion:(NSString *)verNum;
+ (void)setAppVersion:(NSString *)verNum;
+ (void)setAudioSessionDelegate:(id<TXLiveAudioSessionDelegate>)delegate;
/// 获取SDK版本信息
/**
* @brief 获取 SDK 版本信息
* @return SDK 版本信息
*/
+ (NSString *)getSDKVersionStr;
///　 获取pitu版本信息
/**
* @brief 获取 pitu 版本信息
* @return pitu 版本信息
*/
+ (NSString *)getPituSDKVersion;
/// 设置appID，云控使用
/**
* @brief 设置 appID，云控使用
*/
+ (void)setAppID:(NSString*)appID;
/// 设置sdk的licence下载url和key
/**
* @brief 设置 sdk 的 Licence 下载 url 和 key
*/
+ (void)setLicenceURL:(NSString *)url key:(NSString *)key;
/// 获取 Licence 信息
/**
* @brief 设置 userId，用于数据上报
*/
+ (void)setUserId:(NSString *)userId;
/**
* @brief 获取 Licence 信息
* @return Licence 信息
*/
+ (NSString *)getLicenceInfo;
/**
* @brief 设置 HEVC 外部解码器工厂实例
*/
+ (void)setExternalDecoderFactory:(id)decoderFactory;
/**
* 启动 NTP 校时服务
*
* @return 0：启动成功；< 0：启动失败
*/
+ (NSInteger)updateNetworkTime;
/**
* 获取 NTP 时间戳（毫秒），请在收到 onUpdateNetworkTime 回调后使用
*
* @return NTP 时间戳（毫秒），若返回 0：未启动 NTP 校时或校时失败，请重启校时
*/
+ (NSInteger)getNetworkTimestamp;
@end
... ...
... ... @@ -65,6 +65,16 @@
///【特别说明】每条音视频流中只能设置一个 MetaData 数据头，除非断网重连，否则 TXLivePlayer 的 EVT_PLAY_GET_METADATA 消息也只会收到一次。
@property(nonatomic, assign) BOOL enableMetaData;
///【字段含义】是否开启 HTTP 头信息回调，默认值为 @“”
/// HTTP 响应头中除了“content-length”、“content-type”等标准字段，不同云服务商还可能会添加一些非标准字段。
/// 比如腾讯云会在直播 CDN 的 HTTP-FLV 格式的直播流中增加 “X-Tlive-SpanId” 响应头，并在其中设置一个随机字符串，用来唯一标识一次直播。
///
/// 如果您在使用腾讯云的直播 CDN，可以设置 flvSessionKey 为 @“X-Tlive-SpanId”，SDK 会在 HTTP 响应头里解析这个字段，
/// 并通过 TXLivePlayListener 中的 onPlayEvent(EVT_PLAY_GET_FLVSESSIONKEY) 事件通知给您的 App。
///
///【特别说明】每条音视频流中只能解析一个 flvSessionKey，除非断网重连，否则 EVT_PLAY_GET_FLVSESSIONKEY 只会抛送一次。
@property(nonatomic, copy) NSString* flvSessionKey;
///【字段含义】视频渲染对象回调的视频格式，默认值：kCVPixelFormatType_420YpCbCr8Planar
///【特别说明】支持：kCVPixelFormatType_420YpCbCr8Planar 和 kCVPixelFormatType_420YpCbCr8BiPlanarFullRange
@property(nonatomic, assign) OSType playerPixelFormatType;
... ... @@ -82,14 +92,12 @@
///【字段含义】RTMP 传输通道的类型，待废弃，默认值为：RTMP_CHANNEL_TYPE_AUTO
@property (nonatomic, assign) int rtmpChannelType;
#if TARGET_OS_IPHONE
///【字段含义】视频缓存目录，点播 MP4、HLS 有效
@property NSString *cacheFolderPath;
///【字段含义】最多缓存文件个数，默认值：0
@property int maxCacheItems;
///【字段含义】自定义 HTTP Headers
@property NSDictionary *headers;
#endif
@end
/// @}
... ...
... ... @@ -30,20 +30,16 @@ typedef NS_ENUM(NSInteger, TX_Enum_PlayType) {
PLAY_TYPE_LIVE_RTMP = 0,
/// FLV 直播
PLAY_TYPE_LIVE_FLV = 1,
#if TARGET_OS_IPHONE
/// FLV 点播
PLAY_TYPE_VOD_FLV = 2,
/// HLS 点播
PLAY_TYPE_VOD_HLS = 3,
/// MP4点播
PLAY_TYPE_VOD_MP4 = 4,
#endif
/// RTMP 直播加速播放
PLAY_TYPE_LIVE_RTMP_ACC = 5,
#if TARGET_OS_IPHONE
/// 本地视频文件
PLAY_TYPE_LOCAL_VIDEO = 6,
#endif
};
... ... @@ -90,8 +86,6 @@ typedef NS_ENUM(NSInteger, TX_Enum_PlayType) {
*/
@property(nonatomic, copy) TXLivePlayConfig *config;
#if TARGET_OS_IPHONE
/**
* 1.6 设置短视频录制回调，见 “TXLiveRecordListener.h” 文件中的详细定义
*/
... ... @@ -100,8 +94,8 @@ typedef NS_ENUM(NSInteger, TX_Enum_PlayType) {
/**
* 1.7 startPlay 后是否立即播放，默认 YES，只有点播有效
*/
@property BOOL isAutoPlay;
#endif
@property (nonatomic) BOOL isAutoPlay;
/// @}
... ... @@ -197,14 +191,20 @@ typedef NS_ENUM(NSInteger, TX_Enum_PlayType) {
*/
- (void)setRenderMode:(TX_Enum_Type_RenderMode)renderMode;
#if TARGET_OS_IPHONE
/**
* 3.3 截屏
*
* @param snapshotCompletionBlock 通过回调返回当前图像
*/
- (void)snapshot:(void (^)(TXImage *))snapshotCompletionBlock;
#endif
/**
* 3.4 获取当前渲染帧 pts
*
* @return 0：当前未处于正在播放状态（例如：未起播）
* >0：当前渲染视频帧的 pts，处于正在播放状态 (单位: 毫秒)
*/
- (uint64_t)getCurrentRenderPts;
/// @}
... ...
... ... @@ -46,6 +46,7 @@ enum EventID
PUSH_WARNING_SHAKE_FAIL = WARNING_RTMP_SHAKE_FAIL, ///< RTMP服务器握手失败
PUSH_WARNING_SERVER_DISCONNECT = WARNING_RTMP_SERVER_BREAK_CONNECT, ///< RTMP服务器主动断开，请检查推流地址的合法性或防盗链有效期
PUSH_WARNING_READ_WRITE_FAIL = WARNING_RTMP_READ_WRITE_FAIL, ///< RTMP 读/写失败，将会断开连接。
PUSH_WARNING_HEVC_ENCODE_NOT_SUPPORT = ERR_HEVC_ENCODE_NOT_SUPPORT, ///< 265编码判断不支持
/*内部事件*/INNER_EVT_SET_BITRATE_4_SCREEN_CAPTURE = 100001, ///< 动态设置录屏编码码率
/*内部事件*/INNER_EVT_BGM_PLAY_FINISH = 100002, ///< BGM播放完毕
... ... @@ -58,6 +59,7 @@ enum EventID
PLAY_EVT_CONNECT_SUCC = EVT_PLAY_LIVE_STREAM_CONNECT_SUCC, ///< 直播，已经连接RTMP拉流服务器
PLAY_EVT_RTMP_STREAM_BEGIN = EVT_PLAY_LIVE_STREAM_BEGIN, ///< 直播，已经与RTMP服务器握手完毕，开始拉流
PLAY_EVT_RCV_FIRST_I_FRAME = EVT_RENDER_FIRST_I_FRAME, ///< 渲染首个视频数据包(IDR)
PLAY_EVT_RCV_FIRST_AUDIO_FRAME = EVT_AUDIO_JITTER_STATE_FIRST_PLAY, ///< 音频首次播放
PLAY_EVT_PLAY_BEGIN = EVT_VIDEO_PLAY_BEGIN, ///< 视频播放开始
PLAY_EVT_PLAY_PROGRESS = EVT_VIDEO_PLAY_PROGRESS, ///< 视频播放进度
PLAY_EVT_PLAY_END = EVT_VIDEO_PLAY_END, ///< 视频播放结束
... ... @@ -71,6 +73,8 @@ enum EventID
PLAY_EVT_VOD_LOADING_END = EVT_VOD_PLAY_LOADING_END, ///< 点播，loading结束
PLAY_EVT_STREAM_SWITCH_SUCC = EVT_PLAY_LIVE_STREAM_SWITCH_SUCC, ///< 直播，切流成功（切流可以播放不同画面大小的视频）
PLAY_EVT_GET_METADATA = EVT_PLAY_GET_METADATA, ///< TXLivePlayer 接收到视频流中的 metadata 头信息（一条视频流仅触发一次）
PLAY_EVT_GET_FLVSESSIONKEY = EVT_PLAY_GET_FLVSESSIONKEY, ///< TXLivePlayer 接收到http响应头中的 flvSessionKey 信息
PLAY_EVT_AUDIO_SESSION_INTERRUPT = EVT_AUDIO_SESSION_INTERRUPT, ///< Audio Session Interrupt事件
PLAY_ERR_NET_DISCONNECT = ERR_PLAY_LIVE_STREAM_NET_DISCONNECT, ///< 直播，网络断连,且经多次重连抢救无效,可以放弃治疗,更多重试请自行重启播放
... ...
... ... @@ -130,7 +130,7 @@ typedef NS_ENUM(NSInteger, TX_Enum_Type_RenderMode) {
typedef NS_ENUM(NSInteger, TX_Enum_Type_BeautyStyle) {
BEAUTY_STYLE_SMOOTH = 0, ///< 光滑，磨皮程度较高，更适合秀场直播类场景下使用。
BEAUTY_STYLE_NATURE = 1, ///< 自然，磨皮算法会最大限度保留皮肤细节。
BEAUTY_STYLE_PITU = 2, ///< 天天P图版美颜, 需要企业版 SDK 才能支持，普通版本设置此选项无效。
BEAUTY_STYLE_PITU = 2, ///< 由上海优图实验室提供的美颜算法，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高。
};
/**
... ... @@ -315,7 +315,7 @@ typedef NS_ENUM(NSInteger, TXCaptureVideoInputSource) {
#define NET_STATUS_AV_PLAY_INTERVAL @"AV_PLAY_INTERVAL" ///> TXLivePlayer：音画同步错位时间（播放），单位 ms，此数值越小，音画同步越好。
#define NET_STATUS_AV_RECV_INTERVAL @"AV_RECV_INTERVAL" ///> TXLivePlayer：音画同步错位时间（网络），单位 ms，此数值越小，音画同步越好。
#define NET_STATUS_AUDIO_CACHE_THRESHOLD @"AUDIO_CACHE_THRESHOLD" ///> TXLivePlayer：音频缓冲时长阈值，缓冲超过该阈值后，播放器会开始调控延时。
#define NET_STATUS_AUDIO_BLOCK_TIME @"AUDIO_BLOCK_TIME" ///> 拉流专用：音频卡顿时长，单位ms
#define NET_STATUS_AUDIO_INFO @"AUDIO_INFO" ///> 音频信息：包括采样率信息和声道数信息
#define NET_STATUS_NET_JITTER @"NET_JITTER" ///> 网络抖动：数值越大表示抖动越大，网络越不稳定
#define NET_STATUS_QUALITY_LEVEL @"NET_QUALITY_LEVEL" ///> 网络质量：0：未定义 1：最好 2：好 3：一般 4：差 5：很差 6：不可用
... ... @@ -339,6 +339,8 @@ typedef NS_ENUM(NSInteger, TXCaptureVideoInputSource) {
*/
#define EVT_MSG @"EVT_MSG" ///> 事件ID
#define EVT_TIME @"EVT_TIME" ///> 事件发生的UTC毫秒时间戳
#define EVT_UTC_TIME @"EVT_UTC_TIME" ///> 事件发生的UTC毫秒时间戳(兼容性)
#define EVT_BLOCK_DURATION @"EVT_BLOCK_DURATION" ///> 卡顿时间（毫秒）
#define EVT_PARAM1 @"EVT_PARAM1" ///> 事件参数1
#define EVT_PARAM2 @"EVT_PARAM2" ///> 事件参数2
#define EVT_GET_MSG @"EVT_GET_MSG" ///> 消息内容，收到PLAY_EVT_GET_MESSAGE事件时，通过该字段获取消息内容
... ...
//
// Copyright © 2020 Tencent. All rights reserved.
//
// Module: V2TXLive
//
#import <Foundation/Foundation.h>
/// @defgroup V2TXLiveCode_ios V2TXLiveCode
/// 腾讯云直播服务(LVB)错误码和警告码的定义。
/// @{
/**
* @brief 错误码和警告码。
*/
typedef NS_ENUM(NSInteger, V2TXLiveCode) {
/// 没有错误
V2TXLIVE_OK = 0,
/// 暂未归类的通用错误
V2TXLIVE_ERROR_FAILED = -1,
/// 调用 API 时，传入的参数不合法
V2TXLIVE_ERROR_INVALID_PARAMETER = -2,
/// API 调用被拒绝
V2TXLIVE_ERROR_REFUSED = -3,
/// 当前 API 不支持调用
V2TXLIVE_ERROR_NOT_SUPPORTED = -4,
/// license 不合法，调用失败
V2TXLIVE_ERROR_INVALID_LICENSE = -5,
/// 请求服务器超时
V2TXLIVE_ERROR_REQUEST_TIMEOUT = -6,
/// 服务器无法处理您的请求
V2TXLIVE_ERROR_SERVER_PROCESS_FAILED = -7,
/////////////////////////////////////////////////////////////////////////////////
//
// 网络相关的警告码
//
/////////////////////////////////////////////////////////////////////////////////
/// 网络状况不佳：上行带宽太小，上传数据受阻
V2TXLIVE_WARNING_NETWORK_BUSY = 1101,
/// 当前视频播放出现卡顿
V2TXLIVE_WARNING_VIDEO_BLOCK = 2105,
/////////////////////////////////////////////////////////////////////////////////
//
// 摄像头相关的警告码
//
/////////////////////////////////////////////////////////////////////////////////
/// 摄像头打开失败
V2TXLIVE_WARNING_CAMERA_START_FAILED = -1301,
/// 摄像头正在被占用中，可尝试打开其他摄像头
V2TXLIVE_WARNING_CAMERA_OCCUPIED = -1316,
/// 摄像头设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_CAMERA_NO_PERMISSION = -1314,
/////////////////////////////////////////////////////////////////////////////////
//
// 麦克风相关的警告码
//
/////////////////////////////////////////////////////////////////////////////////
/// 麦克风打开失败
V2TXLIVE_WARNING_MICROPHONE_START_FAILED = -1302,
/// 麦克风正在被占用中，例如移动设备正在通话时，打开麦克风会失败
V2TXLIVE_WARNING_MICROPHONE_OCCUPIED = -1319,
/// 麦克风设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_MICROPHONE_NO_PERMISSION = -1317,
/////////////////////////////////////////////////////////////////////////////////
//
// 屏幕分享相关警告码
//
/////////////////////////////////////////////////////////////////////////////////
/// 当前系统不支持屏幕分享
V2TXLIVE_WARNING_SCREEN_CAPTURE_NOT_SUPPORTED = -1309,
/// 开始录屏失败，如果在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_SCREEN_CAPTURE_START_FAILED = -1308,
/// 录屏被系统中断
V2TXLIVE_WARNING_SCREEN_CAPTURE_INTERRUPTED = -7001,
};
/// @}
... ...
//
// Copyright © 2020 Tencent. All rights reserved.
//
// Module: V2TXLive
//
/// @defgroup V2TXLiveDef_ios V2TXLiveDef
/// 腾讯云直播服务(LVB)关键类型定义
/// @{
#import "V2TXLiveCode.h"
#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
typedef UIView TXView;
typedef UIImage TXImage;
#elif TARGET_OS_MAC
#import <AppKit/AppKit.h>
typedef NSView TXView;
typedef NSImage TXImage;
#endif
/**
* @brief 支持协议
*/
typedef NS_ENUM(NSUInteger, V2TXLiveMode) {
/// 支持协议: RTMP
V2TXLiveMode_RTMP,
/// 支持协议: TRTC
V2TXLiveMode_RTC
};
/////////////////////////////////////////////////////////////////////////////////
//
// （一）视频相关类型定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 视频相关类型定义
/// @{
/**
* @brief 视频分辨率
*/
typedef NS_ENUM(NSInteger, V2TXLiveVideoResolution) {
/// 分辨率 160*160，码率范围：100Kbps ~ 150Kbps，帧率：15fps
V2TXLiveVideoResolution160x160,
/// 分辨率 270*270，码率范围：200Kbps ~ 300Kbps，帧率：15fps
V2TXLiveVideoResolution270x270,
/// 分辨率 480*480，码率范围：350Kbps ~ 525Kbps，帧率：15fps
V2TXLiveVideoResolution480x480,
/// 分辨率 320*240，码率范围：250Kbps ~ 375Kbps，帧率：15fps
V2TXLiveVideoResolution320x240,
/// 分辨率 480*360，码率范围：400Kbps ~ 600Kbps，帧率：15fps
V2TXLiveVideoResolution480x360,
/// 分辨率 640*480，码率范围：600Kbps ~ 900Kbps，帧率：15fps
V2TXLiveVideoResolution640x480,
/// 分辨率 320*180，码率范围：250Kbps ~ 400Kbps，帧率：15fps
V2TXLiveVideoResolution320x180,
/// 分辨率 480*270，码率范围：350Kbps ~ 550Kbps，帧率：15fps
V2TXLiveVideoResolution480x270,
/// 分辨率 640*360，码率范围：500Kbps ~ 900Kbps，帧率：15fps
V2TXLiveVideoResolution640x360,
/// 分辨率 960*540，码率范围：800Kbps ~ 1500Kbps，帧率：15fps
V2TXLiveVideoResolution960x540,
/// 分辨率 1280*720，码率范围：1000Kbps ~ 1800Kbps，帧率：15fps
V2TXLiveVideoResolution1280x720,
/// 分辨率 1920*1080，码率范围：2500Kbps ~ 3000Kbps，帧率：15fps
V2TXLiveVideoResolution1920x1080
};
/**
* @brief 视频宽高比模式。
*
* @note
* - 横屏模式下的分辨率: V2TXLiveVideoResolution640x360 + V2TXLiveVideoResolutionModeLandscape = 640 × 360
* - 竖屏模式下的分辨率: V2TXLiveVideoResolution640x360 + V2TXLiveVideoResolutionModePortrait = 360 × 640
*/
typedef NS_ENUM(NSInteger, V2TXLiveVideoResolutionMode) {
/// 横屏模式
V2TXLiveVideoResolutionModeLandscape = 0,
/// 竖屏模式
V2TXLiveVideoResolutionModePortrait = 1,
};
/**
* 视频编码参数。
*
* 该设置决定远端用户看到的画面质量。
*/
@interface V2TXLiveVideoEncoderParam : NSObject
///【字段含义】 视频分辨率
///【特别说明】如需使用竖屏分辨率，请指定 videoResolutionMode 为 Portrait，例如： 640 × 360 + Portrait = 360 × 640。
///【推荐取值】
/// - 桌面平台（Win + Mac）：建议选择 640 × 360 及以上分辨率，videoResolutionMode 选择 Landscape，即横屏分辨率。
@property(nonatomic, assign) V2TXLiveVideoResolution videoResolution;
///【字段含义】分辨率模式（横屏分辨率 or 竖屏分辨率）
///【推荐取值】桌面平台（Windows、Mac）建议选择 Landscape。
///【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如： 640 × 360 + Portrait = 360 × 640。
@property(nonatomic, assign) V2TXLiveVideoResolutionMode videoResolutionMode;
///【字段含义】视频采集帧率
///【推荐取值】15fps 或 20fps。5fps 以下，卡顿感明显。10fps 以下，会有轻微卡顿感。20fps 以上，会浪费带宽（电影的帧率为 24fps）。
@property(nonatomic, assign) int videoFps;
///【字段含义】目标视频码率，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率。
///【推荐取值】请参考 V2TXLiveVideoResolution 在各档位注释的最佳码率，也可以在此基础上适当调高。
/// 比如：V2TXLiveVideoResolution1280x720 对应 1200kbps 的目标码率，您也可以设置为 1500kbps 用来获得更好的观感清晰度。
///【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：
/// - 如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。
@property(nonatomic, assign) int videoBitrate;
///【字段含义】最低视频码率，SDK 会在网络不佳的情况下主动降低视频码率以保持流畅度，最低会降至 minVideoBitrate 所设定的数值。
///【推荐取值】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：
/// - 如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。
@property(nonatomic, assign) int minVideoBitrate;
- (instancetype _Nonnull)initWith:(V2TXLiveVideoResolution)resolution;
@end
/**
* @brief 本地摄像头镜像类型。
*/
typedef NS_ENUM(NSInteger, V2TXLiveMirrorType) {
/// 系统默认镜像类型，前置摄像头镜像，后置摄像头不镜像
V2TXLiveMirrorTypeAuto,
/// 前置摄像头和后置摄像头，都切换为镜像模式
V2TXLiveMirrorTypeEnable,
/// 前置摄像头和后置摄像头，都切换为非镜像模式
V2TXLiveMirrorTypeDisable
};
/**
* @brief 视频画面填充模式。
*/
typedef NS_ENUM(NSInteger, V2TXLiveFillMode) {
/// 图像铺满屏幕，超出显示视窗的视频部分将被裁剪，画面显示可能不完整
V2TXLiveFillModeFill,
/// 图像长边填满屏幕，短边区域会被填充黑色，画面的内容完整
V2TXLiveFillModeFit
};
/**
* @brief 视频画面顺时针旋转角度。
*/
typedef NS_ENUM(NSInteger, V2TXLiveRotation) {
/// 不旋转
V2TXLiveRotation0,
/// 顺时针旋转90度
V2TXLiveRotation90,
/// 顺时针旋转180度
V2TXLiveRotation180,
/// 顺时针旋转270度
V2TXLiveRotation270
};
/**
* @brief 视频帧的像素格式。
*/
typedef NS_ENUM(NSInteger, V2TXLivePixelFormat) {
/// 未知
V2TXLivePixelFormatUnknown,
/// YUV420P I420
V2TXLivePixelFormatI420,
/// YUV420SP NV12
V2TXLivePixelFormatNV12,
/// BGRA8888
V2TXLivePixelFormatBGRA32,
/// OpenGL 2D 纹理
V2TXLivePixelFormatTexture2D
};
/**
* @brief 视频数据包装格式。
*
* @note 在自定义采集和自定义渲染功能，您需要用到下列枚举值来指定您希望以什么样的格式来包装视频数据。
* - PixelBuffer：直接使用效率最高，iOS 系统提供了众多 API 获取或处理 PixelBuffer
* - NSData： 当使用自定义渲染时，PixelBuffer拷贝一次到NSData。当使用自定义采集时，NSData拷贝一次到PixelBuffer。因此，性能会受到一定程度的影响
*/
typedef NS_ENUM(NSInteger, V2TXLiveBufferType) {
/// 未知
V2TXLiveBufferTypeUnknown,
/// 直接使用效率最高，iOS 系统提供了众多 API 获取或处理 PixelBuffer
V2TXLiveBufferTypePixelBuffer,
/// 会有一定的性能消耗，SDK 内部是直接处理 PixelBuffer 的，所以会存在 NSData 和 PixelBuffer 之间类型转换所产生的内存拷贝开销
V2TXLiveBufferTypeNSData,
/// 直接操作纹理 ID，性能最好
V2TXLiveBufferTypeTexture
};
/**
* @brief 视频帧信息。
* V2TXLiveVideoFrame 用来描述一帧视频画面的裸数据，它可以是一帧编码前的画面，也可以是一帧解码后的画面。
* @note 自定义采集和自定义渲染时使用。自定义采集时，需要使用 V2TXLiveVideoFrame 来包装待发送的视频帧；自定义渲染时，会返回经过 V2TXLiveVideoFrame 包装的视频帧。
*/
@interface V2TXLiveVideoFrame : NSObject
/// 【字段含义】视频帧像素格式
/// 【推荐取值】V2TXLivePixelFormatNV12
@property(nonatomic, assign) V2TXLivePixelFormat pixelFormat;
/// 【字段含义】视频数据包装格式
/// 【推荐取值】V2TXLiveBufferTypePixelBuffer
@property(nonatomic, assign) V2TXLiveBufferType bufferType;
/// 【字段含义】bufferType 为 V2TXLiveBufferTypeNSData 时的视频数据
@property(nonatomic, strong, nullable) NSData *data;
/// 【字段含义】bufferType 为 V2TXLiveBufferTypePixelBuffer 时的视频数据
@property(nonatomic, assign, nullable) CVPixelBufferRef pixelBuffer;
/// 【字段含义】视频宽度
@property(nonatomic, assign) NSUInteger width;
/// 【字段含义】视频高度
@property(nonatomic, assign) NSUInteger height;
/// 【字段含义】视频帧的顺时针旋转角度
@property(nonatomic, assign) V2TXLiveRotation rotation;
/// 【字段含义】视频纹理ID
@property(nonatomic, assign) GLuint textureId;
@end
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （二）音频相关类型定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 音频相关类型定义
/// @{
/**
* @brief 声音音质。
*/
typedef NS_ENUM(NSInteger, V2TXLiveAudioQuality) {
/// 语音音质：采样率：16k；单声道；音频码率：16kbps；适合语音通话为主的场景，比如在线会议，语音通话
V2TXLiveAudioQualitySpeech,
/// 默认音质：采样率：48k；单声道；音频码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之
V2TXLiveAudioQualityDefault,
/// 音乐音质：采样率：48k；双声道 + 全频带；音频码率：128kbps；适合需要高保真传输音乐的场景，比如K歌、音乐直播等
V2TXLiveAudioQualityMusic
};
/**
* @brief 音频帧数据
*/
@interface V2TXLiveAudioFrame : NSObject
/// 【字段含义】音频数据
@property(nonatomic, strong, nullable) NSData *data;
/// 【字段含义】采样率
@property(nonatomic, assign) int sampleRate;
/// 【字段含义】声道数
@property(nonatomic, assign) int channel;
@end
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （三）推流器和播放器的一些统计指标数据定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 推流器和播放器的一些统计指标数据定义
/// @{
/**
* @brief 推流器的统计数据。
*/
@interface V2TXLivePusherStatistics : NSObject
/// 【字段含义】当前 App 的 CPU 使用率（％）
@property(nonatomic, assign) NSUInteger appCpu;
/// 【字段含义】当前系统的 CPU 使用率（％）
@property(nonatomic, assign) NSUInteger systemCpu;
/// 【字段含义】视频宽度
@property(nonatomic, assign) NSUInteger width;
/// 【字段含义】视频高度
@property(nonatomic, assign) NSUInteger height;
/// 【字段含义】帧率（fps）
@property(nonatomic, assign) NSUInteger fps;
/// 【字段含义】视频码率（Kbps）
@property(nonatomic, assign) NSUInteger videoBitrate;
/// 【字段含义】音频码率（Kbps）
@property(nonatomic, assign) NSUInteger audioBitrate;
@end
/**
* @brief 播放器的统计数据。
*/
@interface V2TXLivePlayerStatistics : NSObject
/// 【字段含义】当前 App 的 CPU 使用率（％）
@property(nonatomic, assign) NSUInteger appCpu;
/// 【字段含义】当前系统的 CPU 使用率（％）
@property(nonatomic, assign) NSUInteger systemCpu;
/// 【字段含义】视频宽度
@property(nonatomic, assign) NSUInteger width;
/// 【字段含义】视频高度
@property(nonatomic, assign) NSUInteger height;
/// 【字段含义】帧率（fps）
@property(nonatomic, assign) NSUInteger fps;
/// 【字段含义】视频码率（Kbps）
@property(nonatomic, assign) NSUInteger videoBitrate;
/// 【字段含义】音频码率（Kbps）
@property(nonatomic, assign) NSUInteger audioBitrate;
@end
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// （四）连接状态相关枚举值定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 连接状态相关枚举值定义
/// @{
/**
* @brief 直播流的连接状态。
*/
typedef NS_ENUM(NSInteger, V2TXLivePushStatus) {
/// 与服务器断开连接
V2TXLivePushStatusDisconnected,
/// 正在连接服务器
V2TXLivePushStatusConnecting,
/// 连接服务器成功
V2TXLivePushStatusConnectSuccess,
/// 重连服务器中
V2TXLivePushStatusReconnecting,
};
/// @}
/////////////////////////////////////////////////////////////////////////////////
//
// (五) 音视频状态有关的枚举值的定义
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 音视频状态有关的枚举值的定义
/// @{
/**
* @brief 音视频状态
*/
typedef NS_ENUM(NSInteger, V2TXLivePlayStatus) {
/// 播放停止
V2TXLivePlayStatusStopped,
/// 正在播放
V2TXLivePlayStatusPlaying,
/// 正在缓冲(首次加载不会抛出 Loading 事件)
V2TXLivePlayStatusLoading,
};
/**
* @brief 音视频状态对应的原因
*/
typedef NS_ENUM(NSInteger, V2TXLiveStatusChangeReason) {
/// 内部原因
V2TXLiveStatusChangeReasonInternal,
/// 开始网络缓冲
V2TXLiveStatusChangeReasonBufferingBegin,
/// 结束网络缓冲
V2TXLiveStatusChangeReasonBufferingEnd,
/// 本地启动播放
V2TXLiveStatusChangeReasonLocalStarted,
/// 本地停止播放
V2TXLiveStatusChangeReasonLocalStopped,
/// 远端可播放
V2TXLiveStatusChangeReasonRemoteStarted,
/// 远端流停止或中断
V2TXLiveStatusChangeReasonRemoteStopped,
/// 远端流离线
V2TXLiveStatusChangeReasonRemoteOffline,
};
/// @}
/**
* @brief 声音播放模式（音频路由）
*/
typedef NS_ENUM(NSInteger, V2TXAudioRoute) {
/// 扬声器
V2TXAudioModeSpeakerphone,
/// 听筒
V2TXAudioModeEarpiece,
};
/**
* @brief 混流输入类型配置
*/
typedef NS_ENUM(NSInteger, V2TXLiveMixInputType) {
/// 混入音视频
V2TXLiveMixInputTypeAudioVideo,
/// 只混入视频
V2TXLiveMixInputTypePureVideo,
/// 只混入音频
V2TXLiveMixInputTypePureAudio,
};
/**
* @brief 云端混流中每一路子画面的位置信息
*/
@interface V2TXLiveMixStream : NSObject
/// 【字段含义】参与混流的 userId
@property(nonatomic, copy, nonnull) NSString *userId;
/// 【字段含义】参与混流的 userId 所在对应的推流 streamId，nil 表示当前推流 streamId
@property(nonatomic, copy, nullable) NSString *streamId;
/// 【字段含义】图层位置 x 坐标（绝对像素值）
@property(nonatomic, assign) NSInteger x;
/// 【字段含义】图层位置 y 坐标（绝对像素值）
@property(nonatomic, assign) NSInteger y;
/// 【字段含义】图层位置宽度（绝对像素值）
@property(nonatomic, assign) NSInteger width;
/// 【字段含义】图层位置高度（绝对像素值）
@property(nonatomic, assign) NSInteger height;
/// 【字段含义】图层层次（1 - 15）不可重复
@property(nonatomic, assign) NSUInteger zOrder;
/// 【字段含义】该直播流的输入类型
@property(nonatomic, assign) V2TXLiveMixInputType inputType;
@end
/**
* @brief 云端混流（转码）配置
*/
@interface V2TXLiveTranscodingConfig : NSObject
/// 【字段含义】最终转码后的视频分辨率的宽度
/// 【推荐取值】推荐值：360px，如果你是纯音频推流，请将 width × height 设为 0px × 0px，否则混流后会携带一条画布背景的视频流
@property(nonatomic, assign) NSUInteger videoWidth;
/// 【字段含义】最终转码后的视频分辨率的高度
/// 【推荐取值】推荐值：640px，如果你是纯音频推流，请将 width × height 设为 0px × 0px，否则混流后会携带一条画布背景的视频流
@property(nonatomic, assign) NSUInteger videoHeight;
/// 【字段含义】最终转码后的视频分辨率的码率（kbps）
/// 【推荐取值】如果填0，后台会根据 videoWidth 和 videoHeight 来估算码率，您也可以参考枚举定义 V2TXLiveVideoResolution 的注释
@property(nonatomic, assign) NSUInteger videoBitrate;
/// 【字段含义】最终转码后的视频分辨率的帧率（FPS）
/// 【推荐取值】默认值：15fps，取值范围是 (0,30]
@property(nonatomic, assign) NSUInteger videoFramerate;
/// 【字段含义】最终转码后的视频分辨率的关键帧间隔（又称为 GOP）
/// 【推荐取值】默认值：2，单位为秒，取值范围是 [1,8]
@property(nonatomic, assign) NSUInteger videoGOP;
/// 【字段含义】混合后画面的底色颜色，默认为黑色，格式为十六进制数字，比如：“0x61B9F1” 代表 RGB 分别为(97,158,241)
/// 【推荐取值】默认值：0x000000，黑色
@property(nonatomic, assign) NSUInteger backgroundColor;
/// 【字段含义】混合后画面的背景图
/// 【推荐取值】默认值：nil，即不设置背景图
/// 【特别说明】背景图需要您事先在 “[控制台](https://console.cloud.tencent.com/trtc) => 应用管理 => 功能配置 => 素材管理” 中上传，
/// 上传成功后可以获得对应的“图片ID”，然后将“图片ID”转换成字符串类型并设置到 backgroundImage 里即可。
/// 例如：假设“图片ID” 为 63，可以设置 backgroundImage = "63";
@property(nonatomic, copy, nullable) NSString *backgroundImage;
/// 【字段含义】最终转码后的音频采样率
/// 【推荐取值】默认值：48000Hz。支持12000HZ、16000HZ、22050HZ、24000HZ、32000HZ、44100HZ、48000HZ
@property(nonatomic, assign) NSUInteger audioSampleRate;
/// 【字段含义】最终转码后的音频码率
/// 【推荐取值】默认值：64kbps，取值范围是 [32，192]，单位：kbps
@property(nonatomic, assign) NSUInteger audioBitrate;
/// 【字段含义】最终转码后的音频声道数
/// 【推荐取值】默认值：1。取值范围为 [1,2] 中的整型
@property(nonatomic, assign) NSUInteger audioChannels;
/// 【字段含义】每一路子画面的位置信息
@property(nonatomic, copy, nonnull) NSArray<V2TXLiveMixStream *> *mixStreams;
/// 【字段含义】输出到 CDN 上的直播流 ID
/// 如不设置该参数，SDK 会执行默认逻辑，即房间里的多路流会混合到该接口调用者的视频流上，也就是 A + B => A；
/// 如果设置该参数，SDK 会将房间里的多路流混合到您指定的直播流 ID 上，也就是 A + B => C。
/// 【推荐取值】默认值：nil，即房间里的多路流会混合到该接口调用者的视频流上。
@property(nonatomic, copy, nullable) NSString *outputStreamId;
@end
/////////////////////////////////////////////////////////////////////////////////
//
// (六) 公共配置组件
//
/////////////////////////////////////////////////////////////////////////////////
/// @name 公共配置组件有关的枚举值的定义
/// @{
/**
* @brief 日志级别枚举值
*/
typedef NS_ENUM(NSInteger, V2TXLiveLogLevel) {
/// 输出所有级别的 log
V2TXLiveLogLevelAll = 0,
/// 输出 DEBUG，INFO，WARNING，ERROR 和 FATAL 级别的 log
V2TXLiveLogLevelDebug = 1,
/// 输出 INFO，WARNING，ERROR 和 FATAL 级别的 log
V2TXLiveLogLevelInfo = 2,
/// 只输出 WARNING，ERROR 和 FATAL 级别的 log
V2TXLiveLogLevelWarning = 3,
/// 只输出 ERROR 和 FATAL 级别的 log
V2TXLiveLogLevelError = 4,
/// 只输出 FATAL 级别的 log
V2TXLiveLogLevelFatal = 5,
/// 不输出任何 sdk log
V2TXLiveLogLevelNULL = 6,
};
@interface V2TXLiveLogConfig : NSObject
/// 【字段含义】设置 Log 级别
/// 【推荐取值】默认值：V2TXLiveLogLevelAll
@property(nonatomic, assign) V2TXLiveLogLevel logLevel;
/// 【字段含义】是否通过 V2TXLivePremierObserver 接收要打印的 Log 信息
/// 【特殊说明】如果您希望自己实现 Log 写入，可以打开此开关，Log 信息会通过 V2TXLivePremierObserver#onLog 回调给您。
/// 【推荐取值】默认值：NO
@property(nonatomic, assign) BOOL enableObserver;
/// 【字段含义】是否允许 SDK 在编辑器（XCoder、Android Studio、Visual Studio 等）的控制台上打印 Log
/// 【推荐取值】默认值：NO
@property(nonatomic, assign) BOOL enableConsole;
/// 【字段含义】是否启用本地 Log 文件
/// 【特殊说明】如非特殊需要，请不要关闭本地 Log 文件，否则腾讯云技术团队将无法在出现问题时进行跟踪和定位。
/// 【推荐取值】默认值：YES
@property(nonatomic, assign) BOOL enableLogFile;
/// 【字段含义】设置本地 Log 的存储目录，默认 Log 存储位置：
/// iOS & Mac: sandbox Documents/log
@property(nonatomic, copy, nullable) NSString *logPath;
@end
/// @}
/// @}
... ...
//
// Copyright © 2020 Tencent. All rights reserved.
//
// Module: V2TXLive
//
#import "V2TXLivePlayerObserver.h"
/// @defgroup V2TXLivePlayer_ios V2TXLivePlayer
/// 腾讯云直播播放器。<br/>
/// 主要负责从指定的直播流地址拉取音视频数据，并进行解码和本地渲染播放。
///
/// 播放器包含如下能力:
/// - 支持 RTMP, HTTP-FLV, TRTC 以及 WebRTC；
/// - 屏幕截图，可以截取当前直播流的视频画面；
/// - 延时调节，可以设置播放器缓存自动调整的最小和最大时间；
/// - 自定义的视频数据处理，您可以根据项目需要处理直播流中的视频数据后，再进行渲染以及播放。
///
/// @{
@protocol V2TXLivePlayer <NSObject>
/**
* 设置播放器回调。
*
* 通过设置回调，可以监听 V2TXLivePlayer 播放器的一些回调事件，
* 包括播放器状态、播放音量回调、音视频首帧回调、统计数据、警告和错误信息等。
*
* @param observer 播放器的回调目标对象，更多信息请查看 {@link V2TXLivePlayerObserver}
*/
- (void)setObserver:(id<V2TXLivePlayerObserver>)observer;
/**
* 设置播放器的视频渲染 View。 该控件负责显示视频内容。
*
* @param view 播放器渲染 View
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK：成功
*/
- (V2TXLiveCode)setRenderView:(TXView *)view;
/**
* 设置播放器画面的旋转角度。
*
* @param rotation 旋转角度 {@link V2TXLiveRotation}
* - V2TXLiveRotation0【默认值】: 0度, 不旋转
* - V2TXLiveRotation90: 顺时针旋转90度
* - V2TXLiveRotation180: 顺时针旋转180度
* - V2TXLiveRotation270: 顺时针旋转270度
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)setRenderRotation:(V2TXLiveRotation)rotation;
/**
* 设置画面的填充模式。
*
* @param mode 画面填充模式 {@link V2TXLiveFillMode}。
* - V2TXLiveFillModeFill 【默认值】: 图像铺满屏幕，不留黑边，如果图像宽高比不同于屏幕宽高比，部分画面内容会被裁剪掉
* - V2TXLiveFillModeFit: 图像适应屏幕，保持画面完整，但如果图像宽高比不同于屏幕宽高比，会有黑边的存在
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)setRenderFillMode:(V2TXLiveFillMode)mode;
/**
* 开始播放音视频流。
*
* @param url 音视频流的播放地址，支持 RTMP, HTTP-FLV, TRTC。
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 操作成功，开始连接并播放
* - V2TXLIVE_ERROR_INVALID_PARAMETER: 操作失败，url 不合法
* - V2TXLIVE_ERROR_REFUSED: RTC 不支持同一设备上同时推拉同一个 StreamId。
*/
- (V2TXLiveCode)startPlay:(NSString *)url;
/**
* 停止播放音视频流。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)stopPlay;
/**
* 播放器是否正在播放中。
*
* @return 是否正在播放
* - 1: 正在播放中
* - 0: 已经停止播放
*/
- (int)isPlaying;
/**
* 暂停播放器的音频流。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)pauseAudio;
/**
* 恢复播放器的音频流。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)resumeAudio;
/**
* 暂停播放器的视频流。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)pauseVideo;
/**
* 恢复播放器的视频流。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)resumeVideo;
/**
* 设置播放器音量。
*
* @param volume 音量大小，取值范围0 - 100。【默认值】: 100
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)setPlayoutVolume:(NSUInteger)volume;
/**
* 设置播放器缓存自动调整的最小和最大时间 ( 单位：秒 )。
*
* @param minTime 缓存自动调整的最小时间，取值需要大于0。【默认值】：1
* @param maxTime 缓存自动调整的最大时间，取值需要大于0。【默认值】：5
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
* - V2TXLIVE_ERROR_INVALID_PARAMETER: 操作失败，minTime 和 maxTime 需要大于0
* - V2TXLIVE_ERROR_REFUSED: 播放器处于播放状态，不支持修改缓存策略
*/
- (V2TXLiveCode)setCacheParams:(CGFloat)minTime maxTime:(CGFloat)maxTime;
/**
* 启用播放音量大小提示。
*
* 开启后可以在 [onPlayoutVolumeUpdate](@ref V2TXLivePlayerObserver#onPlayoutVolumeUpdate:volume:) 回调中获取到 SDK 对音量大小值的评估。
*
* @param intervalMs 决定了 onPlayoutVolumeUpdate 回调的触发间隔，单位为ms，最小间隔为100ms，如果小于等于0则会关闭回调，建议设置为300ms；【默认值】：0，不开启
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)enableVolumeEvaluation:(NSUInteger)intervalMs;
/**
* 截取播放过程中的视频画面。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
* - V2TXLIVE_ERROR_REFUSED: 播放器处于停止状态，不允许调用截图操作
*/
- (V2TXLiveCode)snapshot;
/**
* 设置视频自定义渲染回调。
*
* 通过该方法，可以获取解码后的每一帧视频画面，进行自定义渲染处理，添加自定义显示效果。
*
* @param enable 是否开启自定义渲染。【默认值】：NO
* @param pixelFormat 自定义渲染回调的视频像素格式 {@link V2TXLivePixelFormat}。
* @param bufferType 自定义渲染回调的视频数据格式 {@link V2TXLiveBufferType}。
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
* - V2TXLIVE_ERROR_NOT_SUPPORTED: 像素格式或者数据格式不支持
*/
- (V2TXLiveCode)enableCustomRendering:(BOOL)enable pixelFormat:(V2TXLivePixelFormat)pixelFormat bufferType:(V2TXLiveBufferType)bufferType;
/**
* 开启接收 SEI 消息
*
* @param enable true: 开启接收 SEI 消息; false: 关闭接收 SEI 消息。【默认值】: false
* @param payloadType 指定接收 SEI 消息的 payloadType，支持 5、242，请与发送端的 payloadType 保持一致。
*
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
*/
- (V2TXLiveCode)enableReceiveSeiMessage:(BOOL)enable payloadType:(int)payloadType;
/**
* 是否显示播放器状态信息的调试浮层。
*
* @param isShow 是否显示。【默认值】：NO
*/
- (void)showDebugView:(BOOL)isShow;
/**
* 调用 V2TXLivePlayer 的高级 API 接口。
*
* @note 该接口用于调用一些高级功能。
* @param key 高级 API 对应的 key。
* @param value 调用 key 所对应的高级 API 时，需要的参数。
* @return 返回值 {@link V2TXLiveCode}
* - V2TXLIVE_OK: 成功
* - V2TXLIVE_ERROR_INVALID_PARAMETER: 操作失败，key 不允许为 nil
*/
- (V2TXLiveCode)setProperty:(NSString *)key value:(NSObject *)value;
@end
/// @}
@interface V2TXLivePlayer : NSObject <V2TXLivePlayer>
@end
... ...
//
// 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
/// @}
... ...
//
// Copyright © 2020 Tencent. All rights reserved.
//
// Module: V2TXLive
//
#import "V2TXLiveDef.h"
NS_ASSUME_NONNULL_BEGIN
/// @defgroup V2TXLivePremier_ios V2TXLivePremier
///
/// @{
/////////////////////////////////////////////////////////////////////////////////
//
// V2TXLive 高级接口
//
/////////////////////////////////////////////////////////////////////////////////
@protocol V2TXLivePremierObserver;
@protocol V2TXLivePremier <NSObject>
/**
* 1. 获取 SDK 版本号
*/
+ (NSString *)getSDKVersionStr;
/**
* 2. 设置 V2TXLivePremier 回调接口
*/
+ (void)setObserver:(id<V2TXLivePremierObserver>)observer;
/**
* 3. 设置 Log 的配置信息
*/
+ (V2TXLiveCode)setLogConfig:(V2TXLiveLogConfig *)config;
/**
* 4. 设置 SDK 接入环境
*
* @note 如您的应用无特殊需求，请不要调用此接口进行设置。
* @param env 目前支持 “default” 和 “GDPR” 两个参数
* - default：默认环境，SDK 会在全球寻找最佳接入点进行接入。
* - GDPR：所有音视频数据和质量统计数据都不会经过中国大陆地区的服务器。
*/
+ (V2TXLiveCode)setEnvironment:(const char *)env;
/**
* 5. 设置 SDK 的授权 License
*
* 文档地址：https://cloud.tencent.com/document/product/454/34750
* @param url licence的地址
* @param key licence的秘钥
*/
#if TARGET_OS_IPHONE
+ (void)setLicence:(NSString *)url key:(NSString *)key;
#endif
/**
* 6. 设置 SDK sock5 代理配置
*
* @param host sock5 代理服务器的地址
* @param port sock5 代理服务器的端口
* @param username sock5 代理服务器的验证的用户名
* @param password sock5 代理服务器的验证的密码
*/
+ (V2TXLiveCode)setSocks5Proxy:(NSString *)host port:(NSInteger)port username:(NSString *)username password:(NSString *)password;
@end
/////////////////////////////////////////////////////////////////////////////////
//
// V2TXLive 高级回调接口
//
/////////////////////////////////////////////////////////////////////////////////
@protocol V2TXLivePremierObserver <NSObject>
@optional
/**
* 自定义 Log 输出回调接口
*/
- (void)onLog:(V2TXLiveLogLevel)level log:(NSString *)log;
/**
* setLicence 接口回调
*
* @param result 设置 licence 结果 0 成功，负数失败
* @param reason 设置 licence 失败原因
*/
- (void)onLicenceLoaded:(int)result Reason:(NSString *)reason;
@end
@interface V2TXLivePremier : NSObject <V2TXLivePremier>
@end
NS_ASSUME_NONNULL_END
/// @}
... ...