# agora::rtc::ILocalUserObserver类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 详细描述 [#详细描述] [`ILocalUserObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer) 类。 ## 成员枚举类型说明 [#成员枚举类型说明] ### USER_MEDIA_INFO [#user_media_info] enum [agora::rtc::ILocalUserObserver::USER_MEDIA_INFO](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#aebf5fda0b9fa8f8921fab72a2bf6556a) 用户媒体信息。 枚举值 USER_MEDIA_INFO_MUTE_AUDIO 0: 用户已经停止发布音频流。 USER_MEDIA_INFO_MUTE_VIDEO 1: 用户已经停止发布视频流。 USER_MEDIA_INFO_ENABLE_VIDEO 4: 用户已开启视频功能。 ### REMOTE_USER_STATE [#remote_user_state] enum [agora::rtc::ILocalUserObserver::REMOTE_USER_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#ac8c847858dc6423a9d4de641b9d5c00b) 远端用户状态信息。 枚举值 PEER_STATE_MUTE_AUDIO 1:远端用户已经停止发布音频。 PEER_STATE_MUTE_VIDEO 2:远端用户已经停止发布视频。 PEER_STATE_ENABLE_VIDEO 3:远端用户已经开启视频。 PEER_STATE_ENABLE_LOCAL_VIDEO 4:远端用户已经开启视频采集。 ## 构造及析构函数说明 [#构造及析构函数说明] ### ~ILocalUserObserver() [#ilocaluserobserver] virtual agora::rtc::ILocalUserObserver::~ILocalUserObserver() ## 成员函数说明 [#成员函数说明] ### onAudioTrackPublishSuccess() [#onaudiotrackpublishsuccess] virtual void agora::rtc::ILocalUserObserver::onAudioTrackPublishSuccess([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*) 在第一个本地音频包发送时触发,表明本地音频轨道已成功发布。 [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) 对象。 ### onLocalAudioTrackStateChanged() [#onlocalaudiotrackstatechanged] virtual void agora::rtc::ILocalUserObserver::onLocalAudioTrackStateChanged([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) > *audioTrack*, [LOCAL_AUDIO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a19311f858629420654fcc0da9d043332) *state*, [LOCAL_AUDIO_STREAM_ERROR](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a3929991eea3a522dcbf6ac078810045e) *errorCode*) 在本地音频轨道状态变化时触发。 [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) 对象。 音频轨道的状态:[LOCAL_AUDIO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a19311f858629420654fcc0da9d043332)。 错误信息: [LOCAL_AUDIO_STREAM_ERROR](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a3929991eea3a522dcbf6ac078810045e)。 ### onLocalAudioTrackStatistics() [#onlocalaudiotrackstatistics] virtual void agora::rtc::ILocalUserObserver::onLocalAudioTrackStatistics(const [LocalAudioStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-audio-stats) & *stats*) 报告本地音频轨道状态。 本地音频轨道状态:[LocalAudioStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-audio-stats)。 ### onRemoteAudioTrackStatistics() [#onremoteaudiotrackstatistics] virtual void agora::rtc::ILocalUserObserver::onRemoteAudioTrackStatistics([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track) > *audioTrack*, const [RemoteAudioTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-remote-audio-track-stats) & *stats*) 报告远端音频轨道状态。 远端音频轨道:[IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track)。 远端音频轨道统计信息:[RemoteAudioTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-remote-audio-track-stats)。 ### onUserAudioTrackSubscribed() [#onuseraudiotracksubscribed] virtual void agora::rtc::ILocalUserObserver::onUserAudioTrackSubscribed([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track) > *audioTrack*) 成功订阅远端用户发送的音频流时触发。 发送音频帧的远端用户 ID。 远端音频轨道:[IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track)。 ### onUserAudioTrackStateChanged() [#onuseraudiotrackstatechanged] virtual void agora::rtc::ILocalUserObserver::onUserAudioTrackStateChanged([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track) > *audioTrack*, [REMOTE_AUDIO_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#aa83ef274510d1063e840d6104fd12516) *state*, [REMOTE_AUDIO_STATE_REASON](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a532f4584f6ed5962012e1f08bef6f0fc) *reason*, int *elapsed*) 在远端音频轨道状态变化时触发。 远端用户 ID。 远端音频轨道:[IRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-audio-track)。 音频轨道的当前状态:[REMOTE_AUDIO_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#aa83ef274510d1063e840d6104fd12516)。 状态改变原因:[REMOTE_AUDIO_STATE_REASON](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a532f4584f6ed5962012e1f08bef6f0fc)。 远端用户连接频道之后经过的时间(毫秒)。 ### onVideoTrackPublishSuccess() [#onvideotrackpublishsuccess] virtual void agora::rtc::ILocalUserObserver::onVideoTrackPublishSuccess([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*) 在第一个本地视频包发送时触发,表明本地音视频轨道已成功发布。 本地视频轨道: [ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track)。 ### onLocalVideoTrackStateChanged() [#onlocalvideotrackstatechanged] virtual void agora::rtc::ILocalUserObserver::onLocalVideoTrackStateChanged([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*, [LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b) *state*, [LOCAL_VIDEO_STREAM_ERROR](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#aca8292c30c50a78f6fbd1ef1b264d842) *errorCode*) 本地视频轨道状态改变时触发。 :::info[注解] 如果该回调返回错误码,声网建议你通过 `setEnabled` 方法关闭轨道再重新开启。 ::: 本地视频轨道:[ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track)。 本地视频轨道状态:[LOCAL_VIDEO_STREAM_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a7c8ce313cb6ccb0d186953bd06e6200b)。 错误信息:[LOCAL_VIDEO_STREAM_ERROR](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#aca8292c30c50a78f6fbd1ef1b264d842)。 ### onLocalVideoTrackStatistics() [#onlocalvideotrackstatistics] virtual void agora::rtc::ILocalUserObserver::onLocalVideoTrackStatistics([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*, const [LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-video-track-stats) & *stats*) 报告本地视频轨道的统计信息。 本地视频轨道。 本地视频轨道的统计信息:[LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-local-video-track-stats)。 ### onUserVideoTrackSubscribed() [#onuservideotracksubscribed] virtual void agora::rtc::ILocalUserObserver::onUserVideoTrackSubscribed([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [VideoTrackInfo](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-video-track-info) *trackInfo*, [agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-video-track) > *videoTrack*) 成功订阅远端用户发送的视频流时触发。 发送视频帧的远端用户 ID。 视频轨道信息。 远端视频轨道。 ### onUserVideoTrackStateChanged() [#onuservideotrackstatechanged] virtual void agora::rtc::ILocalUserObserver::onUserVideoTrackStateChanged([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-video-track) > *videoTrack*, [REMOTE_VIDEO_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a8098bde3bb614a7716d0f39105b8f1d8) *state*, [REMOTE_VIDEO_STATE_REASON](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae31fce5548860cb0a62e4c232fb18bff) *reason*, int *elapsed*) 在远端视频轨道状态变更时触发。 远端用户 ID。 远端视频轨道。 当前视频帧状态:[REMOTE_VIDEO_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a8098bde3bb614a7716d0f39105b8f1d8)。 状态改变原因:[REMOTE_VIDEO_STATE_REASON](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ae31fce5548860cb0a62e4c232fb18bff)。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteVideoFrameRendered() [#onfirstremotevideoframerendered] virtual void agora::rtc::ILocalUserObserver::onFirstRemoteVideoFrameRendered([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, int *width*, int *height*, int *elapsed*) 在第一个远端发送的视频帧渲染时触发。 远端用户 ID。 视频帧宽度(像素)。 视频帧高度(像素)。 远端用户连接频道之后经过的时间(毫秒)。 ### onRemoteVideoTrackStatistics() [#onremotevideotrackstatistics] virtual void agora::rtc::ILocalUserObserver::onRemoteVideoTrackStatistics([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::IRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-video-track) > *videoTrack*, const [RemoteVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-remote-video-track-stats) & *stats*) 报告远端视频轨道的统计信息。 远端视频轨道:[IRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-remote-video-track) 。 远端视频轨道统计信息:[RemoteVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-remote-video-track-stats) 。 ### onAudioSubscribeStateChanged() [#onaudiosubscribestatechanged] virtual void agora::rtc::ILocalUserObserver::onAudioSubscribeStateChanged(const char * *channel*, [user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) *oldState*, [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) *newState*, int *elapseSinceLastState*) 对远端用户音频订阅状态变更时触发。 用户所在频道的频道名。 订阅的远端用户的 ID。 之前的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 新的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 变更为新状态之后的时长(毫秒)。 ### onVideoSubscribeStateChanged() [#onvideosubscribestatechanged] virtual void agora::rtc::ILocalUserObserver::onVideoSubscribeStateChanged(const char * *channel*, [user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) *oldState*, [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) *newState*, int *elapseSinceLastState*) 对远端用户视频订阅状态变更时触发。 用户所在频道的频道名。 订阅的远端用户的 ID。 之前的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 新的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 变更为新状态之后的时长(毫秒)。 ### onAudioPublishStateChanged() [#onaudiopublishstatechanged] virtual void agora::rtc::ILocalUserObserver::onAudioPublishStateChanged(const char * *channel*, [STREAM_PUBLISH_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a58eeb8b495ca1c91d38785f064132537) *oldState*, [STREAM_PUBLISH_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a58eeb8b495ca1c91d38785f064132537) *newState*, int *elapseSinceLastState*) 音频发布状态变更后触发。 用户所在频道的频道名。 之前的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 新的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 变更为新状态之后的时长(毫秒)。 ### onVideoPublishStateChanged() [#onvideopublishstatechanged] virtual void agora::rtc::ILocalUserObserver::onVideoPublishStateChanged(const char * *channel*, [STREAM_PUBLISH_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a58eeb8b495ca1c91d38785f064132537) *oldState*, [STREAM_PUBLISH_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#a58eeb8b495ca1c91d38785f064132537) *newState*, int *elapseSinceLastState*) 视频发布状态变更后触发。 用户所在频道的频道名。 之前的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 新的订阅状态: [STREAM_SUBSCRIBE_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora-1-1rtc#ac405a073458682fd6464c82d49fece3c) 。 变更为新状态之后的时长(毫秒)。 ### onFirstRemoteAudioFrame() [#onfirstremoteaudioframe] virtual void agora::rtc::ILocalUserObserver::onFirstRemoteAudioFrame([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, int *elapsed*) 接收到远端用户发送的第一个音频帧时触发。 远端用户的 ID。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteAudioDecoded() [#onfirstremoteaudiodecoded] virtual void agora::rtc::ILocalUserObserver::onFirstRemoteAudioDecoded([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, int *elapsed*) 在 SDK 解码第一个收到的远端音频帧时触发。 发送音频帧的用户 user ID。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteVideoDecoded() [#onfirstremotevideodecoded] virtual void agora::rtc::ILocalUserObserver::onFirstRemoteVideoDecoded([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, int *width*, int *height*, int *elapsed*) 在 SDK 解码第一个视频帧时触发。 发送视频帧的用户 user ID。 视频帧的宽度(像素)。 视频帧的高度(像素)。 远端用户连接频道之后经过的时间(毫秒)。 ### onUserInfoUpdated() [#onuserinfoupdated] virtual void agora::rtc::ILocalUserObserver::onUserInfoUpdated([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, [USER_MEDIA_INFO](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#aebf5fda0b9fa8f8921fab72a2bf6556a) *msg*, bool *val*) 用户媒体信息更新时触发。 用户 ID。 用户媒体信息。详见 [USER_MEDIA_INFO](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#aebf5fda0b9fa8f8921fab72a2bf6556a) 。 用户是否停止发流。 ### onIntraRequestReceived() [#onintrarequestreceived] virtual void agora::rtc::ILocalUserObserver::onIntraRequestReceived() 本地用户收到来自远端用户的关键帧请求时触发。 该回调提醒本地用户编码关键帧。 ### onStreamMessage() [#onstreammessage] virtual void agora::rtc::ILocalUserObserver::onStreamMessage([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, int *streamId*, const char * *data*, size_t *length*) 接收到数据流消息的回调。 该回调表示本地用户收到了远端用户调用 [sendStreamMessage](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtc-connection#a2545d46a802312553e260e1acb45b721) 方法发送的流消息。 发送消息的用户 ID。 接收到的消息的 Stream ID。 接收到的数据。 数据长度,单位为字节。 ### onUserStateChanged() [#onuserstatechanged] virtual void agora::rtc::ILocalUserObserver::onUserStateChanged([user_id_t](/zh-CN/api-reference/rtc-server-sdk/cpp/namespaceagora#a67aa7eac4d2b30c5c02951f1303bcc48) *userId*, uint32_t *state*) 远端用户状态更新时触发。 远端用户 ID。 远端用户状态: [REMOTE_USER_STATE](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-user-observer#ac8c847858dc6423a9d4de641b9d5c00b) 。