# 网络及其他 (/zh-CN/api-reference/rtc/unreal-cpp/network) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## complain [#complain] 投诉通话质量。 ```cpp virtual int complain(const char* callId, const char* description) = 0; ``` ### 详情 [#详情] 该方法允许用户就通话质量进行投诉。需要在离开频道后调用。 ### 参数 [#参数] 通话 ID。你可以通过调用 [getCallId](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_getcallid) 获取该参数。 (非必选项)通话的描述。长度应小于 800 字节。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -1: 一般性的错误(未明确归类)。 - -2: 参数无效。 - -7: [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) 尚未初始化就调用方法。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableEncryption [#enableencryption] 开启或关闭内置加密。 ```cpp virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; ``` 用户离开频道后,SDK 会自动关闭加密。如需重新开启加密,你需要在用户再次加入频道前调用该方法。 ### 适用场景 [#适用场景] 对安全要求较高的场景。 ### 调用时机 [#调用时机] 该方法需要在加入频道前调用。 ### 调用限制 [#调用限制] - 同一频道内的所有用户在调用该方法时,必须设置相同的加密模式和密钥。 - 如果开启了内置加密,则不能使用旁路推流功能。 ### 参数 [#参数-1] 是否开启内置加密: - true: 开启内置加密。 - false:(默认)关闭内置加密。 配置内置加密模式和密钥。详见 [EncryptionConfig](/zh-CN/api-reference/rtc/unreal-cpp/class-encryptionconfig)。 ### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败 - -2: 调用了无效的参数。需重新指定参数。 - -4: 设置的加密模式不正确或加载外部加密库失败。需检查枚举值是否正确或重新加载外部加密库。 - -7: SDK 尚未初始化。需在调用 API 之前已创建 [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) 对象并完成初始化。 ### 所属接口类 [#所属接口类-1] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableEncryptionEx [#enableencryptionex] 开启或关闭内置加密。 ```cpp virtual int enableEncryptionEx(const RtcConnection& connection, bool enabled, const EncryptionConfig& config) = 0; ``` 用户离开频道后,SDK 会自动关闭加密。如需重新开启加密,你需要在用户再次加入频道前调用该方法。 ### 适用场景 [#适用场景-1] 对安全要求较高的场景。 ### 调用时机 [#调用时机-1] 该方法需要在加入频道前调用。 ### 调用限制 [#调用限制-1] - 同一频道内的所有用户在调用该方法时,必须设置相同的加密模式和密钥。 - 如果开启了内置加密,则不能使用旁路推流功能。 ### 参数 [#参数-2] 是否开启内置加密: - true: 开启内置加密。 - false:(默认)关闭内置加密。 配置内置加密模式和密钥。详见 [EncryptionConfig](/zh-CN/api-reference/rtc/unreal-cpp/class-encryptionconfig)。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unreal-cpp/class-rtcconnection)。 ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IRtcEngineEx](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineex) ## enableWebSdkInteroperability [#enablewebsdkinteroperability] 打开与 Web SDK 的互通(仅在直播场景适用)。 ```cpp virtual int enableWebSdkInteroperability(bool enabled) = 0; ``` ### 详情 [#详情-1] :::error[弃用:] 该方法已废弃,SDK 自动开启与 Web SDK 的互通,无需调用该方法开启。 ::: 该方法打开或关闭与 Web SDK 的互通。如果有用户通过 Web SDK 加入频道,请确保调用该方法,否则 Web 端用户看 Native 端的画面会是黑屏。 该方法仅在直播场景下适用,通信场景下默认互通是打开的。 ### 参数 [#参数-3] 是否打开与 Web SDK 的互通: - `true`: 打开互通。 - `false`: (默认) 关闭互通。 ### 返回值 [#返回值-3] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getCallId [#getcallid] 获取通话 ID。 ```cpp virtual int getCallId(agora::util::AString& callId) = 0; ``` 客户端在每次加入频道后会生成一个对应的 callId,标识该客户端的此次通话。你可以调用该方法获取 callId 参数,然后在调用 [rate](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_rate)、[complain](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_complain) 等方法时填入。 ### 调用时机 [#调用时机-2] 该方法需要在加入频道后调用。 ### 调用限制 [#调用限制-2] 无。 ### 参数 [#参数-4] 输出参数,当前的通话 ID。 ### 返回值 [#返回值-4] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getCallIdEx [#getcallidex] 使用连接 ID 获取通话 ID。 ```cpp virtual int getCallIdEx(agora::util::AString& callId, const RtcConnection& connection) = 0; ``` 客户端在每次加入频道后会生成一个对应的 callId,标识该客户端的此次通话。你可以调用该方法获取 callId 参数,然后在调用 [rate](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_rate)、[complain](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_complain) 等方法时填入。 ### 调用时机 [#调用时机-3] 该方法需要在加入频道后调用。 ### 调用限制 [#调用限制-3] 无。 ### 参数 [#参数-5] 输出参数,当前的通话 ID。 Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unreal-cpp/class-rtcconnection)。 ### 返回值 [#返回值-5] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [IRtcEngineEx](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineex) ## getConnectionState [#getconnectionstate] 获取当前网络连接状态。 ```cpp virtual CONNECTION_STATE_TYPE getConnectionState() = 0; ``` ### 调用时机 [#调用时机-4] 加入频道前后均可调用。 ### 调用限制 [#调用限制-4] 无。 ### 返回值 [#返回值-6] 当前网络连接状态。详见 [CONNECTION_STATE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-connectionstatetype)。 ### 所属接口类 [#所属接口类-6] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getConnectionStateEx [#getconnectionstateex] 获取当前网络连接状态。 ```cpp virtual CONNECTION_STATE_TYPE getConnectionStateEx(const RtcConnection& connection) = 0; ``` ### 调用时机 [#调用时机-5] 加入频道前后均可调用。 ### 调用限制 [#调用限制-5] 无。 ### 参数 [#参数-6] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unreal-cpp/class-rtcconnection)。 ### 返回值 [#返回值-7] 当前网络连接状态。详见 [CONNECTION_STATE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-connectionstatetype)。 ### 所属接口类 [#所属接口类-7] - [IRtcEngineEx](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineex) ## getCurrentMonotonicTimeInMs [#getcurrentmonotonictimeinms] 获取 SDK 当前的 Monotonic Time。 ```cpp virtual int64_t getCurrentMonotonicTimeInMs() = 0; ``` Monotonic Time 是指一个单调递增的时间序列,它的值会随着时间的推移而增加。单位为毫秒。 在自定义视频采集、自定义音频采集场景中,为确保音视频同步,声网建议你调用该方法获取 SDK 当前的 Monotonic Time 后,将该值传入采集的视频帧([VideoFrame](/zh-CN/api-reference/rtc/unreal-cpp/class-videoframe))、音频帧([AudioFrame](/zh-CN/api-reference/rtc/unreal-cpp/class-audioframe))的时间戳参数。 ### 调用时机 [#调用时机-6] 加入频道前后均可调用。 ### 调用限制 [#调用限制-6] 无。 ### 返回值 [#返回值-8] - ≥ 0: 方法调用成功,返回 SDK 当前的 Monotonic Time(毫秒)。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-8] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getErrorDescription [#geterrordescription] 获取警告或错误描述。 ```cpp virtual const char* getErrorDescription(int code) = 0; ``` ### 参数 [#参数-7] SDK 报告的错误码。 ### 返回值 [#返回值-9] 具体的错误描述。 ### 所属接口类 [#所属接口类-9] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getNetworkType [#getnetworktype] 获取本地网络连接类型。 ```cpp virtual int getNetworkType() = 0; ``` ### 详情 [#详情-2] 你可以在任何阶段通过该方法获取正在使用的网络类型。 :::note 注: 该方法在加入频道前后均可调用。 ::: ### 返回值 [#返回值-10] - ≥ 0: 方法调用成功,返回本地网络连接类型。 - 0:网络连接已断开。 - 1:网络类型为 LAN。 - 2:网络类型为 Wi-Fi(包含热点)。 - 3:网络类型为 2G 移动网络。 - 4:网络类型为 3G 移动网络。 - 5:网络类型为 4G 移动网络。 - 6:网络类型为 5G 移动网络。 - < 0: 方法调用失败,返回错误码。 - -1:网络连接类型未知。 ### 所属接口类 [#所属接口类-10] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getNtpWallTimeInMs [#getntpwalltimeinms] 获取当前的 NTP (网络时间协议) 时间。 ```cpp virtual uint64_t getNtpWallTimeInMs() = 0; ``` ### 详情 [#详情-3] 在实时合唱的场景中,特别是在各个接收端由于网络原因导致下行链路不一致的情况下,你可以调用该方法来获取当前的 NTP 时间作为基准时间,以对齐多个接收端的歌词和音乐,实现合唱同步。 ### 返回值 [#返回值-11] 当前 NTP 时间的 Unix 时间戳 (毫秒)。 ### 所属接口类 [#所属接口类-11] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## getVersion [#getversion] 获取 SDK 版本。 ```cpp virtual const char* getVersion(int* build) = 0; ``` ### 参数 [#参数-8] 编译号。 ### 返回值 [#返回值-12] 当前的 SDK 版本号。格式为字符串。 ### 所属接口类 [#所属接口类-12] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## isFeatureAvailableOnDevice [#isfeatureavailableondevice] 查询设备是否支持指定进阶功能。 ```cpp virtual bool isFeatureAvailableOnDevice(FeatureType type) = 0; ``` ### 详情 [#详情-4] 查询当前设备能力是否满足虚拟背景、美颜等进阶功能的要求。 ### 适用场景 [#适用场景-2] 在使用进阶音视频功能前,你可以根据查询结果判断当前设备是否支持这些功能,从而避免在低端设备上开启进阶功能导致性能下降或功能不可用的问题。你可以根据该方法的返回值,决定是否显示或启用相应的功能按钮,或者在设备能力不足时,为用户提示相应信息。 ### 参数 [#参数-9] 进阶功能类型,详见 [FeatureType](/zh-CN/api-reference/rtc/unreal-cpp/enum-featuretype)。 ### 返回值 [#返回值-13] - `true`: 设备支持指定进阶功能。 - `false`: 设备不支持指定进阶功能。 ### 所属接口类 [#所属接口类-13] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## onRemoteSubscribeFallbackToAudioOnly [#onremotesubscribefallbacktoaudioonly] 订阅流已回退为音频流或恢复为音视频流回调。 ```cpp virtual void onRemoteSubscribeFallbackToAudioOnly(uid_t uid, bool isFallbackOrRecover) { (void)uid; (void)isFallbackOrRecover; } ``` ### 详情 [#详情-5] 当你调用了 [setRemoteSubscribeFallbackOption](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_setremotesubscribefallbackoption) 并将 option 设置为 STREAM_FALLBACK_OPTION_AUDIO_ONLY 后,该回调会在下列情况时被触发: - 下行网络环境较差,订阅的音视频流回退为音频流 - 下行网络环境改善,订阅音频流恢复为音视频流 :::caution 注意: 订阅流因弱网环境而回退为视频小流时,你可以通过 [onRemoteVideoStats](/zh-CN/api-reference/rtc/unreal-cpp/video/video-basic#callback_irtcengineeventhandler_onremotevideostats) 回调来监控远端视频大小流的切换。 ::: ### 参数 [#参数-10] 远端用户的用户 ID。 - `true`: 由于网络环境不理想,订阅流已回退为音频流。 - `false`: 由于网络环境改善,订阅流已恢复为音视频流。 ### 所属接口类 [#所属接口类-14] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## queryDeviceScore [#querydevicescore] 查询设备评分等级。 ```cpp virtual int queryDeviceScore() = 0; ``` ### 详情 [#详情-6] ### 适用场景 [#适用场景-3] 在高清或超高清视频场景下,可以先调用该方法查询设备的等级评分。如果返回的评分较低(比如低于 60),则需要适当调低视频分辨率,以避免影响视频体验。不同业务场景要求的最低设备评分等级不同,具体评分推荐请[联系技术支持](https://ticket.shengwang.cn/)。 ### 返回值 [#返回值-14] - < 0: 方法调用失败。 ### 所属接口类 [#所属接口类-15] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## queryInterface [#queryinterface] 获取指定接口类的指针。 ```cpp virtual int queryInterface(INTERFACE_ID_TYPE iid, void** inter) = 0; ``` ### 参数 [#参数-11] 想要获取的接口类 ID。详见 [INTERFACE_ID_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-interfaceidtype)。 输出参数。指定接口的对象指针。 ### 返回值 [#返回值-15] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-16] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## rate [#rate] 给通话评分。 ```cpp virtual int rate(const char* callId, int rating, const char* description) = 0; ``` ### 详情 [#详情-7] :::caution 注意: 该方法需要在用户离开频道后调用。 ::: ### 参数 [#参数-12] 通话 ID。你可以通过调用 [getCallId](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_getcallid) 获取该参数。 给通话的评分,最低 1 分,最高 5 分。 (非必选项)给通话的描述。长度应小于 800 字节。 ### 返回值 [#返回值-16] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -1: 一般性的错误(未明确归类)。 - -2: 参数无效。 ### 所属接口类 [#所属接口类-17] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## registerPacketObserver [#registerpacketobserver] 注册数据包观测器。 ```cpp virtual int registerPacketObserver(IPacketObserver* observer) = 0; ``` ### 详情 [#详情-8] 该方法注册数据包观测器 (Packet Observer)。在 SDK 发送/接收(语音、视频)网络包时,会回调 [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) 定义的接口,App 可用此接口对数据做处理,例如加解密。 :::caution 注意: - 处理后发送到网络的包大小不应超过 1200 字节,否则有可能发送失败。 - 若需调用此方法,需确保接收端和发送端都调用此方法,否则会出现未定义行为(例如音频无声或视频黑屏)。 - 若在直播场景下使用旁路推流、录制,不建议调用此方法。 - 你需要在加入频道前调用该方法。 ::: ### 参数 [#参数-13] [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) 。 ### 返回值 [#返回值-17] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-18] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## sendCustomReportMessage [#sendcustomreportmessage] 发送自定义上报消息。 ```cpp virtual int sendCustomReportMessage(const char *id, const char* category, const char* event, const char* label, int value) = 0; ``` ### 详情 [#详情-9] 声网提供自定义数据上报和分析服务。该服务当前处于免费内测期。内测期提供的能力为 6 秒内最多上报 10 条数据,每条自定义数据不能超过 256 字节,每个字符串不能超过 100 字节。如需试用该服务,请[联系销售](https://www.shengwang.cn/contact-sales/)开通并商定自定义数据格式。 ### 所属接口类 [#所属接口类-19] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## sendCustomReportMessageEx [#sendcustomreportmessageex] 自定义数据上报和分析服务。 ```cpp virtual int sendCustomReportMessageEx(const char* id, const char* category, const char* event, const char* label, int value, const RtcConnection& connection) = 0; ``` ### 详情 [#详情-10] 声网提供自定义数据上报和分析服务。该服务当前处于免费内测期。内测期提供的能力为 6 秒内最多上报 10 条数据,每条自定义数据不能超过 256 字节,每个字符串不能超过 100 字节。如需试用该服务,请[联系销售](https://www.shengwang.cn/contact-sales/)开通并商定自定义数据格式。 ### 所属接口类 [#所属接口类-20] - [IRtcEngineEx](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineex) ## setAVSyncSource [#setavsyncsource] 设置发流端音画同步。 ```cpp virtual int setAVSyncSource(const char* channelId, uid_t uid) = 0; ``` ### 详情 [#详情-11] 同一用户可能使用两个设备分别发送音频流和视频流,为保证接收端听到和看到的音频和视频的时间同步性,你可以在视频发送端调用该方法,并传入音频发送端的频道名、用户 ID。 SDK 会以发送的音频流的时间戳为基准进行自动调节发送的视频流,以保证即使在两个发送端的上行网络情况不一致(如分别使用 Wi-Fi 和 4G 网络)的情况下,也能让接收到的音视频具有时间同步性。 :::caution 注意: 建议你在加入频道前调用该方法。 ::: ### 参数 [#参数-14] 标识音频发送端所在频道的频道名。 音频发送端的用户 ID。 ### 返回值 [#返回值-18] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-21] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setCloudProxy [#setcloudproxy] 设置云代理服务。 ```cpp virtual int setCloudProxy(CLOUD_PROXY_TYPE proxyType) = 0; ``` ### 详情 [#详情-12] 当用户的网络访问受到防火墙限制时,你需要将声网提供的 IP 和端口号添加到防火墙白名单,然后调用该方法开启云代理,并通过 proxyType 参数设置云代理类型。 成功连接云代理后,SDK 会触发 [onConnectionStateChanged](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onconnectionstatechanged) (CONNECTION_STATE_CONNECTING, CONNECTION_CHANGED_SETTING_PROXY_SERVER) 回调。 如果你想关闭已设置的 Force UDP 或 Force TCP 云代理,请调用 setCloudProxy`(NONE_PROXY)`。 如果你想更改已设置的云代理类型,请先调用 setCloudProxy`(NONE_PROXY)`,再调用 setCloudProxy 并传入你期望的 proxyType 值。 :::caution 注意: - 建议你在频道外调用该方法。 - 如果用户处于内网防火墙环境下,使用 Force UDP 云代理时,旁路推流和跨频道媒体流转发功能不可用。 - 使用 Force UDP 云代理时,调用 [startAudioMixing [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/play/audio-mixing#api_irtcengine_startaudiomixing2) 方法时无法播放 HTTP 协议的在线音频文件。旁路推流和跨频道媒体流转发功能会使用 TCP 协议的云代理。 ::: ### 参数 [#参数-15] 云代理类型,详见 [CLOUD_PROXY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-cloudproxytype)。 该参数为必填参数,如果你不赋值,SDK 会报错。 ### 返回值 [#返回值-19] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -2: 传入的参数无效。 - -7: SDK 尚未初始化。 ### 所属接口类 [#所属接口类-22] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setLocalAccessPoint [#setlocalaccesspoint] 配置与声网私有媒体服务器接入模块的连接。 ```cpp virtual int setLocalAccessPoint(const LocalAccessPointConfiguration& config) = 0; ``` 成功部署声网私有媒体服务器并在内网终端集成 4.x RTC SDK 后,你可以调用该方法指定 Local Access Point,给 SDK 分配接入模块。 ### 调用时机 [#调用时机-7] 该方法需要在加入频道前调用。 ### 调用限制 [#调用限制-7] 该方法仅在部署声网混合云方案后生效。你可以[联系销售](https://www.shengwang.cn/contact-sales/)了解和部署声网混合云。 ### 参数 [#参数-16] Local Access Point 配置。详见 [LocalAccessPointConfiguration](/zh-CN/api-reference/rtc/unreal-cpp/class-localaccesspointconfiguration)。 ### 返回值 [#返回值-20] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ## setLogFile [#setlogfile] 设置日志文件 ```cpp virtual int setLogFile(const char* filePath) = 0; ``` :::error[弃用:] 该方法已废弃,请在调用 [initialize](/zh-CN/api-reference/rtc/unreal-cpp/initialize#api_irtcengine_initialize) 时通过 context 参数设置日志文件路径。 ::: 设置 SDK 的输出 log 文件。SDK 运行时产生的所有 log 将写入该文件。 ### 调用时机 [#调用时机-8] 该方法需要在 initialize 后立即调用,否则输出日志可能不完整。 ### 调用限制 [#调用限制-8] App 必须保证指定的目录存在而且可写。 ### 参数 [#参数-17] 日志文件的完整路径。该日志文件为 UTF-8 编码。 ### 返回值 [#返回值-21] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-23] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setLogFileSize [#setlogfilesize] 设置 SDK 输出的日志文件的大小。 ```cpp virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; ``` ### 详情 [#详情-13] :::error[弃用:] 该方法已废弃,请改用 [initialize](/zh-CN/api-reference/rtc/unreal-cpp/initialize#api_irtcengine_initialize) 中的 `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 会按照以下顺序对日志文件进行操作: 1. 删除 `agorasdk.4.log` 文件(如有)。 2. 将 `agorasdk.3.log` 重命名为 `agorasdk.4.log`。 3. 将 `agorasdk.2.log` 重命名为 `agorasdk.3.log`。 4. 将 `agorasdk.1.log` 重命名为 `agorasdk.2.log`。 5. 新建 `agorasdk.log` 文件。 - `agoraapi.log` 文件的覆盖规则与 `agorasdk.log` 相同。 :::note 注: 该方法仅用于设置 `agorasdk.log` 文件的大小,对`agoraapi.log`不生效。 ::: ### 参数 [#参数-18] 单个 `agorasdk.log` 日志文件的大小,单位为 KB,取值范围为 [128,20480],默认值为 2,048 KB。如果你将 `fileSizeInKByte` 设为小于 128 KB,SDK 会自动调整到 128 KB;如果你将 `fileSizeInKByte` 设为大于 20,480 KB,SDK 会自动调整到 20,480 KB。 ### 返回值 [#返回值-22] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-24] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setLogFilter [#setlogfilter] 设置日志输出等级。 ```cpp virtual int setLogFilter(unsigned int filter) = 0; ``` ### 详情 [#详情-14] :::error[弃用:] 请改用 [initialize](/zh-CN/api-reference/rtc/unreal-cpp/initialize#api_irtcengine_initialize) 中的 logConfig。 ::: 该方法设置 SDK 的输出日志输出等级。不同的输出等级可以单独或组合使用。日志级别顺序依次为 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 级别的日志信息。 ### 参数 [#参数-19] 日志过滤等级。详见 [LOG_FILTER_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-logfiltertype)。 ### 返回值 [#返回值-23] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-25] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setLogLevel [#setloglevel] 设置 SDK 的日志输出级别。 ```cpp virtual int setLogLevel(commons::LOG_LEVEL level) = 0; ``` :::error[弃用:] 该方法已废弃,请在调用 [initialize](/zh-CN/api-reference/rtc/unreal-cpp/initialize#api_irtcengine_initialize) 时通过 context 参数设置日志输出级别。 ::: 选择一个级别,你就可以看到该级别的日志信息。 ### 参数 [#参数-20] 日志级别。详见 [LOG_LEVEL](/zh-CN/api-reference/rtc/unreal-cpp/enum-loglevel)。 ### 返回值 [#返回值-24] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-26] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setParameters [1/2] [#setparameters-12] SDK 的 JSON 配置信息,用于提供技术预览或特别定制功能。 ```cpp virtual int setParameters(const char* parameters) = 0; ``` ### 详情 [#详情-15] 请[联系技术支持](https://ticket.shengwang.cn/)获取 JSON 配置方式。 ### 参数 [#参数-21] JSON 字符串形式的参数。 ### 返回值 [#返回值-25] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-27] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setParameters [2/2] [#setparameters-22] 通过 JSON 配置 SDK 提供技术预览或特别定制功能。 ```cpp virtual int setParameters(const char* parameters) = 0; ``` ### 详情 [#详情-16] 请[联系技术支持](https://ticket.shengwang.cn/)获取 JSON 配置方式。 ### 参数 [#参数-22] JSON 字符串形式的参数。 ### 返回值 [#返回值-26] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-28] - [IAgoraParameter](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_iagoraparameter) ## setRemoteSubscribeFallbackOption [#setremotesubscribefallbackoption] 设置弱网环境下订阅的音视频流回退选项。 ```cpp virtual int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; ``` ### 详情 [#详情-17] 网络不理想的环境下,实时通信音视频的质量会下降。你可以调用该方法并将 option 设置为 STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW 或 STREAM_FALLBACK_OPTION_AUDIO_ONLY,SDK 会在下行弱网且音视频质量严重受影响时,将视频流切换为小流或关闭视频流,从而保证音频质量。同时,SDK 会持续监控网络质量,并在网络质量改善时恢复订阅音视频流。 当订阅流回退为音频流或由音频流恢复为音视频流时,SDK 会触发 [onRemoteSubscribeFallbackToAudioOnly](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onremotesubscribefallbacktoaudioonly) 回调。 ### 参数 [#参数-23] 订阅流的回退选项。详见 [STREAM_FALLBACK_OPTIONS](/zh-CN/api-reference/rtc/unreal-cpp/enum-streamfallbackoptions)。 ### 返回值 [#返回值-27] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-29] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## startEchoTest [#startechotest] 开始音视频通话回路测试。 ```cpp virtual int startEchoTest(const EchoTestConfiguration& config) = 0; ``` 为测试用户本地发流、收流是否正常,你可以调用该方法进行音视频通话回路测试,即测试系统的音视频设备和用户的上下行网络是否正常。 开始测试后,用户需发出声音或面对摄像头,音频或视频会在约 2 秒后播放出来。如果音频播放正常,则表示系统音频设备和用户上下行网络均正常; 如果视频播放正常,则表示系统视频设备和用户上下行网络均正常。 ### 调用时机 [#调用时机-9] 该方法在加入频道前后均可调用。 ### 调用限制 [#调用限制-9] - 在频道内调用该方法时,需确保当前没有发布音视频流。 - 调用该方法后,必须调用 [stopEchoTest](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_stopechotest) 结束测试,否则该用户无法进行下一次音视频通话回路测试,也无法加入频道。 - 直播场景下,该方法仅能由主播调用。 ### 参数 [#参数-24] 音视频通话回路测试的配置。详见 [EchoTestConfiguration](/zh-CN/api-reference/rtc/unreal-cpp/class-echotestconfiguration)。 ### 返回值 [#返回值-28] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-30] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## startLastmileProbeTest [#startlastmileprobetest] 开始通话前网络质量探测。 ```cpp virtual int startLastmileProbeTest(const LastmileProbeConfig& config) = 0; ``` 开始通话前网络质量探测,向用户反馈上下行网络的带宽、丢包、网络抖动和往返时延数据。 ### 调用时机 [#调用时机-10] 该方法需要在加入频道前调用,且在收到 onLastmileQuality 和 onLastmileProbeResult 回调之前请不要调用其他方法,否则可能会由于 API 操作过于频繁导致此方法无法执行。 ### 调用限制 [#调用限制-10] 无。 ### 相关回调 [#相关回调] 成功调用该方法后,SDK 会依次触发如下 2 个回调: - [onLastmileQuality](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onlastmilequality),视网络情况约 2 秒内返回。该回调通过打分反馈上下行网络质量,更贴近用户的主观感受。 - [onLastmileProbeResult](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onlastmileproberesult),视网络情况约 30 秒内返回。该回调通过具体数据反馈上下行网络质量,更加客观。 ### 参数 [#参数-25] Last mile 网络探测配置,详见 [LastmileProbeConfig](/zh-CN/api-reference/rtc/unreal-cpp/class-lastmileprobeconfig)。 ### 返回值 [#返回值-29] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-31] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## stopEchoTest [#stopechotest] 停止语音通话回路测试。 ```cpp virtual int stopEchoTest() = 0; ``` 调用 [startEchoTest](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_startechotest3) 后,必须调用该方法结束测试,否则该用户无法进行下一次音视频通话回路测试,也无法加入频道。 ### 返回值 [#返回值-30] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -5(ERR_REFUSED): 停止测试失败,可能是测试不在运行中。 ### 所属接口类 [#所属接口类-32] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## stopLastmileProbeTest [#stoplastmileprobetest] 停止通话前网络质量探测。 ```cpp virtual int stopLastmileProbeTest() = 0; ``` ### 返回值 [#返回值-31] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-33] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## onConnectionBanned [#onconnectionbanned] 网络连接已被服务器禁止回调。 ```cpp virtual void onConnectionBanned() ``` ### 详情 [#详情-18] :::error[弃用:] 请改用 [onConnectionStateChanged](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onconnectionstatechanged)。 ::: ### 所属接口类 [#所属接口类-34] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onConnectionInterrupted [#onconnectioninterrupted] 网络连接中断回调。 ```cpp virtual void onConnectionInterrupted() {} ``` ### 详情 [#详情-19] :::error[弃用:] 请改用 [onConnectionStateChanged](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onconnectionstatechanged) 回调。 ::: SDK 在和服务器建立连接后,失去了网络连接超过 4 秒,会触发该回调。在触发事件后,SDK 会主动重连服务器,所以该事件可以用于 UI 提示。该回调与 [onConnectionLost](/zh-CN/api-reference/rtc/unreal-cpp/network#callback_irtcengineeventhandler_onconnectionlost) 的区别是: - onConnectionInterrupted 回调一定是发生在成功加入频道后,且 SDK 刚失去和服务器连接超过 4 秒时触发。 - onConnectionLost 回调是无论是否成功加入频道,只要 10 秒内和服务器无法建立连接都会触发。 如果 SDK 在断开连接后,20 分钟内还是没能重新加入频道,SDK 会停止尝试重连。 ### 所属接口类 [#所属接口类-35] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onConnectionLost [#onconnectionlost] 网络连接中断,且 SDK 无法在 10 秒内连接服务器回调。 ```cpp virtual void onConnectionLost() ``` ### 详情 [#详情-20] SDK 在调用 joinChannel [2/2] 后,无论是否加入成功,只要 10 秒和服务器无法连接就会触发该回调。如果 SDK 在断开连接后,20 分钟内还是没能重新加入频道,SDK 会停止尝试重连。 ### 所属接口类 [#所属接口类-36] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onConnectionStateChanged [#onconnectionstatechanged] 网络连接状态已改变回调。 ```cpp virtual void onConnectionStateChanged(CONNECTION_STATE_TYPE state, CONNECTION_CHANGED_REASON_TYPE reason) { (void)state; (void)reason; } ``` ### 详情 [#详情-21] 该回调在网络连接状态发生改变的时候触发,并告知用户当前的网络连接状态和引起网络状态改变的原因。 ### 参数 [#参数-26] 当前网络连接状态。详见 [CONNECTION_STATE_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-connectionstatetype)。 引起当前网络连接状态改变的原因。详见 [CONNECTION_CHANGED_REASON_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-connectionchangedreasontype)。 ### 所属接口类 [#所属接口类-37] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onEncryptionError [#onencryptionerror] 内置加密出错回调。 ```cpp virtual void onEncryptionError(ENCRYPTION_ERROR_TYPE errorType) { (void)errorType; } ``` ### 详情 [#详情-22] 调用 [enableEncryption](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_enableencryption) 开启加密后, 如果发流端、收流端出现加解密出错,SDK 会触发该回调。 ### 参数 [#参数-27] 错误类型,详见 [ENCRYPTION_ERROR_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-encryptionerrortype)。 ### 所属接口类 [#所属接口类-38] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onLastmileProbeResult [#onlastmileproberesult] 通话前网络上下行 Last mile 质量探测报告回调。 ```cpp virtual void onLastmileProbeResult(const LastmileProbeResult& result) { (void)result; } ``` ### 详情 [#详情-23] 在调用 [startLastmileProbeTest](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_startlastmileprobetest) 之后,SDK 会在约 30 秒内返回该回调。 ### 参数 [#参数-28] 上下行 Last mile 质量探测结果。详见 [LastmileProbeResult](/zh-CN/api-reference/rtc/unreal-cpp/class-lastmileproberesult)。 ### 所属接口类 [#所属接口类-39] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onLastmileQuality [#onlastmilequality] 网络上下行 last mile 质量报告回调。 ```cpp virtual void onLastmileQuality(int quality) { (void)quality; } ``` ### 详情 [#详情-24] 该回调描述本地用户在加入频道前的 last mile 网络探测的结果,其中 last mile 是指设备到声网边缘服务器的网络状态。 加入频道前,调用 [startLastmileProbeTest](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_startlastmileprobetest) 之后,SDK 触发该回调报告本地用户在加入频道前的 last mile 网络探测的结果。 ### 参数 [#参数-29] Last mile 网络质量。详见 [QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-qualitytype)。 ### 所属接口类 [#所属接口类-40] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onNetworkQuality [#onnetworkquality] 通话中每个用户的网络上下行 last mile 质量报告回调。 ```cpp virtual void onNetworkQuality(uid_t uid, int txQuality, int rxQuality) { (void)uid; (void)txQuality; (void)rxQuality; } ``` ### 详情 [#详情-25] 该回调描述每个用户在通话中的 last mile 网络状态,其中 last mile 是指设备到声网边缘服务器的网络状态。 该回调每 2 秒触发一次。如果远端有多个用户,该回调每 2 秒会被触发多次。 该回调通过频道内的广播包反馈网络质量。过多的广播包可能引发广播风暴。为防止广播风暴导致频道内大量数据传输,该回调默认支持同时反馈最多 4 个远端主播的网络质量。 :::note 注: 用户不发流时,txQuality 为 `UNKNOWN`;用户不收流时,rxQuality 为 `UNKNOWN`。 ::: ### 参数 [#参数-30] 用户 ID。表示该回调报告的是持有该 ID 的用户的网络质量。如果当 uid 为 0 时,返回的是本地用户的网络质量。 该用户的上行网络质量,基于发送码率、上行丢包率、平均往返时延和网络抖动计算。 该值代表当前的上行网络质量,帮助判断是否可以支持当前设置的视频编码属性。 假设上行码率是 1000 Kbps,那么支持直播场景下 640 × 480 的分辨率、15 fps 的帧率没有问题,但是支持 1280 × 720 的分辨率就会有困难。详见 [QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-qualitytype)。 该用户的下行网络质量,基于下行网络的丢包率、平均往返延时和网络抖动计算。详见 [QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-qualitytype)。 ### 所属接口类 [#所属接口类-41] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onNetworkTypeChanged [#onnetworktypechanged] 本地网络类型发生改变回调。 ```cpp virtual void onNetworkTypeChanged(NETWORK_TYPE type) { (void)type; } ``` ### 详情 [#详情-26] 本地网络连接类型发生改变时,SDK 会触发该回调,并在回调中明确当前的网络连接类型。你可以通过该回调获取正在使用的网络类型;当连接中断时,该回调能辨别引起中断的原因是网络切换还是网络条件不好。 ### 参数 [#参数-31] 本地网络连接类型。详见 [NETWORK_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-networktype)。 ### 所属接口类 [#所属接口类-42] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onPermissionError [#onpermissionerror] 获取设备权限出错回调。 ```cpp virtual void onPermissionError(PERMISSION_TYPE permissionType) { (void)permissionType; } ``` ### 详情 [#详情-27] 无法获取设备权限时,SDK 会触发该回调,报告哪个设备的权限无法获取。 ### 参数 [#参数-32] 设备权限类型。详见 [PERMISSION_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-permissiontype)。 ### 所属接口类 [#所属接口类-43] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onProxyConnected [#onproxyconnected] 代理连接状态回调。 ```cpp virtual void onProxyConnected(const char* channel, uid_t uid, PROXY_TYPE proxyType, const char* localProxyIp, int elapsed) { (void)channel; (void)uid; (void)proxyType; (void)localProxyIp; (void)elapsed; } ``` ### 详情 [#详情-28] 通过该回调你可以监听 SDK 连接代理的状态。例如,当用户调用 [setCloudProxy](/zh-CN/api-reference/rtc/unreal-cpp/network#api_irtcengine_setcloudproxy) 设置代理并成功加入频道后,SDK 会触发该回调报告用户 ID、连接的代理类型和从调用 [joinChannel [2/2]](/zh-CN/api-reference/rtc/unreal-cpp/channel#api_irtcengine_joinchannel2) 到触发该回调经过的时间等。 ### 参数 [#参数-33] 频道名称。 用户 ID 连接上的代理类型。详见 [PROXY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-proxytype)。 预留参数,暂不支持。 从调用 joinChannel [2/2] 到 SDK 触发该回调的经过的时间(毫秒)。 ### 所属接口类 [#所属接口类-44] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler) ## onReceiveAudioPacket [#onreceiveaudiopacket] 本地用户收到音频包回调。 ```cpp virtual bool onReceiveAudioPacket(Packet& packet) = 0; ``` ### 参数 [#参数-34] 收到的音频包,详见 [Packet](/zh-CN/api-reference/rtc/unreal-cpp/class-packet) 。 ### 返回值 [#返回值-32] - `true`: 成功接收音频包。 - `false`: 丢弃音频包。 ### 所属接口类 [#所属接口类-45] - [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) ## onReceiveVideoPacket [#onreceivevideopacket] 本地用户收到视频包回调。 ```cpp virtual bool onReceiveVideoPacket(Packet& packet) = 0; ``` ### 参数 [#参数-35] 收到的视频包,详见 [Packet](/zh-CN/api-reference/rtc/unreal-cpp/class-packet) 。 ### 返回值 [#返回值-33] - `true`: 成功接收视频包。 - `false`: 丢弃视频包。 ### 所属接口类 [#所属接口类-46] - [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) ## onSendAudioPacket [#onsendaudiopacket] 已发送音频包回调。 ```cpp virtual bool onSendAudioPacket(Packet& packet) = 0; ``` ### 参数 [#参数-36] 发送的音频包,详见 [Packet](/zh-CN/api-reference/rtc/unreal-cpp/class-packet) 。 ### 返回值 [#返回值-34] - `true`: 成功发送音频包。 - `false`: 丢弃音频包。 ### 所属接口类 [#所属接口类-47] - [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) ## onSendVideoPacket [#onsendvideopacket] 已发送视频包回调。 ```cpp virtual bool onSendVideoPacket(Packet& packet) = 0; ``` ### 参数 [#参数-37] 发送的视频包,详见 [Packet](/zh-CN/api-reference/rtc/unreal-cpp/class-packet) 。 ### 返回值 [#返回值-35] - `true`: 成功发送视频包; - `false`: 丢弃视频包。 ### 所属接口类 [#所属接口类-48] - [IPacketObserver](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_ipacketobserver) ## onUplinkNetworkInfoUpdated [#onuplinknetworkinfoupdated] 上行网络信息变化回调。 ```cpp virtual void onUplinkNetworkInfoUpdated(const UplinkNetworkInfo& info) { (void)info; } ``` ### 详情 [#详情-29] 只有当上行网络信息发生变化时,SDK 才会触发该回调。 :::caution 注意: 该回调仅适用于向 SDK 推送 H.264 格式的外部编码视频数据的场景。 ::: ### 参数 [#参数-38] 上行网络信息,详见 [UplinkNetworkInfo](/zh-CN/api-reference/rtc/unreal-cpp/class-uplinknetworkinfo)。 ### 所属接口类 [#所属接口类-49] - [IRtcEngineEventHandler](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineeventhandler)