# 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: 方法调用失败。