# 录制模块事件 (/zh-CN/realtime-media/cloud-recording/build/implement-core-features/status) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 当 payload 中的 serviceType 返回 1 时,表示该回调事件与录制模块相关。 本页介绍录制模块相关的回调事件。如果你想查看其他云端录制的相关事件,可以参考[回调事件概览](/zh-CN/realtime-media/cloud-recording/reference/ncs-events)。 录制模块回调包含如下事件: | `eventType` | 事件描述 | | ------------- | ------------------------------------------------------------ | | [`40`](#40) | 录制服务已启动 | | [`41`](#41) | 录制服务已退出 | | [`42`](#42) | 同步录制文件信息 | | [`43`](#43) | 音频流状态变化 | | [`44`](#44) | 视频流状态变化 | ## 40 recorder_started [#40-recorder_started] `eventType` 为 40 表示录制服务已启动, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `recorder_started`。 - `status`:Number 类型,事件状态,0 表示正常,其他值表示异常。 ## 41 recorder_leave [#41-recorder_leave] `eventType` 为 `41` 表示录制组件已退出, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `recorder_leave`。 - `leaveCode`:Number 类型,退出码。将该退出码与各枚举值逐一进行按位与运算,计算结果非零的,即为退出原因。例如,code 为 6(二进制 110)时,将其与各枚举值逐一进行按位与计算,`LEAVE_CODE_SIG`(二进制 10)与 `LEAVE_CODE_NO_USERS`(二进制 100)的结果非零,则退出原因包括收到 SIGINT 信号以及录制超时。 | 枚举值 | 描述 | | :---------------------- | ------------------------------------------------------------ | | `LEAVE_CODE_INIT` | 0:初始化失败。 | | `LEAVE_CODE_SIG` | 2(二进制 10):`AgoraCoreService` 收到 SIGINT 信号而触发的退出。 | | `LEAVE_CODE_NO_USERS` | 4(二进制 100):频道内除录制端外没有其他用户,录制端自动离开频道。 | | `LEAVE_CODE_TIMER_CATCH` | 8(二进制 1000):可忽略。 | | `LEAVE_CODE_CLIENT_LEAVE` | 16(二进制 10000):录制端调用 `leaveChannel` 方法退出频道。 | ## 42 recorder_slice_start [#42-recorder_slice_start] `eventType` 为 `42` 表示同步录制文件信息, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `recorder_slice_start`。 - `startUtcMs`:Number 类型,录制开始时间(即第一个录制切片的开始时间),UTC 时间,精确到毫秒。 - `discontinueUtcMs`:Number 类型,UTC 时间,精确到毫秒,正常情况下该字段值与 `startUtcMs` 一致。当录制发生异常中断时,声网云端录制会自动恢复录制,此时也会收到该事件通知,且该字段表示上一个正常的录制切片结束的时间。 - `mixedAllUser`:Boolean 类型,是否将所有用户合并录制。 - `true`:所有用户合并在一个录制文件中。 - `false`:每个用户分开录制。 - `streamUid`:String 类型,用户 ID,表示录制的是哪个用户的音频流或视频流。在合流模式下,`streamUid` 为 `"0"`。 - `trackType`:String 类型,录制文件的类型。 - `"audio"`:纯音频文件。 - `"video"`:纯视频文件。 - `"audio_and_video"`:音视频文件。 举例来说,某次录制生成第一个切片文件时,会收到回调通知该事件,其中 `startUtcMs` 为第一个切片文件开始的时间。假设第 2 个 到第 N 个切片文件都是正常的,不会收到该事件通知,到第 N + 1 个切片时发生故障,导致该切片文件丢失且录制中断,此时重新开始录制后生成第 N + 2 个切片,会再次收到回调通知该事件,其中 `startUtcMs` 为第 N + 2 个切片开始的时间, `discontinueUtcMs` 为第 N 个切片结束的时间。 ## 43 recorder_audio_stream_state_changed [#43-recorder_audio_stream_state_changed] `eventType` 为 `43` 表示录制的音频流状态变化,`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `recorder_audio_stream_state_changed`。 - `streamUid`: String 类型,用户 ID,表示录制的是哪个用户的音频流。合流录制模式下,会收到 `streamUid` 为 `0` 的回调,代表合流后的音频流。 - `state`:Number 类型,云端录制服务是否正在接收音频流。 - `0`:云端录制服务正在接收音频流 - `1`:云端录制服务未在接收音频流 - `UtcMs`:Number 类型,音频流状态变化时的时间,UTC 时间,精确到毫秒。 ## 44 recorder_video_stream_state_changed [#44-recorder_video_stream_state_changed] `eventType` 为 `44` 表示录制的视频流状态变化,`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `recorder_video_stream_state_changed`。 - `streamUid`: String 类型,用户 ID,表示录制的是哪个用户的视频流。合流录制模式下,会收到 `streamUid` 为 `0` 的回调,代表合流后的视频流。 - `state`:Number 类型,云端录制服务是否正在接收视频流。 - `0`:云端录制服务正在接收视频流 - `1`:云端录制服务未在接收视频流 - `UtcMs`:Number 类型,视频流状态变化时的时间,UTC 时间,精确到毫秒。