# IAgoraMediaRtcRecorderEventHandler 类 (/zh-CN/api-reference/local-server-recording/java/iagoramediartcrecordereventhandler) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 用于接收媒体录制器的回调事件。 ## onConnected [#onconnected] ```java default void onConnected(String channelId, String userId) ``` SDK 与声网频道连接成功时触发的回调。 #### 参数 [#参数] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 用户 ID。 | ## onDisconnected [#ondisconnected] ```java default void onDisconnected(String channelId, String userId, Constants.ConnectionChangedReasonType reason) ``` `CONNECTION_STATE_DISCONNECTED(1)` 状态时触发的回调。 当 SDK 与声网频道的连接状态变为 `CONNECTION_STATE_DISCONNECTED(1)` 时触发该回调。 #### 参数 [#参数-1] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 用户 ID。 | | `reason` | `Constants.ConnectionChangedReasonType` | 连接状态变化的原因,详见 [`ConnectionChangedReasonType`](/zh-CN/api-reference/local-server-recording/java/enum#connectionchangedreasontype)。 | ## onReconnected [#onreconnected] ```java default void onReconnected(String channelId, String userId, Constants.ConnectionChangedReasonType reason) ``` `CONNECTION_STATE_CONNECTED(3)` 状态恢复时触发的回调。 #### 参数 [#参数-2] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 用户 ID。 | | `reason` | `Constants.ConnectionChangedReasonType` | 连接状态变化的原因。详见 [`ConnectionChangedReasonType`](/zh-CN/api-reference/local-server-recording/java/enum#connectionchangedreasontype)。 | ## onConnectionLost [#onconnectionlost] ```java default void onConnectionLost(String channelId, String userId) ``` SDK 与声网频道失去连接时触发的回调。 #### 参数 [#参数-3] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道的 ID。 | | `userId` | `String` | 用户的 ID。 | ## onUserJoined [#onuserjoined] ```java default void onUserJoined(String channelId, String userId) ``` 远端用户加入频道回调。 #### 参数 [#参数-4] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 用户 ID。 | ## onUserLeft [#onuserleft] ```java default void onUserLeft(String channelId, String userId, Constants.UserOfflineReasonType reason) ``` [`onUserLeft`](/zh-CN/api-reference/local-server-recording/java/iagoramediartcrecordereventhandler#onuserleft) 回调:远端用户离开频道时触发。 #### 参数 [#参数-5] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 用户 ID。 | | `reason` | `Constants.UserOfflineReasonType` | 远端用户离开频道的原因。详见 [`UserOfflineReasonType`](/zh-CN/api-reference/local-server-recording/java/enum#userofflinereasontype)。 | ## onFirstRemoteVideoDecoded [#onfirstremotevideodecoded] ```java default void onFirstRemoteVideoDecoded(String channelId, String userId, int width, int height, int elapsed) ``` 首帧远端视频解码完成回调。 该回调在 SDK 为录制端成功解码远端用户的首帧视频时触发。 #### 参数 [#参数-6] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 远端用户 ID。 | | `width` | `int` | 视频流的宽度(像素)。 | | `height` | `int` | 视频流的高度(像素)。 | | `elapsed` | `int` | 从用户加入频道到触发该回调的时间(毫秒)。 | ## onFirstRemoteAudioDecoded [#onfirstremoteaudiodecoded] ```java default void onFirstRemoteAudioDecoded(String channelId, String userId, int elapsed) ``` 远端音频首帧解码回调。 #### 参数 [#参数-7] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 发送音频流的远端用户的用户 ID。 | | `elapsed` | `int` | 从远端用户加入频道到触发该回调的时间(毫秒)。 | ## onAudioVolumeIndication [#onaudiovolumeindication] ```java default void onAudioVolumeIndication(String channelId, SpeakVolumeInfo[] speakers, int speakerNumber) ``` [`onAudioVolumeIndication`](/zh-CN/api-reference/local-server-recording/java/iagoramediartcrecordereventhandler#onaudiovolumeindication) 回调:报告哪些用户正在说话、说话者的音量以及本地用户是否在说话。 #### 参数 [#参数-8] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `speakers` | `SpeakVolumeInfo[]` | 说话者的用户 ID 和音量信息数组。详见 [`SpeakVolumeInfo`](/zh-CN/api-reference/local-server-recording/java/struct#speakvolumeinfo)。 | | `speakerNumber` | `int` | 说话者的总人数。 | ## onActiveSpeaker [#onactivespeaker] ```java default void onActiveSpeaker(String channelId, String userId) ``` 检测到活跃发言人时触发的回调。 你可以在 App 中添加相关功能,例如当检测到活跃发言人时,将其头像放大显示。活跃发言人是指在一段时间内以最大音量发言的用户,其用户 ID 会通过该回调返回。 #### 参数 [#参数-9] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 活跃发言人的用户 ID。`userId` 为 `0` 表示本地用户。 | ## onUserVideoStateChanged [#onuservideostatechanged] ```java default void onUserVideoStateChanged(String channelId, String userId, Constants.RemoteVideoState state, Constants.RemoteVideoStateReason reason, int elapsed) ``` 远端视频状态发生改变回调。 #### 参数 [#参数-10] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 远端用户 ID,其视频状态发生了变化。 | | `state` | `Constants.RemoteVideoState` | 当前的视频状态,详见 [`RemoteVideoState`](/zh-CN/api-reference/local-server-recording/java/enum#remotevideostate)。 | | `reason` | `Constants.RemoteVideoStateReason` | 状态变化的原因,详见 [`RemoteVideoStateReason`](/zh-CN/api-reference/local-server-recording/java/enum#remotevideostatereason)。 | | `elapsed` | `int` | 从该用户加入频道到触发该回调的时间(毫秒)。 | ## onUserAudioStateChanged [#onuseraudiostatechanged] ```java default void onUserAudioStateChanged(String channelId, String userId, Constants.RemoteAudioState state, Constants.RemoteAudioStateReason reason, int elapsed) ``` 远端用户音频状态发生变化回调。 #### 参数 [#参数-11] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 音频状态发生变化的远端用户 ID。 | | `state` | `Constants.RemoteAudioState` | 当前的音频状态,详见 [`RemoteAudioState`](/zh-CN/api-reference/local-server-recording/java/enum#remoteaudiostate)。 | | `reason` | `Constants.RemoteAudioStateReason` | 状态变化的原因,详见 [`RemoteAudioStateReason`](/zh-CN/api-reference/local-server-recording/java/enum#remoteaudiostatereason)。 | | `elapsed` | `int` | 从该用户加入声网频道到触发该回调的时间(毫秒)。 | ## onRemoteVideoStats [#onremotevideostats] ```java default void onRemoteVideoStats(String channelId, String userId, RemoteVideoStatistics stats) ``` 远端视频统计信息回调。 该回调在接收到远端视频流并统计完成后被触发。 #### 参数 [#参数-12] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 远端用户的 ID。 | | `stats` | `RemoteVideoStatistics` | 远端视频的统计信息。详见 [`RemoteVideoStatistics`](/zh-CN/api-reference/local-server-recording/java/struct#remotevideostatistics)。 | ## onRemoteAudioStats [#onremoteaudiostats] ```java default void onRemoteAudioStats(String channelId, String userId, RemoteAudioStatistics stats) ``` 远端音频统计信息回调。 #### 参数 [#参数-13] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 远端用户的 ID。 | | `stats` | `RemoteAudioStatistics` | 远端音频的统计信息。详见 [`RemoteAudioStatistics`](/zh-CN/api-reference/local-server-recording/java/struct#remoteaudiostatistics)。 | ## onRecorderStateChanged [#onrecorderstatechanged] ```java default void onRecorderStateChanged(String channelId, String userId, Constants.RecorderState state, Constants.RecorderReasonCode reason, String fileName) ``` 本地音视频录制状态发生变化回调。 该回调用于报告当前的录制状态及其变化原因。 #### 参数 [#参数-14] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道名。 | | `userId` | `String` | 用户 ID。 | | `state` | `Constants.RecorderState` | 当前录制状态,详见 [`RecorderState`](/zh-CN/api-reference/local-server-recording/java/enum#recorderstate)。 | | `reason` | `Constants.RecorderReasonCode` | 状态变化的原因,详见 [`RecorderReasonCode`](/zh-CN/api-reference/local-server-recording/java/enum#recorderreasoncode)。 | | `fileName` | `String` | 录制流的文件名。 | ## onRecorderInfoUpdated [#onrecorderinfoupdated] ```java default void onRecorderInfoUpdated(String channelId, String userId, RecorderInfo info) ``` 录制信息更新回调。 在你成功注册该回调并启用本地音视频录制后,SDK 会根据设置的 `recorderInfoUpdateInterval` 值周期性地触发该回调。 #### 参数 [#参数-15] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道名。 | | `userId` | `String` | 用户 ID。 | | `info` | `RecorderInfo` | 录制文件的信息,详见 [`RecorderInfo`](/zh-CN/api-reference/local-server-recording/java/struct#recorderinfo)。 | ## onEncryptionError [#onencryptionerror] ```java default void onEncryptionError(String channelId, Constants.EncryptionErrorType errorType) ``` 加密错误发生时触发的回调。 #### 参数 [#参数-16] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `errorType` | `Constants.EncryptionErrorType` | 加密错误类型。详见 [`EncryptionErrorType`](/zh-CN/api-reference/local-server-recording/java/enum#encryptionerrortype)。 | ## onError [#onerror] ```java default void onError(String channelId, Constants.ErrorCodeType error, String message) ``` 错误回调。 该回调用于报告错误码和错误信息。 #### 参数 [#参数-17] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `error` | `Constants.ErrorCodeType` | 错误码。详见 [`ErrorCodeType`](/zh-CN/api-reference/local-server-recording/java/enum#errorcodetype)。 | | `message` | `String` | 错误信息。 | ## onTokenPrivilegeWillExpire [#ontokenprivilegewillexpire] ```java default void onTokenPrivilegeWillExpire(String channelId, String token) ``` Token 权限即将在 30 秒后过期时触发的回调。 收到该回调后,你必须在服务器上生成新的 Token,并调用 [`renewToken`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#renewtoken) 方法更新 Token。 #### 参数 [#参数-18] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `token` | `String` | 即将在 30 秒后过期的 Token。 | ## onTokenPrivilegeDidExpire [#ontokenprivilegedidexpire] ```java default void onTokenPrivilegeDidExpire(String channelId) ``` Token 过期回调。 收到该回调后,你必须在你的服务器上生成一个新的 Token,并调用 [`renewToken`](/zh-CN/api-reference/local-server-recording/java/agoramediartcrecorder.java#renewtoken) 方法进行更新。 #### 参数 [#参数-19] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | ## onVideoSizeChanged [#onvideosizechanged] ```java default void onVideoSizeChanged(String channelId, String userId, int width, int height, int rotation) ``` 远端视频尺寸发生变化回调。 #### 参数 [#参数-20] | 参数 | 数据类型 | 描述 | | --- | --- | --- | | `channelId` | `String` | 频道 ID。 | | `userId` | `String` | 远端用户 ID。 | | `width` | `int` | 视频流的宽度。 | | `height` | `int` | 视频流的高度。 | | `rotation` | `int` | 视频流的旋转角度。 |