//
|
// ARtcChannelDelegate.h
|
// ARtcKit
|
//
|
// Created by 余生丶 on 2020/3/24.
|
// Copyright © 2020 zjq. All rights reserved.
|
//
|
|
#ifndef ARtcChannelDelegate_h
|
#define ARtcChannelDelegate_h
|
|
@protocol ARtcChannelDelegate <NSObject>
|
|
@optional
|
|
/** 发生警告回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param warningCode ARWarningCode
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel didOccurWarning:(ARWarningCode)warningCode;
|
|
/** 发生错误回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param errorCode ARErrorCode
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel didOccurError:(ARErrorCode)errorCode;
|
|
/** 加入频道回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 用户ID
|
@param elapsed 从调用joinChannelByToken开始到发生此事件过去的时间（ms)。
|
*/
|
- (void)rtcChannelDidJoinChannel:(ARtcChannel *_Nonnull)rtcChannel withUid:(NSString *_Nonnull)uid elapsed:(NSInteger)elapsed;
|
|
/** 重新加入频道回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 用户ID
|
@param elapsed 从开始重连到重连成功的时间（ms）。
|
*/
|
- (void)rtcChannelDidRejoinChannel:(ARtcChannel *_Nonnull)rtcChannel withUid:(NSString *_Nonnull)uid elapsed:(NSInteger)elapsed;
|
|
/** 已离开频道回调
|
|
当用户调用 leaveChannel 离开频道后，SDK 会触发该回调。在该回调方法中，App 可以得到此次通话的总通话时长、SDK 收发数据的流量等信息。
|
|
@param rtcChannel ARtcChannel 类。
|
@param stats 通话相关的统计信息：ARChannelStats
|
*/
|
- (void)rtcChannelDidLeaveChannel:(ARtcChannel *_Nonnull)rtcChannel withStats:(ARChannelStats *_Nonnull)stats;
|
|
/** 用户角色已切换回调
|
|
直播场景下，当本地用户在加入频道后调用 setClientRole 切换角色时会触发此回调，即主播切换为观众时，或观众切换为主播时。
|
|
@param rtcChannel ARtcChannel 类。
|
@param oldRole 切换前的角色
|
@param newRole 切换后的角色
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel didClientRoleChanged:(ARClientRole)oldRole newRole:(ARClientRole)newRole;
|
|
/** 远端用户/主播加入回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 新加入频道的远端用户/主播 ID。如果 joinChannelByToken 中指定了 uid，则此处返回该 ID；否则使用ar云平台服务器自动分配的 ID。
|
@param elapsed 从本地用户加入频道 joinChannelByToken开始到发生此事件过去的时间（ms）。
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel didJoinedOfUid:(NSString *_Nonnull)uid elapsed:(NSInteger)elapsed;
|
|
/** 远端用户（通信场景）/主播（直播场景）离开当前频道回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 离线的用户 ID。
|
@param reason 离线原因，详见 ARUserOfflineReason。
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel didOfflineOfUid:(NSString *_Nonnull)uid reason:(ARUserOfflineReason)reason;
|
|
/** 网络连接状态已改变回调
|
|
该回调在网络连接状态发生改变的时候触发，并告知用户当前的网络连接状态，和引起网络状态改变的原因。
|
|
@param rtcChannel ARtcChannel 类。
|
@param state 当前的网络连接状态，详见 ARConnectionStateType。
|
@param reason 引起网络连接状态发生改变的原因，详见 ARConnectionChangedReason。
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel connectionChangedToState:(ARConnectionStateType)state reason:(ARConnectionChangedReason)reason;
|
|
/** 网络连接中断，且 SDK 无法在 10 秒内连接服务器回调
|
|
SDK 在调用 joinChannelByToken 后无论是否加入成功，只要 10 秒和服务器无法连接就会触发该回调。
|
|
如果 SDK 在断开连接后，20 分钟内还是没能重新加入频道，SDK 会停止尝试重连。
|
|
@param rtcChannel ARtcChannel 类。
|
*/
|
- (void)rtcChannelDidLost:(ARtcChannel * _Nonnull)rtcChannel;
|
|
/** Token 服务即将过期回调
|
|
在调用 joinChannelByToken 时如果指定了 Token，由于 Token 具有一定的时效，在通话过程中如果 Token 即将失效，SDK 会提前 30 秒触发该回调，提醒应用程序更新 Token。 当收到该回调时，用户需要重新在服务端生成新的 Token，然后调用 renewToken 将新生成的 Token 传给 SDK。
|
|
@param rtcChannel ARtcChannel 类。
|
@param token 即将服务失效的 Token
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel tokenPrivilegeWillExpire:(NSString *_Nonnull)token;
|
|
/** Token 过期回调
|
|
在调用 joinChannelByToken 时如果指定了 Token，由于 Token 具有一定的时效，在通话过程中 SDK 可能由于网络原因和服务器失去连接，重连时可能需要新的 Token。 该回调通知 App 需要生成新的 Token，并需调用 renewToken 为 SDK 指定新的 Token。
|
|
@param rtcChannel ARtcChannel 类。
|
*/
|
- (void)rtcChannelRequestToken:(ARtcChannel *_Nonnull)rtcChannel;
|
|
/** 监测到活跃用户的回调
|
|
该回调获取当前时间段内累积音量最大者。如果用户开启了 enableAudioVolumeIndication 功能，则当音量检测模块监测到频道内有新的活跃用户说话时，会通过本回调返回该用户的 uid。
|
|
**Note**
|
- 你需要开启 enableAudioVolumeIndication 方法才能收到该回调
|
- uid 返回的是当前时间段内声音最大的用户 uid，而不是瞬时声音最大的用户 uid。
|
|
@param rtcChannel ARtcChannel 类。
|
@param speakerUid 当前时间段声音最大的用户的 uid。
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel activeSpeaker:(NSString * _Nonnull)speakerUid;
|
|
/** 本地或远端视频大小和旋转信息发生改变回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 图像尺寸和旋转信息发生变化的用户的用户 ID
|
@param size 新的视频尺寸
|
@param rotation 旋转信息 (0 到 360)
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel videoSizeChangedOfUid:(NSString *_Nonnull)uid size:(CGSize)size rotation:(NSInteger)rotation;
|
|
/** 远端视频状态发生改变回调
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 发生视频状态改变的远端用户 ID。
|
@param state 远端视频流状态。详见 ARVideoRemoteState。
|
@param reason 远端视频流状态改变的具体原因。详见 ARVideoRemoteStateReason。
|
@param elapsed 从本地用户调用 joinChannelByToken 方法到发生本事件经历的时间，单位为 ms。
|
*/
|
- (void)rtcChannel:(ARtcChannel *_Nonnull)rtcChannel remoteVideoStateChangedOfUid:(NSString *_Nonnull)uid state:(ARVideoRemoteState)state reason:(ARVideoRemoteStateReason)reason elapsed:(NSInteger)elapsed;
|
|
/** 远端音频流状态发生改变回调。
|
|
远端用户/主播音频状态发生改变时，SDK 会触发该回调向本地用户报告当前的远端音频流状态。
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 发生音频状态改变的远端用户 ID。
|
@param state 远端音频流状态。详见 ARAudioRemoteState。
|
@param reason 远端音频流状态改变的具体原因。详见 ARAudioRemoteStateReason。
|
@param elapsed 从本地用户调用 joinChannelByToken 方法到发生本事件经历的时间，单位为 ms。
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel remoteAudioStateChangedOfUid:(NSString *_Nonnull)uid state:(ARAudioRemoteState)state reason:(ARAudioRemoteStateReason)reason elapsed:(NSInteger)elapsed;
|
|
/** 当前通话统计回调。 该回调在通话或直播中每两秒触发一次。
|
|
@param rtcChannel ARtcChannel 类。
|
@param stats 通话相关的数据统计信息，详见 ARChannelStats
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel reportRtcStats:(ARChannelStats * _Nonnull)stats;
|
|
/** 通话中每个用户的网络上下行 last mile 质量报告回调
|
|
该回调描述每个用户在通话中的 last mile 网络状态，其中 last mile 是指设备到 ar云平台 边缘服务器的网络状态。
|
|
该回调每 2 秒触发一次。如果远端有多个用户，该回调每 2 秒会被触发多次。
|
|
@param rtcChannel ARtcChannel 类。
|
@param uid 用户 ID。表示该回调报告的是持有该 ID 的用户的网络质量。
|
@param txQuality
|
|
该用户的上行网络质量。基于上行视频的发送码率、上行丢包率、平均往返时延和网络抖动计算。该值代表当前的上行网络质量，帮助判断是否可以支持当前设置的视频编码属性。
|
|
假设上行码率是 500 Kbps，那么支持 480 x 480 的分辨率、30 fps 的帧率没有问题，但是支持 1280 x 720 的分辨率就会有困难。详见 ARNetworkQuality。
|
|
@param rxQuality 该用户的下行网络质量。基于下行网络的丢包率、平均往返延时和网络抖动计算。详见 ARNetworkQuality。
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel networkQuality:(NSString * _Nonnull)uid txQuality:(ARNetworkQuality)txQuality rxQuality:(ARNetworkQuality)rxQuality;
|
|
/** 通话中远端视频流的统计信息回调
|
|
该回调描述远端用户在通话中端到端的视频流统计信息，针对每个远端用户/主播每 2 秒触发一次。
|
|
如果远端同时存在多个用户/主播，该回调每 2 秒会被触发多次。
|
|
@param rtcChannel ARtcChannel 类。
|
@param stats 远端视频统计数据，详见 ARtcRemoteVideoStats
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel remoteVideoStats:(ARtcRemoteVideoStats * _Nonnull)stats;
|
|
/** 通话中远端音频流的统计信息回调，用于取代 audioQualityOfUid
|
|
该回调描述远端用户在通话中端到端的音频流统计信息，针对每个远端用户/主播每 2 秒触发一次。
|
|
如果远端同时存在多个用户/主播，该回调每 2 秒会被触发多次。
|
|
和 audioTransportStatsOfUid 回调相比，该回调更贴近用户的主观感受。
|
|
比如，当网络发生丢包时，因 FEC（Forward Error Correction，向前纠错码）或重传恢复，最终的音频丢帧率不高，则可以认为整个质量较好。
|
|
@param rtcChannel ARtcChannel 类。
|
@param stats 远端音频统计数据，详细定义见 ARtcRemoteAudioStats。
|
*/
|
- (void)rtcChannel:(ARtcChannel * _Nonnull)rtcChannel remoteAudioStats:(ARtcRemoteAudioStats * _Nonnull)stats;
|
|
@end
|
|
|
#endif /* ARtcChannelDelegate_h */
|
