# agora::rtc::ILocalUser类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 详细描述 [#详细描述] [`ILocalUser`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user) 类。 定义了本地用户的行为和状态。 每个 RTC 连接都有自己的用户。你可以通过 [IRtcConnection::getLocalUser](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection#a1cf54986a330713047da51c1503ec86c) 获取本地 user。 每个用户有两种角色: 主播 (能发送和接收音视频流) 和 观众 (只能接收音视频流)。 ## 构造及析构函数说明 [#构造及析构函数说明] ### ~ILocalUser() [#ilocaluser] virtual agora::rtc::ILocalUser::~ILocalUser() ## 成员函数说明 [#成员函数说明] ### setUserRole() [#setuserrole] virtual void agora::rtc::ILocalUser::setUserRole([rtc::CLIENT_ROLE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a42f167813e36b5c11a8a1c659b877080) *role*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置用户角色。 你可以在用户连接频道前或连接频道后调用该方法。 [onChangeRoleSuccess](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection-observer#a25f2c3352be19aef2e56b4a6e78f3e2a) 回调和 [onChangeRoleFailure](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection-observer#aeaeead0ee0314b89e3bd5158c4d41648) 回调会报告该方法的结果。 :::info[注解] 如果 [connect](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection#a035389095b76329b60b539ca43f24f17) 中的 `token` 与 `role` 参数设置的角色不同,连接会失败,SDK 会返回 [onConnectionFailure](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection-observer#a33d46c9db2a0cbff4a24aa790a69eec3) 回调。 ::: 用户角色 [CLIENT_ROLE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a42f167813e36b5c11a8a1c659b877080) 。 用于 SDK 的生命周期保护,填写默认值即可。 ### getUserRole() [#getuserrole] virtual [CLIENT_ROLE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a42f167813e36b5c11a8a1c659b877080) agora::rtc::ILocalUser::getUserRole() 获取用户角色。

返回值

