# 录制服务事件 (/zh-CN/realtime-media/cloud-recording/build/implement-core-features/service) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 当 payload 中的 serviceType 返回 0 时,表示该回调事件的服务类型是云端录制服务。 本页介绍录制服务相关的回调事件。如果你想查看其他云端录制的相关事件,可以参考[回调事件概览](/zh-CN/realtime-media/cloud-recording/reference/ncs-events)。 录制服务回调包含如下事件: | eventType | 事件描述 | | ------------- | ------------------------------------------------------------ | | [`1`](#1) | 云端录制服务发生错误 | | [`2`](#2) | 云端录制服务发生警告 | | [`3`](#3) | 云端录制服务状态发生变化 | | [`4`](#4) | 生成录制索引文件 | | [`11`](#11) | 云端录制服务结束任务并退出 | | [`12`](#12) | 云端录制[启用高可用机制](/zh-CN/reference/faq/integration/high_availability) | ## 1 cloud_recording_error [#1-cloud_recording_error] `eventType` 为 `1` 表示云端录制服务发生错误, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"cloud_recording_error"`。 - `module`:Number 类型,发生错误的模块。 - `0`:录制模块 - `1`:上传模块 - `2`:云端录制服务 - `6`:页面录制服务 - `errorLevel`:Number 类型,错误级别。 - `1`:debug - `2`:minor - `3`:medium - `4`:major - `5`:fatal。fatal 级别的错误很可能导致录制退出,如果收到该级别的消息请及时调用 [`query`](/zh-CN/api-reference/api-ref/cloud-recording/query) API 查询当前状态,并结合错误消息的内容进行处理。 - `errorCode`:Number 类型,错误码。与 `module` 有关: - 如果 `module` 为 `1`,错误发生在上传模块,错误码可能为: - `32`:第三方云存储信息错误。 - `47`:文件上传失败。 - `51`:上传时文件操作发生错误。 - 如果 `module` 为 `2`,错误发生在云端录制服务模块,错误码可能为: - `50`:上传超时。 - `52`:云端录制服务启动超时。 - 如果 `module` 为其他,请参考[响应状态码和错误码](/zh-CN/realtime-media/cloud-recording/reference/response-code)中的错误码说明。 如果错误码未在文档中列出,请联系[技术支持](https://ticket.shengwang.cn/)。 - `stat`:Number 类型,事件状态,`0` 表示正常,其他值表示异常。 - `errorMsg`:String 类型,具体的错误信息。 回调示例如下: ```json { "msgName": "cloud_recording_error", "module": 0, "errorLevel": 5, "errorCode": 3, "stat": 0, "errorMsg": "" } ``` ## 2 cloud_recording_warning [#2-cloud_recording_warning] `eventType` 为 `2` 表示云端录制服务发生警告, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `cloud_recording_warning`。 - `module`:Number 类型,发生警告的模块名。 - `0`:录制模块 - `1`:上传模块 - `warnCode`:Number 类型,警告码。与 `module` 有关: - 如果 `module` 为 `0`,警告发生在录制模块,请参考[警告码](/zh-CN/api-reference/local-server-recording/cpp/legacy/namespaceagora-1-1linuxsdk#a11cab69078db26c1f166c68e469dcfcf)的说明。 - 如果 `module` 为 `1`,警告发生在上传模块,警告码可能为: - `31`:重传到指定的云存储。 - `32`:重传到声网备份云。 ## 3 cloud_recording_status_update [#3-cloud_recording_status_update] `eventType` 为 `3` 表示云端录制服务状态与你调用的方法不匹配,导致调用失败。例如,云端录制服务已开始,导致再次调用 `start` 失败。`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `cloud_recording_status_update`。 - `status`:Number 类型,云端录制当前的状态: - `0`:没有开始云端录制。 - `1`:云端录制初始化完成。 - `2`:录制组件开始启动。 - `3`:上传组件已启动。 - `4`:录制组件启动完成。 - `5`:已成功上传第一个文件。 - `6`:已经停止录制。 - `7`:云端录制服务全部停止。 - `8`:云端录制准备退出。 - `20`:云端录制异常退出。 - `recordingMode`:Number 类型,录制模式。 - `0`:合流模式 - `1`:单流模式 - `fileList`:String 类型,录制生成的 M3U8 索引文件名。 ## 4 cloud_recording_file_infos [#4-cloud_recording_file_infos] `eventType` 为 4 表示生成 M3U8 文件并上传。录制过程中,录制服务会反复上传和覆盖 M3U8 文件,以更新索引信息,但只有第一次生成并上传 M3U8 文件时会触发该回调。 **合流录制**和**页面录制**模式下,将 `avFileType` 设置为 `["hls","mp4"]` 时,`eventType` 为 4 表示生成 M3U8 和 MP4 文件并上传。 `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `cloud_recording_file_infos`。 - `fileList`:String 类型,生成的 M3U8 和 MP4 文件名(如有)。 ## 11 session_exit [#11-session_exit] `eventType` 为 `11` 表示云端录制服务结束任务并退出,`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `session_exit`。 - `exitStatus`:Number 类型,退出状态。 - `0`:正常退出,即录制结束、录制文件成功上传后,录制服务退出。 - `1`:异常退出,例如参数设置错误,导致录制停止。 ## 12 session_failover [#12-session_failover] `eventType` 为 `12` 表示云端录制启用高可用机制,`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `session_failover`。 - `newUid`:Number 类型,启用高可用机制后,云端录制随机指定的录制用户 ID。云端录制将使用该录制用户 ID 加入频道,不再使用原有的录制用户 ID。