网络及其他
介绍跟网络相关的方法以及其他方法和回调。
complain:description:
投诉通话质量。
- (int)complain:(NSString * _Nonnull)callId
description:(NSString * _Nullable)description;
详情
该方法允许用户就通话质量进行投诉。需要在离开频道后调用。
参数
- callId
- 通话 ID。你可以通过调用 getCallId 获取该参数。
- description
- (非必选项)通话的描述。长度应小于 800 字节。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -1: 一般性的错误(未明确归类)。
- -2: 参数无效。
- -7: AgoraRtcEngineKit 尚未初始化就调用方法。
enableEncryption:encryptionConfig:
开启或关闭内置加密。
- (int)enableEncryption:(BOOL)enabled encryptionConfig:(AgoraEncryptionConfig * _Nonnull)config;
用户离开频道后,SDK 会自动关闭加密。如需重新开启加密,你需要在用户再次加入频道前调用该方法。
适用场景
对安全要求较高的场景。
调用时机
该方法需要在加入频道前调用。
调用限制
- 同一频道内的所有用户在调用该方法时,必须设置相同的加密模式和密钥。
- 如果开启了内置加密,则不能使用旁路推流功能。
参数
- enabled
- 是否开启内置加密:
- YES: 开启内置加密。
- NO:(默认)关闭内置加密。
- config
- 配置内置加密模式和密钥。详见 AgoraEncryptionConfig。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败
- -2: 调用了无效的参数。需重新指定参数。
- -4: 设置的加密模式不正确或加载外部加密库失败。需检查枚举值是否正确或重新加载外部加密库。
- -7: SDK 尚未初始化。需在调用 API 之前已创建 AgoraRtcEngineKit 对象并完成初始化。
enableEncryptionEx:encryptionConfig:connection:
开启或关闭内置加密。
- (int)enableEncryptionEx:(BOOL)enabled encryptionConfig:(AgoraEncryptionConfig *_Nonnull)config connection:(AgoraRtcConnection* _Nonnull)connection NS_SWIFT_NAME(enableEncryptionEx(_:encryptionConfig:connection:));
用户离开频道后,SDK 会自动关闭加密。如需重新开启加密,你需要在用户再次加入频道前调用该方法。
适用场景
对安全要求较高的场景。
调用时机
该方法需要在加入频道前调用。
调用限制
- 同一频道内的所有用户在调用该方法时,必须设置相同的加密模式和密钥。
- 如果开启了内置加密,则不能使用旁路推流功能。
参数
- enabled
- 是否开启内置加密:
- YES: 开启内置加密。
- NO:(默认)关闭内置加密。
- config
- 配置内置加密模式和密钥。详见 AgoraEncryptionConfig。
- connection
- Connection 信息。详见 AgoraRtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
enableMainQueueDispatch:
enableWebSdkInteroperability:
打开与 Web SDK 的互通(仅在直播场景适用)。
- (int)enableWebSdkInteroperability:(BOOL)enabled;
详情
该方法打开或关闭与 Web SDK 的互通。如果有用户通过 Web SDK 加入频道,请确保调用该方法,否则 Web 端用户看 Native 端的画面会是黑屏。
该方法仅在直播场景下适用,通信场景下默认互通是打开的。
参数
- enabled
- 是否打开与 Web SDK 的互通:
YES
: 打开互通。NO
: (默认) 关闭互通。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
getCallId
获取通话 ID。
- (NSString * _Nullable)getCallId;
客户端在每次加入频道后会生成一个对应的 callId,标识该客户端的此次通话。你可以调用该方法获取 callId 参数,然后在调用 rate:rating:description:、complain:description: 等方法时填入。
调用时机
该方法需要在加入频道后调用。
调用限制
无。
参数
- callId
- 输出参数,当前的通话 ID。
返回值
通话 ID。
所属接口类getCallIdEx:
使用连接 ID 获取通话 ID。
- (NSString * _Nullable)getCallIdEx:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(getCallIdEx(_:));
客户端在每次加入频道后会生成一个对应的 callId,标识该客户端的此次通话。你可以调用该方法获取 callId 参数,然后在调用 rate:rating:description:、complain:description: 等方法时填入。
调用时机
该方法需要在加入频道后调用。
调用限制
无。
参数
- connection
- Connection 信息。详见 AgoraRtcConnection。
getConnectionState
获取当前网络连接状态。
- (AgoraConnectionState)getConnectionState;
调用时机
加入频道前后均可调用。
调用限制
无。
返回值
当前网络连接状态。详见 AgoraConnectionState。
所属接口类getConnectionStateEx:
获取当前网络连接状态。
- (AgoraConnectionState)getConnectionStateEx:(AgoraRtcConnection * _Nonnull)connection;
调用时机
加入频道前后均可调用。
调用限制
无。
参数
- connection
- Connection 信息。详见 AgoraRtcConnection。
返回值
当前网络连接状态。详见 AgoraConnectionState。
所属接口类getCurrentMonotonicTimeInMs
获取 SDK 当前的 Monotonic Time。
- (int64_t)getCurrentMonotonicTimeInMs NS_SWIFT_NAME(getCurrentMonotonicTimeInMs());
Monotonic Time 是指一个单调递增的时间序列,它的值会随着时间的推移而增加。单位为毫秒。
在自定义视频采集、自定义音频采集场景中,为确保音视频同步,声网建议你调用该方法获取 SDK 当前的 Monotonic Time 后,将该值传入采集的视频帧(AgoraOutputVideoFrame)、音频帧(AgoraAudioFrame)的时间戳参数。
调用时机
加入频道前后均可调用。
调用限制
无。
返回值
- ≥ 0: 方法调用成功,返回 SDK 当前的 Monotonic Time(毫秒)。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
getErrorDescription:
getNativeHandle
getNetworkType
getNtpWallTimeInMs
getSdkVersion
isFeatureAvailableOnDevice:
查询设备是否支持指定进阶功能。
- (BOOL)isFeatureAvailableOnDevice:(AgoraFeatureType)type;
详情
查询当前设备能力是否满足虚拟背景、美颜等进阶功能的要求。
适用场景
在使用进阶音视频功能前,你可以根据查询结果判断当前设备是否支持这些功能,从而避免在低端设备上开启进阶功能导致性能下降或功能不可用的问题。你可以根据该方法的返回值,决定是否显示或启用相应的功能按钮,或者在设备能力不足时,为用户提示相应信息。
参数
- type
- 进阶功能类型,详见 AgoraFeatureType。
返回值
YES
: 设备支持指定进阶功能。NO
: 设备不支持指定进阶功能。
rtcEngine:didRemoteSubscribeFallbackToAudioOnly:byUid:
订阅流已回退为音频流或恢复为音视频流回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine
didRemoteSubscribeFallbackToAudioOnly:(BOOL)isFallbackOrRecover byUid:(NSUInteger)uid;
详情
- 下行网络环境较差,订阅的音视频流回退为音频流
- 下行网络环境改善,订阅音频流恢复为音视频流
参数
- engine
- AgoraRtcEngineKit 对象。
- uid
- 远端用户的用户 ID。
- isFallbackOrRecover
YES
: 由于网络环境不理想,订阅流已回退为音频流。NO
: 由于网络环境改善,订阅流已恢复为音视频流。
queryDeviceScore
rate:rating:description:
给通话评分。
- (int)rate:(NSString * _Nonnull)callId
rating:(NSInteger)rating
description:(NSString * _Nullable)description;
详情
参数
- callId
- 通话 ID。你可以通过调用 getCallId 获取该参数。
- rating
- 给通话的评分,最低 1 分,最高 5 分。
- description
- (非必选项)给通话的描述。长度应小于 800 字节。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -1: 一般性的错误(未明确归类)。
- -2: 参数无效。
sendCustomReportMessage:category:event:label:value:
发送自定义上报消息。
- (int)sendCustomReportMessage:(NSString * _Nullable)messageId
category:(NSString * _Nullable)category
event:(NSString * _Nullable)event
label:(NSString * _Nullable)label
value:(NSInteger)value;
详情
声网提供自定义数据上报和分析服务。该服务当前处于免费内测期。内测期提供的能力为 6 秒内最多上报 10 条数据,每条自定义数据不能超过 256 字节,每个字符串不能超过 100 字节。如需试用该服务,请联系销售开通并商定自定义数据格式。
所属接口类sendCustomReportMessageEx:category:event:label:value:connection:
自定义数据上报和分析服务。
- (int)sendCustomReportMessageEx:(NSString * _Nullable)messageId
category:(NSString * _Nullable)category
event:(NSString * _Nullable)event
label:(NSString * _Nullable)label
value:(NSInteger)value
connection:(AgoraRtcConnection * _Nonnull)connection;
详情
声网提供自定义数据上报和分析服务。该服务当前处于免费内测期。内测期提供的能力为 6 秒内最多上报 10 条数据,每条自定义数据不能超过 256 字节,每个字符串不能超过 100 字节。如需试用该服务,请联系销售开通并商定自定义数据格式。
所属接口类setAVSyncSource:uid:
设置发流端音画同步。
- (int) setAVSyncSource:(NSString* _Nonnull)channelId uid:(NSUInteger)uid;
详情
同一用户可能使用两个设备分别发送音频流和视频流,为保证接收端听到和看到的音频和视频的时间同步性,你可以在视频发送端调用该方法,并传入音频发送端的频道名、用户 ID。 SDK 会以发送的音频流的时间戳为基准进行自动调节发送的视频流,以保证即使在两个发送端的上行网络情况不一致(如分别使用 Wi-Fi 和 4G 网络)的情况下,也能让接收到的音视频具有时间同步性。
参数
- channelId
- 标识音频发送端所在频道的频道名。
- uid
- 音频发送端的用户 ID。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setCloudProxy:
设置云代理服务。
- (int)setCloudProxy:(AgoraCloudProxyType)proxyType NS_SWIFT_NAME(setCloudProxy(_:));
详情
当用户的网络访问受到防火墙限制时,你需要将声网提供的 IP 和端口号添加到防火墙白名单,然后调用该方法开启云代理,并通过 proxyType 参数设置云代理类型。
成功连接云代理后,SDK 会触发 rtcEngine:connectionStateChanged:reason: (AgoraConnectionStateConnecting, AgoraConnectionChangedReasonSettingProxyServer) 回调。
如果你想关闭已设置的 Force UDP 或 Force TCP 云代理,请调用 setCloudProxy:(AgoraNoneProxyType)
。
如果你想更改已设置的云代理类型,请先调用 setCloudProxy:(AgoraNoneProxyType)
,再调用 setCloudProxy: 并传入你期望的 proxyType 值。
- 建议你在频道外调用该方法。
- 如果用户处于内网防火墙环境下,使用 Force UDP 云代理时,旁路推流和跨频道媒体流转发功能不可用。
- 使用 Force UDP 云代理时,调用 startAudioMixing:loopback:cycle:startPos: 方法时无法播放 HTTP 协议的在线音频文件。旁路推流和跨频道媒体流转发功能会使用 TCP 协议的云代理。
参数
- proxyType
云代理类型,详见 AgoraCloudProxyType。
该参数为必填参数,如果你不赋值,SDK 会报错。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -2: 传入的参数无效。
- -7: SDK 尚未初始化。
setLocalAccessPoint:
配置与声网私有媒体服务器接入模块的连接。
- (int)setLocalAccessPoint:(AgoraLocalAccessPointConfiguration* _Nonnull)config NS_SWIFT_NAME(setLocalAccessPoint(withConfig:));
成功部署声网私有媒体服务器并在内网终端集成 4.x RTC SDK 后,你可以调用该方法指定 Local Access Point,给 SDK 分配接入模块。
调用时机
该方法需要在加入频道前调用。
调用限制
该方法仅在部署声网混合云方案后生效。你可以联系销售了解和部署声网混合云。
参数
- config
- Local Access Point 配置。详见 AgoraLocalAccessPointConfiguration。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLogFile:
设置日志文件
- (int)setLogFile:(NSString * _Nonnull)filePath;
设置 SDK 的输出 log 文件。SDK 运行时产生的所有 log 将写入该文件。
调用时机
该方法需要在 sharedEngineWithConfig:delegate: 后立即调用,否则输出日志可能不完整。
调用限制
App 必须保证指定的目录存在而且可写。
参数
- filePath
- 日志文件的完整路径。该日志文件为 UTF-8 编码。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLogFileSize:
设置 SDK 输出的日志文件的大小。
- (int)setLogFileSize:(NSUInteger)fileSizeInKBytes;
详情
logConfig
参数设置日志文件大小。默认情况下,SDK 会生成 5 个 SDK 日志文件和 5 个 API 调用日志文件,规则如下:
- SDK 日志文件的名称分别为:
agorasdk.log
、agorasdk.1.log
、agorasdk.2.log
、agorasdk.3.log
、agorasdk.4.log
。 - API 调用日志文件的名称分别为:
agoraapi.log
、agoraapi.1.log
、agoraapi.2.log
、agoraapi.3.log
、agoraapi.4.log
。 - 每个 SDK 日志文件的默认大小为 2,048 KB;API 调用日志文件的默认大小为 2,048 KB。日志文件均为 UTF-8 编码。
- 最新的日志永远写在
agorasdk.log
和agoraapi.log
中。 - 当
agorasdk.log
写满后,SDK 会按照以下顺序对日志文件进行操作:- 删除
agorasdk.4.log
文件(如有)。 - 将
agorasdk.3.log
重命名为agorasdk.4.log
。 - 将
agorasdk.2.log
重命名为agorasdk.3.log
。 - 将
agorasdk.1.log
重命名为agorasdk.2.log
。 - 新建
agorasdk.log
文件。
- 删除
agoraapi.log
文件的覆盖规则与agorasdk.log
相同。
该方法仅用于设置 agorasdk.log
文件的大小,对agoraapi.log
不生效。
参数
- fileSizeInKBytes
- 单个
agorasdk.log
日志文件的大小,单位为 KB,取值范围为 [128,20480],默认值为 2,048 KB。如果你将fileSizeInKByte
设为小于 128 KB,SDK 会自动调整到 128 KB;如果你将fileSizeInKByte
设为大于 20,480 KB,SDK 会自动调整到 20,480 KB。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLogFilter:
设置日志输出等级。
- (int)setLogFilter:(NSUInteger)filter;
详情
该方法设置 SDK 的输出日志输出等级。不同的输出等级可以单独或组合使用。日志级别顺序依次为 AgoraLogFilterOff、AgoraLogFilterCritical、AgoraLogFilterError、AgoraLogFilterWarning、AgoraLogFilterInfo 和 AgoraLogFilterDebug。 选择一个级别,你就可以看到在该级别之前所有级别的日志信息。
例如,你选择 AgoraLogFilterWarning 级别,就可以看到在 AgoraLogFilterCritical、AgoraLogFilterError 和 AgoraLogFilterWarning 级别的日志信息。
参数
- filter
日志过滤等级。详见 AgoraLogFilter。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setLogLevel:
设置 SDK 的日志输出级别。
- (int)setLogLevel:(AgoraLogLevel)level;
选择一个级别,你就可以看到该级别的日志信息。
参数
- level
- 日志级别。详见 AgoraLogLevel。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
setParameters:
setRemoteSubscribeFallbackOption:
设置弱网环境下订阅的音视频流回退选项。
- (int)setRemoteSubscribeFallbackOption:(AgoraStreamFallbackOptions)option;
详情
网络不理想的环境下,实时通信音视频的质量会下降。你可以调用该方法并将 option 设置为 AgoraStreamFallbackOptionVideoStreamLow 或 AgoraStreamFallbackOptionAudioOnly,SDK 会在下行弱网且音视频质量严重受影响时,将视频流切换为小流或关闭视频流,从而保证音频质量。同时,SDK 会持续监控网络质量,并在网络质量改善时恢复订阅音视频流。
当订阅流回退为音频流或由音频流恢复为音视频流时,SDK 会触发 rtcEngine:didRemoteSubscribeFallbackToAudioOnly:byUid: 回调。
参数
- option
- 订阅流的回退选项。详见 AgoraStreamFallbackOptions。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
startEchoTestWithConfig:
开始音视频通话回路测试。
- (int)startEchoTestWithConfig:(AgoraEchoTestConfiguration* _Nonnull)config;
为测试用户本地发流、收流是否正常,你可以调用该方法进行音视频通话回路测试,即测试系统的音视频设备和用户的上下行网络是否正常。
开始测试后,用户需发出声音或面对摄像头,音频或视频会在约 2 秒后播放出来。如果音频播放正常,则表示系统音频设备和用户上下行网络均正常; 如果视频播放正常,则表示系统视频设备和用户上下行网络均正常。
调用时机
该方法在加入频道前后均可调用。
调用限制
- 在频道内调用该方法时,需确保当前没有发布音视频流。
- 调用该方法后,必须调用 stopEchoTest 结束测试,否则该用户无法进行下一次音视频通话回路测试,也无法加入频道。
- 直播场景下,该方法仅能由主播调用。
参数
- config
- 音视频通话回路测试的配置。详见 AgoraEchoTestConfiguration。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
startLastmileProbeTest:
开始通话前网络质量探测。
- (int)startLastmileProbeTest:(AgoraLastmileProbeConfig *_Nullable)config;
开始通话前网络质量探测,向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。
调用时机
该方法需要在加入频道前调用,且在收到 rtcEngine:lastmileQuality: 和 rtcEngine:lastmileProbeTestResult: 回调之前请不要调用其他方法,否则可能会由于 API 操作过于频繁导致此方法无法执行。
调用限制
无。
相关回调
- rtcEngine:lastmileQuality:,视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量,更贴近用户的主观感受。
- rtcEngine:lastmileProbeTestResult:,视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量,更加客观。
参数
- config
- Last mile 网络探测配置,详见 AgoraLastmileProbeConfig。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
stopEchoTest
停止语音通话回路测试。
- (int)stopEchoTest;
调用 startEchoTestWithConfig: 后,必须调用该方法结束测试,否则该用户无法进行下一次音视频通话回路测试,也无法加入频道。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
- -5(ERR_REFUSED): 停止测试失败,可能是测试不在运行中。
stopLastmileProbeTest
rtcEngineConnectionDidBanned:
rtcEngineConnectionDidInterrupted:
网络连接中断回调。
- (void)rtcEngineConnectionDidInterrupted:(AgoraRtcEngineKit * _Nonnull)engine;
详情
- rtcEngineConnectionDidInterrupted: 回调一定是发生在成功加入频道后,且 SDK 刚失去和服务器连接超过 4 秒时触发。
- rtcEngineConnectionDidLost: 回调是无论是否成功加入频道,只要 10 秒内和服务器无法建立连接都会触发。
参数
- engine
- AgoraRtcEngineKit 对象。
rtcEngineConnectionDidLost:
rtcEngine:connectionStateChanged:reason:
网络连接状态已改变回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine
connectionStateChanged:(AgoraConnectionState)state
reason:(AgoraConnectionChangedReason)reason;
详情
该回调在网络连接状态发生改变的时候触发,并告知用户当前的网络连接状态和引起网络状态改变的原因。
参数
- engine
- AgoraRtcEngineKit 对象。
- state
当前网络连接状态。详见 AgoraConnectionState。
- reason
引起当前网络连接状态改变的原因。详见 AgoraConnectionChangedReason。
rtcEngine:didOccurEncryptionError:
内置加密出错回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine
didOccurEncryptionError:(AgoraEncryptionErrorType)errorType;
详情
调用 enableEncryption:encryptionConfig: 开启加密后, 如果发流端、收流端出现加解密出错,SDK 会触发该回调。
参数
- engine
- AgoraRtcEngineKit 对象。
- errorType
- 错误类型,详见 AgoraEncryptionErrorType。
rtcEngine:lastmileProbeTestResult:
通话前网络上下行 Last mile 质量探测报告回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine
lastmileProbeTestResult:(AgoraLastmileProbeResult * _Nonnull)result;
详情
在调用 startLastmileProbeTest: 之后,SDK 会在约 30 秒内返回该回调。
参数
- engine
- AgoraRtcEngineKit 对象。
- result
- 上下行 Last mile 质量探测结果。详见 AgoraLastmileProbeResult。
rtcEngine:lastmileQuality:
网络上下行 last mile 质量报告回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine lastmileQuality:(AgoraNetworkQuality)quality;
详情
该回调描述本地用户在加入频道前的 last mile 网络探测的结果,其中 last mile 是指设备到声网边缘服务器的网络状态。
加入频道前,调用 startLastmileProbeTest: 之后,SDK 触发该回调报告本地用户在加入频道前的 last mile 网络探测的结果。
参数
- engine
- AgoraRtcEngineKit 对象。
- quality
- Last mile 网络质量。详见 AgoraNetworkQuality。
rtcEngine:networkQuality:txQuality:rxQuality:
通话中每个用户的网络上下行 last mile 质量报告回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine
networkQuality:(NSUInteger)uid
txQuality:(AgoraNetworkQuality)txQuality
rxQuality:(AgoraNetworkQuality)rxQuality;
详情
该回调描述每个用户在通话中的 last mile 网络状态,其中 last mile 是指设备到声网边缘服务器的网络状态。
该回调每 2 秒触发一次。如果远端有多个用户,该回调每 2 秒会被触发多次。
该回调通过频道内的广播包反馈网络质量。过多的广播包可能引发广播风暴。为防止广播风暴导致频道内大量数据传输,该回调默认支持同时反馈最多 4 个远端主播的网络质量。
Unknown
;用户不收流时,rxQuality 为 Unknown
。参数
- engine
- AgoraRtcEngineKit 对象。
- uid
用户 ID。表示该回调报告的是持有该 ID 的用户的网络质量。如果当 uid 为 0 时,返回的是本地用户的网络质量。
- txQuality
- 该用户的上行网络质量,基于发送码率、上行丢包率、平均往返时延和网络抖动计算。 该值代表当前的上行网络质量,帮助判断是否可以支持当前设置的视频编码属性。 假设上行码率是 1000 Kbps,那么支持直播场景下 640 × 480 的分辨率、15 fps 的帧率没有问题,但是支持 1280 × 720 的分辨率就会有困难。详见 AgoraNetworkQuality。
- rxQuality
- 该用户的下行网络质量,基于下行网络的丢包率、平均往返延时和网络抖动计算。详见 AgoraNetworkQuality。
rtcEngine:networkTypeChanged:
本地网络类型发生改变回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine networkTypeChanged:(AgoraNetworkType)type;
详情
本地网络连接类型发生改变时,SDK 会触发该回调,并在回调中明确当前的网络连接类型。你可以通过该回调获取正在使用的网络类型;当连接中断时,该回调能辨别引起中断的原因是网络切换还是网络条件不好。
参数
- engine
- AgoraRtcEngineKit 对象。
- type
本地网络连接类型。详见 AgoraNetworkType。
rtcEngine:permissionError:
获取设备权限出错回调。
- (void)rtcEngine:(AgoraRtcEngineKit * _Nonnull)engine permissionError:(AgoraPermissionType)type;
详情
无法获取设备权限时,SDK 会触发该回调,报告哪个设备的权限无法获取。
参数
- engine
- AgoraRtcEngineKit 对象。
- type
- 设备权限类型。详见 AgoraPermissionType。
rtcEngine:didProxyConnected:withUid:proxyType:localProxyIp:elapsed:
代理连接状态回调。
- (void)rtcEngine:(AgoraRtcEngineKit* _Nonnull)engine didProxyConnected:(NSString* _Nonnull)channel withUid:(NSUInteger)uid proxyType:(AgoraProxyType)proxyType localProxyIp:(NSString* _Nonnull)localProxyIp elapsed:(NSInteger)elapsed NS_SWIFT_NAME(rtcEngine(_:didProxyConnected:withUid:proxyType:localProxyIp:elapsed:));
详情
通过该回调你可以监听 SDK 连接代理的状态。例如,当用户调用 setCloudProxy: 设置代理并成功加入频道后,SDK 会触发该回调报告用户 ID、连接的代理类型和从调用 joinChannelByToken:channelId:uid:mediaOptions:joinSuccess: 到触发该回调经过的时间等。
参数
- channel
- 频道名称。
- uid
- 用户 ID
- proxyType
- 连接上的代理类型。详见 AgoraProxyType。
- localProxyIp
- 预留参数,暂不支持。
- elapsed
- 从调用 joinChannelByToken:channelId:uid:mediaOptions:joinSuccess: 到 SDK 触发该回调的经过的时间(毫秒)。
rtcEngine:uplinkNetworkInfoUpdate:
上行网络信息变化回调。
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine
uplinkNetworkInfoUpdate:(AgoraUplinkNetworkInfo *_Nonnull)networkInfo;
详情
只有当上行网络信息发生变化时,SDK 才会触发该回调。
参数
- engine
- AgoraRtcEngineKit 对象。
- networkInfo
- 上行网络信息,详见 AgoraUplinkNetworkInfo。