用户角色: [CLIENT_ROLE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a42f167813e36b5c11a8a1c659b877080) 。 ### setAudioEncoderConfiguration() [#setaudioencoderconfiguration] virtual int agora::rtc::ILocalUser::setAudioEncoderConfiguration(const [rtc::AudioEncoderConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-audio-encoder-configuration) & *config*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置音频编码。 SDK 会将配置应用于全部发送的音频轨道。 音频编码配置:AgoraEncoderConfiguration。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### publishAudio() [#publishaudio] virtual int agora::rtc::ILocalUser::publishAudio([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) > *audioTrack*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 将本地音频轨道发送到频道。 默认情况下,所有发布的音频轨道都会进行混音。 需要发布的本地音频轨道。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 - -5(ERR_REFUSED):如果本地用户的角色不是主播,会返回此错误。 ### unpublishAudio() [#unpublishaudio] virtual int agora::rtc::ILocalUser::unpublishAudio([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) > *audioTrack*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止将本地音频轨道发送到频道。 需要停止发布的本地音频轨道。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### publishVideo() [#publishvideo] virtual int agora::rtc::ILocalUser::publishVideo([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 将本地视频轨道发送到频道。 需要发布的本地视频轨道。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unpublishVideo() [#unpublishvideo] virtual int agora::rtc::ILocalUser::unpublishVideo([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止将本地视频轨道发送到频道。 需要停止发布的本地视频轨道。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### subscribeAudio() [#subscribeaudio] virtual int agora::rtc::ILocalUser::subscribeAudio([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 订阅频道中特定的远端用户发送的音频流。 远端用户的 ID。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 - -2(ERR_INVALID_ARGUMENT):如果用户不存在或 userId 无效时会返回该错误。 ### subscribeAllAudio() [#subscribeallaudio] virtual int agora::rtc::ILocalUser::subscribeAllAudio(aosl_ref_t *ares* = `AOSL_REF_INVALID`) 订阅频道中全部远端用户发送的音频流。 该方法会自动订阅频道中后续加入的用户发送的音频流。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unsubscribeAudio() [#unsubscribeaudio] virtual int agora::rtc::ILocalUser::unsubscribeAudio([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止订阅频道中特定的远端用户发送的音频流。 远端用户的 ID。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 - -2(ERR_INVALID_ARGUMENT):如果用户不存在或 userId 无效时会返回该错误。 ### unsubscribeAllAudio() [#unsubscribeallaudio] virtual int agora::rtc::ILocalUser::unsubscribeAllAudio(aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止订阅频道中全部远端用户发送的音频流。 该方法会自动取消订阅频道中后续加入的用户发送的音频流。你必须调用 [subscribeAudio](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user#aa62220796c34b2f809cb07c615a898f0) 或 [subscribeAllAudio](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user#a894d4efd0746016c8e190cee839a798d) 才能恢复订阅音频。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setPlaybackAudioFrameParameters() [#setplaybackaudioframeparameters] virtual int agora::rtc::ILocalUser::setPlaybackAudioFrameParameters(size_t *numberOfChannels*, uint32_t *sampleRateHz*, [RAW_AUDIO_FRAME_OP_MODE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bb) *mode* = [`RAW_AUDIO_FRAME_OP_MODE_READ_ONLY`](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bbac46b5a2a6a1bcf560cdd0cad3c888d52), int *samplesPerCall* = `0`, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置播放的音频格式。 该方法设置 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a9956d1aa3b4e18089ef02ee3d782d667) 回调数据的格式。 音频数据声道数,可设置为 1(单声道) 或 2(双声道)。 `onPlaybackAudioFrame` 中返回数据的采样率,可设置为 8000、 16000、 32000、44100 或 48000。 音频帧的使用模式,详见: [RAW_AUDIO_FRAME_OP_MODE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bb) 。 `onPlaybackAudioFrame` 中返回数据的采样点数,如直推 CDN 应用中通常为 1024。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setRecordingAudioFrameParameters() [#setrecordingaudioframeparameters] virtual int agora::rtc::ILocalUser::setRecordingAudioFrameParameters(size_t *numberOfChannels*, uint32_t *sampleRateHz*, [RAW_AUDIO_FRAME_OP_MODE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bb) *mode* = [`RAW_AUDIO_FRAME_OP_MODE_READ_ONLY`](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bbac46b5a2a6a1bcf560cdd0cad3c888d52), int *samplesPerCall* = `0`, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置采集的原始音频数据格式。 该方法设置 [IAudioFrameObserverBase::onRecordAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a607f7a30a058bf7fe2b7ec2492fe9610) 回调的采集音频格式。 音频数据声道数,可设置为 1(单声道) 或 2(双声道)。 `onRecordAudioFrame` 中返回数据的采样率,可设置为 8000、 16000、 32000、44100 或 48000。 音频帧的使用模式,详见 [RAW_AUDIO_FRAME_OP_MODE_TYPE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae5df06fc9c5b15135e22047c01e565bb) 。 `onRecordAudioFrame` 中返回数据的采样点数。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setMixedAudioFrameParameters() [#setmixedaudioframeparameters] virtual int agora::rtc::ILocalUser::setMixedAudioFrameParameters(size_t *numberOfChannels*, uint32_t *sampleRateHz*, int *samplesPerCall* = `0`, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置 [onMixedAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a6b3f76a4245bf27b6a7c5cbc44f1c1dd) 报告的音频数据格式。 音频数据声道数,可设置为 1(单声道) 或 2(双声道)。 音频数据采样率 (Hz),可设置为 8000、 16000、32000、 44100 或 48000。 指定 `onMixedAudioFrame` 中返回数据的采样点数,如 RTMP/RTMPS 推流应用中通常为 1024。 :::info[注解] SDK 会根据该方法设置的采样间隔(秒)定期触发 `onMixedAudioFrame` 回调。 采样间隔 = samplesPerCall/(sampleRate x channel)。请确保你的取值能满足采样间隔大于或等于 0.01 秒。 ::: 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### setPlaybackAudioFrameBeforeMixingParameters() [#setplaybackaudioframebeforemixingparameters] virtual int agora::rtc::ILocalUser::setPlaybackAudioFrameBeforeMixingParameters(size_t *numberOfChannels*, uint32_t *sampleRateHz*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 设置 [onPlaybackAudioFrameBeforeMixing](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer#a12ad526eb7356640f67137f2cdb6c128) 报告的音频数据格式。 音频数据声道数,可设置为 1(单声道) 或 2(双声道)。 音频数据采样率 (Hz),可设置为 8000、 16000、32000、 44100 或 48000。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### registerAudioFrameObserver() [#registeraudioframeobserver] virtual int agora::rtc::ILocalUser::registerAudioFrameObserver(agora::media::IAudioFrameObserverBase * *observer*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 注册音频帧 observer。 你必须实现 [`IAudioFrameObserverBase`](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base) 类并根据需求注册以下回调: - [onRecordAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a607f7a30a058bf7fe2b7ec2492fe9610) - [onPlaybackAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a9956d1aa3b4e18089ef02ee3d782d667) - [onPlaybackAudioFrameBeforeMixing](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a045b317352faf9d64a97b0274a5529ec) - [onMixedAudioFrame](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base#a6b3f76a4245bf27b6a7c5cbc44f1c1dd) 音频帧 observer的指针: IAudioFrameObserverBase。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unregisterAudioFrameObserver() [#unregisteraudioframeobserver] virtual int agora::rtc::ILocalUser::unregisterAudioFrameObserver(agora::media::IAudioFrameObserverBase * *observer*) 销毁音频帧 observer。 音频帧 observer的指针: [IAudioFrameObserverBase](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-audio-frame-observer-base)。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### registerVideoEncodedFrameObserver() [#registervideoencodedframeobserver] virtual int agora::rtc::ILocalUser::registerVideoEncodedFrameObserver(agora::media::IVideoEncodedFrameObserver * *observer*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 为编码后的视频图像注册视频帧接收 observer。 视频帧接收 observer,详见 [IVideoEncodedFrameObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-video-encoded-frame-observer)。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unregisterVideoEncodedFrameObserver() [#unregistervideoencodedframeobserver] virtual int agora::rtc::ILocalUser::unregisterVideoEncodedFrameObserver(agora::media::IVideoEncodedFrameObserver * *observer*) 销毁视频帧接收 observer。 视频帧接收 observer,详见 [IVideoEncodedFrameObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/class-i-video-encoded-frame-observer)。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### registerVideoFrameObserver() [#registervideoframeobserver] virtual int agora::rtc::ILocalUser::registerVideoFrameObserver([IVideoFrameObserver2](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) * *observer*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 注册 [IVideoFrameObserver2](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) 对象。 [`IVideoFrameObserver2`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) 对象的指针。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unregisterVideoFrameObserver() [#unregistervideoframeobserver] virtual int agora::rtc::ILocalUser::unregisterVideoFrameObserver([IVideoFrameObserver2](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) * *observer*) 销毁 [IVideoFrameObserver2](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) 对象。 [`IVideoFrameObserver2`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-video-frame-observer2) 对象的指针。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### subscribeVideo() [#subscribevideo] virtual int agora::rtc::ILocalUser::subscribeVideo([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, const [VideoSubscriptionOptions](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-subscription-options) & *subscriptionOptions*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 订阅频道中指定远端用户发送的视频流。 用户 ID。 订阅选项: [VideoSubscriptionOptions](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-subscription-options) 。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 - -2(ERR_INVALID_ARGUMENT):如果用户不存在或 userId 无效时会返回该错误。 ### subscribeAllVideo() [#subscribeallvideo] virtual int agora::rtc::ILocalUser::subscribeAllVideo(const [VideoSubscriptionOptions](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-subscription-options) & *subscriptionOptions*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 订阅频道中全部远端用户发送的视频流。 该方法会自动订阅频道中后续加入的用户发送的视频流。 订阅选项: [VideoSubscriptionOptions](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-subscription-options) 。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unsubscribeVideo() [#unsubscribevideo] virtual int agora::rtc::ILocalUser::unsubscribeVideo([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止订阅频道中指定远端用户发送的视频流。 用户 ID。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 - -2(ERR_INVALID_ARGUMENT):如果用户不存在或 userId 无效时会返回该错误。 ### unsubscribeAllVideo() [#unsubscribeallvideo] virtual int agora::rtc::ILocalUser::unsubscribeAllVideo(aosl_ref_t *ares* = `AOSL_REF_INVALID`) 停止订阅频道中全部远端用户发送的视频流。 该方法会自动取消订阅频道中后续加入的用户发送的音频流。你必须调用 [subscribeVideo](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user#a9c8a3fcf49db6800e3b7ce955126c45d) 或 [subscribeAllVideo](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user#a77ee018bedf45f21aa198d697c3774a4) 才能恢复订阅。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### registerLocalUserObserver() [#registerlocaluserobserver] virtual int agora::rtc::ILocalUser::registerLocalUserObserver([ILocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) * *observer*, void(*)([ILocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) *) *safeDeleter* = `NULL`, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 注册本地用户 observer。 本地用户 observer 对象: [ILocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) 。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。 ### unregisterLocalUserObserver() [#unregisterlocaluserobserver] virtual int agora::rtc::ILocalUser::unregisterLocalUserObserver([ILocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) * *observer*) 销毁本地用户 observer。 本地用户 observer 对象: [ILocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) 。

返回值

- 0: Success. - < 0: Failure. ### sendIntraRequest() [#sendintrarequest] virtual int agora::rtc::ILocalUser::sendIntraRequest([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, aosl_ref_t *ares* = `AOSL_REF_INVALID`) 向指定主播用户发送关键帧请求。 你成功发送请求后,主播会收到 [onIntraRequestReceived](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#abe52ed35277c6c6efc50125b05895859) 回调。 主播的用户 ID。 用于 SDK 的生命周期保护,填写默认值即可。

返回值

- 0: 方法调用成功。 - < 0: 方法调用失败。