# io.agora.rtc.ILocalUserObserver接口 参考 (/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-local-user-observer) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ILocalUserObserver 接口。 ## 成员函数说明 [#成员函数说明] ### onAudioMetaDataReceived() [#onaudiometadatareceived] void io.agora.rtc.ILocalUserObserver.onAudioMetaDataReceived([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agoraLocalUser*, String *userId*, byte[] *metaData*) 接收到对方音频 Metadata 数据的回调。该回调表示本地用户收到了远端用户调用 [sendAudioMetaData](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user#a10bb7ca5b7d12999f0e3f4bb6b3e9d61) 方法发送的音频 Metadata 数据。 一个 AgoraLocalUser 对象。 发送音频 Metadata 数据的用户 ID。 音频 Metadata 数据。 ### onAudioPublishStateChanged() [#onaudiopublishstatechanged] void io.agora.rtc.ILocalUserObserver.onAudioPublishStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *channel*, int *old_state*, int *new_state*, int *elapse_since_last_state*) 音频发布状态变更后触发。 一个 AgoraLocalUser 对象。 用户所在频道的频道名。 之前的发布状态: - 0:加入频道后的初始发布状态。 - 1:发布失败。 - 2:正在发布。 - 3:发布成功。 新的发布状态: - 0:加入频道后的初始发布状态。 - 1:发布失败。 - 2:正在发布。 - 3:发布成功。 变更为新状态之后的时长(毫秒)。 ### onAudioSubscribeStateChanged() [#onaudiosubscribestatechanged] void io.agora.rtc.ILocalUserObserver.onAudioSubscribeStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *channel*, String *user_id*, int *old_state*, int *new_state*, int *elapse_since_last_state*) 对远端用户音频订阅状态变更时触发。 一个 AgoraLocalUser 对象。 用户所在频道的频道名。 订阅的远端用户的 ID。 之前的订阅状态: - 0:加入频道后的初始订阅状态。 - 1:订阅失败。 - 2:正在订阅。 - 3:收到了远端流,订阅成功。 新的订阅状态: - 0:加入频道后的初始订阅状态。 - 1:订阅失败。 - 2:正在订阅。 - 3:收到了远端流,订阅成功。 变更为新状态之后的时长(毫秒)。 ### onAudioTrackPublishSuccess() [#onaudiotrackpublishsuccess] void io.agora.rtc.ILocalUserObserver.onAudioTrackPublishSuccess([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraLocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track) *agora_local_audio_track*) 在第一个本地音频包发送时触发,表明本地音频轨道已成功发布。 一个 AgoraLocalUser 对象。 一个 AgoraLocalAudioTrack 对象。 ### onFirstRemoteAudioDecoded() [#onfirstremoteaudiodecoded] void io.agora.rtc.ILocalUserObserver.onFirstRemoteAudioDecoded([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *elapsed*) 在 SDK 解码第一个收到的远端音频帧时触发。 一个 AgoraLocalUser 对象。 远端用户的 ID。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteAudioFrame() [#onfirstremoteaudioframe] void io.agora.rtc.ILocalUserObserver.onFirstRemoteAudioFrame([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *elapsed*) 接收到远端用户发送的第一个音频帧时触发。 一个 AgoraLocalUser 对象。 远端用户的 ID。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteVideoDecoded() [#onfirstremotevideodecoded] void io.agora.rtc.ILocalUserObserver.onFirstRemoteVideoDecoded([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *width*, int *height*, int *elapsed*) 在 SDK 解码第一个视频帧时触发。 一个 AgoraLocalUser 对象。 远端用户 ID。 视频帧宽度(像素)。 视频帧高度(像素)。 远端用户连接频道之后经过的时间(毫秒)。 ### onFirstRemoteVideoFrame() [#onfirstremotevideoframe] void io.agora.rtc.ILocalUserObserver.onFirstRemoteVideoFrame([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *width*, int *height*, int *elapsed*) 在第一个远端发送的视频帧渲染时触发。 当用户的视频窗口显示第一个远端发送的视频帧时,SDK 会触发该回调。App 可以获取从用户加入频道到第一个视频帧渲染出来的时间。 一个 AgoraLocalUser 对象。 远端用户 ID。 视频帧宽度(像素)。 视频帧高度(像素)。 远端用户连接频道之后经过的时间(毫秒)。 ### onIntraRequestReceived() [#onintrarequestreceived] void io.agora.rtc.ILocalUserObserver.onIntraRequestReceived([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*) 本地用户收到来自远端用户的关键帧请求时触发。该回调提醒本地用户编码关键帧。 一个 AgoraLocalUser 对象。 ### onLocalAudioTrackStateChanged() [#onlocalaudiotrackstatechanged] void io.agora.rtc.ILocalUserObserver.onLocalAudioTrackStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraLocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-audio-track) *agora_local_audio_track*, int *state*, int *error*) 在本地音频轨道状态变化时触发。 一个 AgoraLocalUser 对象。 一个 ILocalAudioTrack对象。 本地音频轨道状态: - 0:本地音频位于初始状态。 - 1:音频录制设备成功启动。 - 2:第一个音频帧成功完成编码。 - 3:本地音频启动失败。 本地音频失败的原因: - 0:本地音频状态正常。 - 1:原因未知。 - 2:没有权限使用本地音频设备。 - 3:麦克风被占用。 - 4:本地音频录制失败。检查录制设备是否正常工作。 - 5:本地音频编码失败。 ### onLocalAudioTrackStatistics() [#onlocalaudiotrackstatistics] void io.agora.rtc.ILocalUserObserver.onLocalAudioTrackStatistics([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [LocalAudioStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-local-audio-stats) *stats*) 报告本地用户的音频统计信息。 一个 AgoraLocalUser 对象。 本地用户的音频统计信息。 ### onLocalVideoTrackStateChanged() [#onlocalvideotrackstatechanged] void io.agora.rtc.ILocalUserObserver.onLocalVideoTrackStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraLocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-video-track) *agora_local_video_track*, int *state*, int *error*) ### onLocalVideoTrackStatistics() [#onlocalvideotrackstatistics] void io.agora.rtc.ILocalUserObserver.onLocalVideoTrackStatistics([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraLocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-video-track) *agora_local_video_track*, [LocalVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-local-video-track-stats) *stats*) 报告本地视频轨道的统计信息。 一个 AgoraLocalUser 对象。 一个 AgoraLocalVideoTrack 对象。 本地视频轨道的统计信息。 ### onRemoteAudioTrackStatistics() [#onremoteaudiotrackstatistics] void io.agora.rtc.ILocalUserObserver.onRemoteAudioTrackStatistics([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-audio-track) *agora_remote_audio_track*, [RemoteAudioTrackStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-remote-audio-track-stats) *stats*) 报告远端用户的音频统计信息。 一个 AgoraLocalUser 对象。 一个 IRemoteAudioTrack 对象。 远端用户的音频统计信息。 ### onRemoteSubscribeFallbackToAudioOnly() [#onremotesubscribefallbacktoaudioonly] void io.agora.rtc.ILocalUserObserver.onRemoteSubscribeFallbackToAudioOnly([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *is_fallback_or_recover*) ### onRemoteVideoTrackStatistics() [#onremotevideotrackstatistics] void io.agora.rtc.ILocalUserObserver.onRemoteVideoTrackStatistics([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-video-track) *agora_remote_video_track*, [RemoteVideoTrackStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-remote-video-track-stats) *stats*) 报告远端视频轨道的统计信息。 一个 AgoraLocalUser 对象。 一个 AgoraRemoteVideoTrack 对象。 远端视频轨道统计信息。 ### onStreamMessage() [#onstreammessage] void io.agora.rtc.ILocalUserObserver.onStreamMessage([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *stream_id*, String *data*, long *length*) 接收到数据流消息的回调。 该回调表示本地用户收到了远端用户调用 [sendStreamMessage](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a79f7b350516319c880cba474d98d4844) 方法发送的流消息。 一个 AgoraLocalUser 对象。 发送消息的用户 ID。 接收到的消息的 Stream ID。 接收到的数据。 数据长度,单位为字节。 ### onUserAudioTrackStateChanged() [#onuseraudiotrackstatechanged] void io.agora.rtc.ILocalUserObserver.onUserAudioTrackStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, [AgoraRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-audio-track) *agora_remote_audio_track*, int *state*, int *reason*, int *elapsed*) 在远端音频轨道状态变化时触发。 一个 AgoraLocalUser 对象。 音频轨道状态改变的远端用户的 ID。 一个 IRemoteAudioTrack 对象。 音频轨道当前状态: - 0:远端音频位于初始状态。 - 1:第一个远端音频包被成功接收。 - 2:远端音频流正常解码和播放。 - 3:远端音频流卡顿。 - 4:远端音频流启动失败。 状态改变原因: - 0:音频状态发生改变时,会报告该原因。 - 1:网络阻塞。 - 2:网络恢复正常。 - 3:本地用户停止接收远端音频流或本地用户禁用音频模块。 - 4:本地用户恢复接收远端音频流或本地用户启动音频模块。 - 5:远端用户停止发送音频流或远端用户禁用音频模块。 - 6:远端用户恢复发送音频流或远端用户启用音频模块。 - 7:远端用户离开频道。 远端用户连接频道之后经过的时间(毫秒)。 ### onUserAudioTrackSubscribed() [#onuseraudiotracksubscribed] void io.agora.rtc.ILocalUserObserver.onUserAudioTrackSubscribed([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, [AgoraRemoteAudioTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-audio-track) *agora_remote_audio_track*) 成功订阅远端用户发送的音频流时触发。 该回调表示本地用户已订阅指定远端音频轨道,并且收到首帧来自该轨道的音频。 一个 AgoraLocalUser 对象。 所接收的音频流的远端用户 ID。 一个 IRemoteAudioTrack 对象。 ### onUserInfoUpdated() [#onuserinfoupdated] void io.agora.rtc.ILocalUserObserver.onUserInfoUpdated([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *msg*, int *val*) 用户媒体信息更新时触发。 一个 AgoraLocalUser 对象。 用户 ID。 用户媒体信息。 用户是否停止发流。 ### onUserStateChanged() [#onuserstatechanged] void io.agora.rtc.ILocalUserObserver.onUserStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, int *state*) 远端用户状态更新时触发。 一个 AgoraLocalUser 对象。 远端用户 ID。 远端用户状态。 ### onUserVideoTrackStateChanged() [#onuservideotrackstatechanged] void io.agora.rtc.ILocalUserObserver.onUserVideoTrackStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, [AgoraRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-video-track) *agora_remote_video_track*, int *state*, int *reason*, int *elapsed*) 在远端视频轨道状态变更时触发。 一个 AgoraLocalUser 对象。 远端用户 ID。 一个 AgoraRemoteVideoTrack 对象。 当前视频帧状态: - 0:远端视频默认初始状态。 - 2:远端视频流正在解码,正常播放。 - 3:远端视频流卡顿。 - 4:远端视频流播放失败。 状态改变原因: - 0:视频状态发生改变时,会报告该原因。 - 1:网络阻塞。 - 2:网络恢复正常。 - 3:本地用户停止接收远端视频流或本地用户禁用视频模块。 - 4:本地用户恢复接收远端视频流或本地用户启动视频模块。 - 5:远端用户停止发送视频流或远端用户禁用视频模块。 - 6:远端用户恢复发送视频流或远端用户启用视频模块。 - 7:远端用户离开频道。 - 8:弱网情况下,远端音视频流回退为音频流。 - 9:网络情况改善时,远端音频流恢复为音视频流。 远端用户连接频道之后经过的时间(毫秒)。 ### onUserVideoTrackSubscribed() [#onuservideotracksubscribed] void io.agora.rtc.ILocalUserObserver.onUserVideoTrackSubscribed([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *user_id*, [VideoTrackInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-video-track-info) *info*, [AgoraRemoteVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-remote-video-track) *agora_remote_video_track*) 成功订阅远端用户发送的视频流时触发。 一个 AgoraLocalUser 对象。 发送视频帧的远端用户 ID。 视频轨道信息。 An AgoraRemoteVideoTrack 对象. ### onVideoPublishStateChanged() [#onvideopublishstatechanged] void io.agora.rtc.ILocalUserObserver.onVideoPublishStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *channel*, int *old_state*, int *new_state*, int *elapse_since_last_state*) 视频发布状态变更后触发。 一个 AgoraLocalUser 对象。 用户所在频道的频道名。 之前的发布状态: - 0:加入频道后的初始发布状态。 - 1:发布失败。 - 2:正在发布。 - 3:发布成功。 新的发布状态: - 0:加入频道后的初始发布状态。 - 1:发布失败。 - 2:正在发布。 - 3:发布成功。 变更为新状态之后的时长(毫秒)。 ### onVideoSubscribeStateChanged() [#onvideosubscribestatechanged] void io.agora.rtc.ILocalUserObserver.onVideoSubscribeStateChanged([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, String *channel*, String *user_id*, int *old_state*, int *new_state*, int *elapse_since_last_state*) 对远端用户视频订阅状态变更时触发。 一个 AgoraLocalUser 对象。 用户所在频道的频道名。 订阅的远端用户的 ID。 之前的订阅状态: - 0:加入频道后的初始订阅状态。 - 1:订阅失败。 - 2:正在订阅。 - 3:收到了远端流,订阅成功。 新的订阅状态: - 0:加入频道后的初始订阅状态。 - 1:订阅失败。 - 2:正在订阅。 - 3:收到了远端流,订阅成功。 变更为新状态之后的时长(毫秒)。 ### onVideoTrackPublishSuccess() [#onvideotrackpublishsuccess] void io.agora.rtc.ILocalUserObserver.onVideoTrackPublishSuccess([AgoraLocalUser](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-user) *agora_local_user*, [AgoraLocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-local-video-track) *agora_local_video_track*) 在第一个本地视频包发送时触发,表明本地音视频轨道已成功发布。 一个 AgoraLocalUser 对象。 一个 AgoraLocalVideoTrack 对象。 --- 该接口的文档由以下文件生成: - ILocalUserObserver.java