# 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