网络及其他
complain
enableEncryption
启用或关闭内置加密功能。
public abstract int enableEncryption(boolean enabled, EncryptionConfig config);
用户离开频道后，SDK 会自动关闭内置加密功能。请在用户重新加入频道前调用该方法。
- 同一频道内的所有用户在调用该方法时必须设置相同的加密配置。
- 启用内置加密功能后，无法使用旁路推流功能。
适用场景
适用于安全性要求较高的场景。
调用时机
请在加入频道前调用该方法。
参数
- enabled
- 是否启用内置加密功能：
- true：启用内置加密功能。
- false：（默认）关闭内置加密功能。
- config
- 内置加密配置。详见 EncryptionConfig。
返回值
enableEncryptionEx
启用或关闭内置加密功能。
public abstract int enableEncryptionEx(boolean enabled, EncryptionConfig config, RtcConnection connection);
用户离开频道后，SDK 会自动关闭内置加密。你需要在用户重新加入频道前调用该方法。
- 同一频道内的所有用户在调用该方法时必须设置相同的加密配置。
- 启用内置加密后，无法使用旁路推流功能。
适用场景
适用于多频道场景，或对安全性要求较高的场景。
调用时机
请在加入频道前调用该方法。
参数
- enabled
- 是否启用内置加密：
- true：启用内置加密。
- false：（默认）关闭内置加密。
- config
- 内置加密配置。详见 EncryptionConfig。
- connection
- 连接信息。详见 RtcConnection。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
enableWebSdkInteroperability
启用或关闭与声网 Web SDK 的互通功能，仅适用于极速直播场景。
public abstract int enableWebSdkInteroperability(boolean enabled);
如果频道中存在 Web SDK 用户，必须调用该方法，否则 Native 用户的视频画面在 Web 端将显示为黑屏。该方法仅适用于极速直播场景，在语音通话场景中默认启用互通功能。
参数
- enabled
- 是否启用互通功能：
- true：启用互通功能。
- false：（默认）关闭互通功能。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
getCallId
getCallIdEx
获取与连接 ID 对应的通话 ID。
public abstract String getCallIdEx(RtcConnection connection);
你可以调用该方法获取 callId，并在调用 rate 和 complain 等方法时传入该 ID。
适用场景
该方法适用于多频道场景。
调用时机
请在加入频道后调用此方法。
参数
- connection
- 连接信息。详见 RtcConnection。
返回值
方法调用成功时，返回通话 ID。 方法调用失败，返回空字符串。
所属接口类getConnectionState
getConnectionStateEx
获取 SDK 当前的连接状态。
public abstract int getConnectionStateEx(RtcConnection connection);
适用场景
该方法适用于多频道场景。
调用时机
该方法可以在加入频道前或后调用。
参数
- connection
- 连接信息。详见 RtcConnection。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
getCurrentMonotonicTimeInMs
获取 SDK 当前的单调时间。
public abstract long getCurrentMonotonicTimeInMs();
在自定义视频采集和自定义音频采集场景中，为确保音视频同步，声网建议调用该方法获取 SDK 当前的单调时间，并将该值传入采集的视频帧 (VideoFrame) 和音频帧 (AudioFrame) 的时间戳参数中。单调时间是指一个随时间单调递增的时间序列，单位为毫秒。
调用时机
该方法可在加入频道前或加入频道后调用。
返回值
- 方法调用成功，返回 SDK 当前的单调时间（单位为毫秒）。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
getErrorDescription
getNativeHandle
getNetworkType
getNtpWallTimeInMs
getSdkVersion
isFeatureAvailableOnDevice
检查当前设备是否支持指定的高级功能。
public abstract boolean isFeatureAvailableOnDevice(int type);
在使用高级功能前，建议调用该方法判断当前设备的能力是否满足要求，以避免在低端设备上启用高级功能时出现性能下降或功能不可用的情况。你可以根据该方法的返回值决定是否显示或启用相应的功能按钮，或在设备能力不足时提示用户。
参数
- type
- 高级功能的类型：
FEATURE_VIDEO_VIRTUAL_BACKGROUND（1）：虚拟背景。FEATURE_VIDEO_BEAUTY_EFFECT（2）：美颜特效。
返回值
- true：当前设备支持指定的功能。
- false：当前设备不支持指定的功能。
queryDeviceScore
rate
sendCustomReportMessage
上报自定义消息。
public abstract int sendCustomReportMessage(String id, String category, String event, String label, int value);
该功能目前处于测试阶段，提供免费试用。在测试版本中，最多支持在 6 秒内上报 10 条消息，每条消息不超过 256 字节，每个字符串不超过 100 字节。如需试用该功能，请联系技术支持，并与我们讨论自定义消息的格式。
参数
- id
- 自定义消息的 ID。
- category
- 自定义消息的类别。
- event
- 自定义消息的事件名称。
- label
- 自定义消息的标签。
- value
- 自定义消息的数值。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
sendCustomReportMessageEx
支持上报和分析自定义消息。
public abstract int sendCustomReportMessageEx(String id, String category, String event, String label, int value, RtcConnection connection);
该功能目前处于测试阶段，提供免费试用。在测试版本中，最多支持在 6 秒内上报 10 条消息，每条消息不超过 256 字节，每个字符串不超过 100 字节。如需试用该功能，请联系技术支持并与我们讨论自定义消息的格式。
适用场景
该方法适用于多频道场景。
参数
- id
- 自定义消息的 ID。
- category
- 自定义消息的类别。
- event
- 自定义消息的事件名称。
- label
- 自定义消息的标签。
- value
- 自定义消息的数值。
- connection
- 连接信息，适用于多频道场景。详见 RtcConnection。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setAVSyncSource
设置发布端的音视频同步源。
public abstract int setAVSyncSource(String channelId, int uid);
你可以在视频发布设备上调用该方法，并传入音频发布设备所在频道的频道名和用户 ID。SDK 会以发送的音频流的时间戳为参考，自动调整视频流，从而确保即使两个发布设备的上行网络条件不同（例如一个使用 Wi-Fi，另一个使用 4G），接收端的音视频也能实现时间同步。
参数
- channelId
- 音频发布设备所在频道的频道名。
- uid
- 音频发布设备的用户 ID。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setCloudProxy
设置云代理服务。
public abstract int setCloudProxy(int proxyType);
当用户的网络访问受防火墙限制时，需要先配置防火墙，允许访问声网提供的特定 IP 地址和端口，然后调用该方法启用云代理，并通过 proxyType 参数设置云代理类型。成功连接云代理后，SDK 会触发 onConnectionStateChanged 回调，状态为 CONNECTION_STATE_CONNECTING，原因为 CONNECTION_CHANGED_SETTING_PROXY_SERVER。 如需关闭已设置的云代理，请调用 setCloudProxy，并将 proxyType 设置为 TRANSPORT_TYPE_NONE_PROXY。 如需切换云代理类型，请先调用 setCloudProxy 关闭当前代理（proxyType 设置为 TRANSPORT_TYPE_NONE_PROXY），再调用 setCloudProxy 设置新的 proxyType。
- 建议在加入频道前调用该方法。
- 当用户处于防火墙之后并使用强制 UDP 云代理时，媒体推流和跨频道联播服务不可用。
- 使用强制 TCP 云代理时，调用
startAudioMixing播放 HTTP 协议的在线音乐文件会报错。媒体推流和跨频道联播服务使用 TCP 协议的云代理。
参数
- proxyType
- 云代理的类型：
TRANSPORT_TYPE_NONE_PROXY(0)：自动模式。SDK 默认启用该模式。在此模式下，SDK 会尝试直接连接 SD-RTN™，若失败则自动切换至 TCP/TLS 443。TRANSPORT_TYPE_UDP_PROXY(1)：UDP 协议的云代理，即强制 UDP 云代理模式。在此模式下，SDK 始终通过 UDP 传输数据。TRANSPORT_TYPE_TCP_PROXY(2)：TCP（加密）协议的云代理，即强制 TCP 云代理模式。在此模式下，SDK 始终通过 TCP/TLS 443 传输数据。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
- -2：参数无效。
- -7：SDK 未初始化。
setLocalAccessPoint
配置连接到声网私有媒体服务器接入模块。
public abstract int setLocalAccessPoint(LocalAccessPointConfiguration config);
成功部署声网混合云解决方案并将 4.x RTC SDK 集成到内网客户端后，可以调用该方法指定本地接入点，并将接入模块分配给 SDK。
调用时机
必须在加入频道前调用该方法。
参数
- config
- 本地接入点配置。详见 LocalAccessPointConfiguration。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setLogFile
设置 SDK 输出日志文件。
public abstract int setLogFile(String filePath);
config 参数设置日志文件路径。该方法需在调用 create [2/2] 后立即调用，否则输出日志可能不完整。
调用时机
该方法需在调用 create 后立即调用，否则输出日志可能不完整。
参数
- filePath
- 日志文件的完整路径，日志文件使用 UTF-8 编码。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setLogFileSize
设置 SDK 日志文件的大小。
public abstract int setLogFileSize(long fileSizeInKBytes);
logConfig 参数设置日志文件大小。- 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。 - 每个日志文件的默认大小为 2,048 KB，采用 UTF-8 编码。
- SDK 会将最新日志写入
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相同。
参数
- fileSizeInKBytes
agorasdk.log文件的大小，单位为 KB。取值范围为 [128, 20480]，默认值为 2,048 KB。- 如果设置值小于 128 KB，SDK 会自动调整为 128 KB。
- 如果设置值大于 20,480 KB，SDK 会自动调整为 20,480 KB。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setLogFilter
设置 SDK 的日志输出等级。
public abstract int setLogFilter(int filter);
logConfig。你可以使用一个或多个日志过滤等级的组合。日志等级的顺序为 LOG_FILTER_OFF、LOG_FILTER_CRITICAL、LOG_FILTER_ERROR、LOG_FILTER_WARN、LOG_FILTER_INFO 和 LOG_FILTER_DEBUG。选择一个等级可以查看该等级及其之前的日志信息。例如，如果将日志等级设置为 LOG_FILTER_WARN，你将看到 LOG_FILTER_CRITICAL、LOG_FILTER_ERROR 和 LOG_FILTER_WARN 等级的日志信息。
参数
- filter
- SDK 的日志输出等级。
LOG_FILTER_OFF(0)：不输出任何日志信息。LOG_FILTER_DEBUG(0x080f)：输出所有日志信息。如果你希望获取最完整的日志文件，请将日志过滤等级设置为LOG_FILTER_DEBUG。LOG_FILTER_INFO(0x0f)：输出LOG_FILTER_CRITICAL、LOG_FILTER_ERROR、LOG_FILTER_WARN和LOG_FILTER_INFO等级的日志信息。建议将日志等级设置为该等级。LOG_FILTER_WARN(0x0e)：输出LOG_FILTER_CRITICAL、LOG_FILTER_ERROR和LOG_FILTER_WARN等级的日志信息。LOG_FILTER_ERROR(0x0c)：输出LOG_FILTER_CRITICAL和LOG_FILTER_ERROR等级的日志信息。LOG_FILTER_CRITICAL(0x08)：仅输出LOG_FILTER_CRITICAL等级的日志信息。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setLogLevel
setParameters
setRemoteSubscribeFallbackOption [1/2]
根据网络状况设置订阅端的视频流回退选项。
public abstract int setRemoteSubscribeFallbackOption(Constants.StreamFallbackOptions option);
如果将 option 设置为 STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW 或 STREAM_FALLBACK_OPTION_AUDIO_ONLY，当下行网络无法同时支持音视频时，SDK 会自动将视频从高质量流切换为低质量流，或关闭视频以保障音频质量。SDK 会持续监测网络质量，在网络改善时恢复音视频流的订阅。
参数
- option
- 订阅流的回退选项。详见 StreamFallbackOptions。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
setRemoteSubscribeFallbackOption [2/2]
根据网络状况设置已订阅视频流的回退选项。
public abstract int setRemoteSubscribeFallbackOption(int option)
不稳定的网络会影响视频通话或互动直播中的音视频质量。当下行网络无法同时支持音视频时，若将 option 设置为 STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW 或 STREAM_FALLBACK_OPTION_AUDIO_ONLY，SDK 会自动将视频从高质量流切换为低质量流，或关闭视频以保障音频质量。SDK 会持续监测网络质量，在网络改善后恢复订阅音视频流。
参数
- option
- 已订阅流的回退选项：
STREAM_FALLBACK_OPTION_DISABLED（0）：不对音视频流进行回退处理，无法保证音视频质量。STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW（1）：（默认）在下行网络较差时，订阅的远端视频流回退为低质量（低分辨率、低码率）的视频流。STREAM_FALLBACK_OPTION_AUDIO_ONLY（2）：在网络条件较差时，优先尝试接收视频小流；若因网络极差无法显示视频，则回退为仅接收音频流。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
startEchoTest
开始音视频设备回路测试。
public abstract int startEchoTest(EchoTestConfiguration config);
你可以调用该方法执行一次音视频通话回路测试，用于检测音视频设备以及用户上下行网络是否正常工作。开始测试后，用户需要发出声音或面对摄像头，音频或视频将在约两秒后输出。
- 在频道中调用该方法时，请确保未发布任何音视频流。
- 调用该方法后需调用 stopEchoTest 结束测试，否则用户无法进行下一次音视频通话回路测试，也无法加入频道。
- 在直播场景中，该方法仅适用于主播。
调用时机
你可以在加入频道前或加入频道后调用此方法。
参数
- config
- 音视频通话回路测试的配置。详见 EchoTestConfiguration。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
startLastmileProbeTest
开始 Last-mile 网络探测测试。
public abstract int startLastmileProbeTest(LastmileProbeConfig config);
该方法在加入频道前启动 Last-mile 网络探测测试，用于获取上行和下行的网络统计信息，包括带宽、丢包率、抖动和往返时延（RTT）。
- onLastmileQuality：SDK 会在约两秒内根据网络状况触发该回调。该回调用于评估网络质量，与用户体验更相关。
- onLastmileProbeResult：SDK 会在约 30 秒内根据网络状况触发该回调。该回调返回网络状况的实时统计数据，更加客观。
参数
- config
- Last-mile 网络探测测试的配置。详见 LastmileProbeConfig。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
stopEchoTest
停止音频通话测试。
public abstract int stopEchoTest();
调用 startEchoTest 后，必须调用该方法结束测试，否则你无法进行下一次音视频通话回路测试，也无法加入频道。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
- -5：停止回声测试失败，可能未在运行回声测试。
stopLastmileProbeTest
onConnectionBanned
连接被声网服务器封禁时触发的回调。
public void onConnectionBanned() {}
触发时机
该回调在连接被声网服务器封禁时被触发。
onConnectionInterrupted
public void onConnectionInterrupted() {}
- 当 SDK 成功加入频道后，与服务器断开连接超过四秒时，会触发 onConnectionInterrupted 回调。
- 无论是否加入频道，当 SDK 与服务器断开连接超过 10 秒时，会触发 onConnectionLost 回调。
触发时机
该回调在 SDK 与服务器断开连接超过四秒时被触发。
onConnectionLost
onConnectionLost 回调：当 SDK 在连接中断后 10 秒内无法重新连接到声网边缘服务器时触发。
public void onConnectionLost() {}
无论是否在频道中，当调用 joinChannel 方法后，SDK 在连接中断后 10 秒内无法连接到服务器时会触发该回调。如果 SDK 在与声网边缘服务器断开连接后 20 分钟内仍无法重新加入频道，则停止重连。
触发时机
该回调在调用 joinChannel 后，SDK 与服务器连接中断并在 10 秒内无法重新连接时被触发。
onConnectionStateChanged
网络连接状态发生变化回调。
public void onConnectionStateChanged(int state, int reason)
SDK 会在网络连接状态发生变化时触发该回调，并报告当前的连接状态及其变化原因。
触发时机
该回调在网络连接状态发生变化时被触发。
参数
- state
- 当前的连接状态：
CONNECTION_STATE_DISCONNECTED(1)：SDK 与声网边缘服务器断开连接。CONNECTION_STATE_CONNECTING(2)：SDK 正在连接声网边缘服务器。CONNECTION_STATE_CONNECTED(3)：SDK 已连接到声网边缘服务器。CONNECTION_STATE_RECONNECTING(4)：SDK 尝试重新连接声网边缘服务器。CONNECTION_STATE_FAILED(5)：SDK 连接声网边缘服务器失败。
- reason
- 连接状态变化的原因：
CONNECTION_CHANGED_CONNECTING(0)：SDK 正在连接声网边缘服务器。CONNECTION_CHANGED_JOIN_SUCCESS(1)：SDK 成功加入频道。CONNECTION_CHANGED_INTERRUPTED(2)：SDK 与声网边缘服务器之间的连接中断。CONNECTION_CHANGED_BANNED_BY_SERVER(3)：连接被声网服务器禁止，例如用户被踢出频道时会返回该错误码。CONNECTION_CHANGED_JOIN_FAILED(4)：SDK 加入频道失败。若超过 20 分钟未能加入频道，SDK 会停止重连并返回该错误码。你需要提示用户尝试切换网络并重新加入频道。CONNECTION_CHANGED_LEAVE_CHANNEL(5)：SDK 已离开频道。CONNECTION_CHANGED_INVALID_APP_ID(6)：无效的 App ID。你需要使用有效的 App ID 重新加入频道，并确保该 App ID 与声网控制台中生成的一致。CONNECTION_CHANGED_INVALID_CHANNEL_NAME(7)：无效的频道名。请使用有效的频道名重新加入频道。有效的频道名为不超过 64 字节的字符串，支持的字符包括：- 所有小写英文字母：a 到 z。
- 所有大写英文字母：A 到 Z。
- 所有数字字符：0 到 9。
- 特殊字符：
!,#,$,%,&,(,),+,-,:,;,<,=,.,>,?,@,[,],^,_,{,},|,~,,。
CONNECTION_CHANGED_INVALID_TOKEN(8)：无效的 Token。可能原因包括：- 项目在声网控制台启用了 App Certificate，但加入频道时未传入 Token。
- 调用
joinChannel加入频道时指定的uid与生成 Token 时传入的uid不一致。 - 使用的 Token 与生成的 Token 不一致。
- 项目启用 App Certificate 时，加入频道必须传入 Token。
- 生成 Token 时指定的用户 ID 与加入频道时使用的用户 ID 一致。
- 使用的 Token 与生成的 Token 一致。
CONNECTION_CHANGED_TOKEN_EXPIRED(9)：当前使用的 Token 已过期。你需要在服务器上生成新的 Token，并使用新 Token 重新加入频道。CONNECTION_CHANGED_REJECTED_BY_SERVER(10)：用户被服务器禁止。CONNECTION_CHANGED_SETTING_PROXY_SERVER(11)：设置代理服务器后，SDK 尝试重新连接。CONNECTION_CHANGED_RENEW_TOKEN(12)：由于 Token 被更新，连接状态发生变化。CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED(13)：客户端 IP 地址发生变化。如果多次收到该错误码，你需要提示用户切换网络并重新加入频道。CONNECTION_CHANGED_KEEP_ALIVE_TIMEOUT(14)：SDK 与声网边缘服务器之间的连接保活超时，SDK 会自动尝试重新连接。CONNECTION_CHANGED_REJOIN_SUCCESS(15)：SDK 成功重新加入频道。CONNECTION_CHANGED_LOST(16)：SDK 与服务器之间的连接丢失。CONNECTION_CHANGED_ECHO_TEST(17)：由于回声测试，连接状态发生变化。CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED_BY_USER(18)：本地 IP 地址被用户更改。CONNECTION_CHANGED_SAME_UID_LOGIN(19)：用户在不同设备上以相同的uid加入同一频道。注意：以相同uid加入同一 RTC 频道属于未定义行为，声网不保证在相同情况下始终触发该错误码。CONNECTION_CHANGED_TOO_MANY_BROADCASTERS(20)：频道中的主播数量已达上限。
onEncryptionError
内置加密错误回调。
public void onEncryptionError(int errorType)
如果在调用 enableEncryption 启用加密功能后，发送端或接收端在加密或解密过程中发生错误，SDK 会触发该回调。
触发时机
该回调在加密或解密过程中发生错误时被触发。
参数
- errorType
- 错误类型：
ENCRYPTION_ERROR_INTERNAL_FAILURE（0）：内部原因。ENCRYPTION_ERROR_DECRYPTION_FAILURE（1）：媒体流解密错误。请确保接收端和发送端使用相同的加密模式和密钥。ENCRYPTION_ERROR_ENCRYPTION_FAILURE（2）：媒体流加密错误。ENCRYPTION_ERROR_DATASTREAM_DECRYPTION_FAILURE（3）：数据流解密错误。请确保接收端和发送端使用相同的加密模式和密钥。ENCRYPTION_ERROR_DATASTREAM_ENCRYPTION_FAILURE（4）：数据流加密错误。
onLastmileProbeResult
上行和下行 Last-mile 网络探测测试结果的回调。
public void onLastmileProbeResult(LastmileProbeResult result) {}
该回调在调用 startLastmileProbeTest 后触发。
触发时机
该回调在调用 startLastmileProbeTest 后 30 秒内被触发。
参数
- result
- 上行和下行 Last-mile 网络探测测试结果。详见 LastmileProbeResult。
onLastmileQuality
本地用户的 Last-mile 网络质量回调。
public void onLastmileQuality(int quality)
该回调在用户加入频道前触发，用于上报本地用户与声网边缘服务器之间连接的 Last-mile 网络质量。在调用 startLastmileProbeTest 后，SDK 会触发该回调。
触发时机
该回调在调用 startLastmileProbeTest 方法后被触发。
参数
- quality
- Last-mile 网络质量：
QUALITY_UNKNOWN(0)：网络质量未知。QUALITY_EXCELLENT(1)：网络质量极好。QUALITY_GOOD(2)：网络质量较好，但码率可能略低于极好。QUALITY_POOR(3)：通信质量略有下降。QUALITY_BAD(4)：无法流畅通信。QUALITY_VBAD(5)：网络质量极差，几乎无法通信。QUALITY_DOWN(6)：网络连接已断，无法通信。QUALITY_DETECTING(8)：正在进行 Last-mile 探测。
onMultipathStats
多路径传输统计信息回调。
public void onMultipathStats(MultipathStats stats) {}
触发时机
该回调在你将 enableMultipath 设置为 true 以启用多路径传输后被触发。
参数
- stats
- 多路径传输统计信息。详见 MultipathStats。
onNetworkQuality
onNetworkQuality 回调。报告频道中每个用户的 Last-mile 网络质量。
public void onNetworkQuality(int uid, int txQuality, int rxQuality)
该回调通过在频道内发送和接收广播数据包来反馈网络质量。过多的广播数据包可能导致广播风暴。为防止广播风暴造成频道内大量数据传输，该回调默认最多同时反馈 4 个远端用户的网络质量。
txQuality 在用户未发送流时为 UNKNOWN；rxQuality 在用户未接收流时为 UNKNOWN。触发时机
该回调每两秒触发一次。
参数
- uid
- 用户 ID，用于标识被报告网络质量的用户。
- 0：表示本地用户。
- txQuality
- 用户上行网络质量评分，依据传输码率、丢包率、平均往返时延（RTT）和抖动等指标评估。
QUALITY_UNKNOWN(0)：质量未知。QUALITY_EXCELLENT(1)：质量极佳。QUALITY_GOOD(2)：网络质量看似极佳，但码率略低于极佳。QUALITY_POOR(3)：用户能感受到通信略有卡顿。QUALITY_BAD(4)：用户无法流畅通信。QUALITY_VBAD(5)：质量极差，用户几乎无法通信。QUALITY_DOWN(6)：网络连接已断，用户无法通信。QUALITY_DETECTING(8)：正在进行 Last-mile 探测测试。
- rxQuality
- 用户下行网络质量评分，依据丢包率、平均往返时延（RTT）和抖动等指标评估。
QUALITY_UNKNOWN(0)：质量未知。QUALITY_EXCELLENT(1)：质量极佳。QUALITY_GOOD(2)：网络质量看似极佳，但码率略低于极佳。QUALITY_POOR(3)：用户能感受到通信略有卡顿。QUALITY_BAD(4)：用户无法流畅通信。QUALITY_VBAD(5)：质量极差，用户几乎无法通信。QUALITY_DOWN(6)：网络连接已断，用户无法通信。QUALITY_DETECTING(8)：正在进行 Last-mile 探测测试。
onNetworkTypeChanged
本地网络类型发生变化时的回调。
public void onNetworkTypeChanged(int type)
你可以通过该回调获取连接状态及其变化原因。当网络连接中断时，该回调会指示中断是由于网络类型变化还是由于网络状况不佳导致的。
触发时机
该回调在本地网络类型发生变化时被触发。
参数
- type
- 网络类型：
NETWORK_TYPE_UNKNOWN（-1）：网络类型未知。NETWORK_TYPE_DISCONNECTED（0）：SDK 与网络断开连接。NETWORK_TYPE_LAN（1）：网络类型为 LAN。NETWORK_TYPE_WIFI（2）：网络类型为 Wi-Fi（包括热点）。NETWORK_TYPE_MOBILE_2G（3）：网络类型为移动 2G。NETWORK_TYPE_MOBILE_3G（4）：网络类型为移动 3G。NETWORK_TYPE_MOBILE_4G（5）：网络类型为移动 4G。NETWORK_TYPE_MOBILE_5G（6）：网络类型为移动 5G。
onPermissionError
设备权限获取失败时触发的回调。
public void onPermissionError(int permission)
该回调在 SDK 无法获取设备权限时被触发，用于报告无法获取的权限类型。
触发时机
该回调在 SDK 无法获取设备权限时被触发。
参数
- permission
- 设备权限的类型：
RECORD_AUDIO（0）：音频采集设备的权限。CAMERA（1）：摄像头的权限。SCREEN_CAPTURE（2）：屏幕共享的权限。
onProxyConnected
代理连接状态回调。
public void onProxyConnected(String channel, int uid, int proxyType, String localProxyIp, int elapsed)
当用户调用 setCloudProxy 并成功加入频道后，SDK 会触发该回调，报告用户 ID、连接的代理类型，以及从调用 joinChannel 到触发该回调所经历的时间（毫秒）。
触发时机
该回调在用户调用 setCloudProxy 并成功加入频道后被触发。
参数
- channel
- 频道名。
- uid
- 用户 ID。
- proxyType
- 连接的代理类型：
PROXY_TYPE_NONE_PROXY（0）：预留参数。PROXY_TYPE_UDP_CLOUD_PROXY（1）：UDP 协议的云代理，即强制 UDP 云代理模式。在该模式下，SDK 始终通过 UDP 传输数据。PROXY_TYPE_TCP_CLOUD_PROXY（2）：TCP（加密）协议的云代理，即强制 TCP 云代理模式。在该模式下，SDK 始终通过 TCP/TLS 443 传输数据。PROXY_TYPE_LOCAL_PROXY（3）：预留参数。PROXY_TYPE_TCP_AUTO_FALLBACK（4）：自动模式。在该模式下，SDK 会尝试直接连接 SD-RTN™，如果失败则自动切换到 TCP/TLS 443。
- localProxyIp
- 预留参数。
- elapsed
- 从调用
joinChannel到触发该回调所经历的时间（毫秒）。
onRemoteSubscribeFallbackToAudioOnly
onRemoteSubscribeFallbackToAudioOnly 回调。当远端媒体流因网络变化在音频流与视频流之间切换时触发。
public void onRemoteSubscribeFallbackToAudioOnly(int uid, boolean isFallbackOrRecover)
setRemoteSubscribeFallbackOption 并将 option 设置为 STREAM_FALLBACK_OPTION_AUDIO_ONLY，SDK 会在以下情况下触发该回调： - 下行网络条件较差，已订阅的视频流降级为纯音频流。
- 下行网络条件改善，已订阅的流恢复为视频流。
触发时机
该回调在远端媒体流因网络变化在音频流与视频流之间切换时被触发。
参数
- uid
- 远端用户 ID。
- isFallbackOrRecover
- 是否因网络变化触发音视频切换：
- true：由于网络条件差，已订阅的媒体流降级为纯音频流。
- false：网络条件改善后，已订阅的媒体流恢复为视频流。
onUplinkNetworkInfoUpdated
上行网络信息发生变化回调。
public void onUplinkNetworkInfoUpdated(UplinkNetworkInfo info) {}
触发时机
该回调在上行网络信息发生变化时被触发。
参数
- info
- 上行网络信息，详见 UplinkNetworkInfo。