# 页面录制事件 (/zh-CN/realtime-media/cloud-recording/build/implement-core-features/webpage) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 当 payload 中的 serviceType 返回 6 时,表示该回调事件的服务类型是页面录制。 本页介绍页面录制相关的回调事件。如果你想查看其他云端录制的相关事件,可以参考[回调事件概览](/zh-CN/realtime-media/cloud-recording/reference/ncs-events)。 页面录制回调包含如下事件: | `eventType` | 事件描述 | | --- | --- | | [`70`](#70) | 页面录制已启动 | | [`71`](#71) | 页面录制已停止 | | [`72`](#72) | 待录制页面使用了不受支持的功能,录制即将停止 | | [`73`](#73) | 待录制页面重新加载 | | [`100`](#100) | 页面录制 CDN 推流状态变化 | ## 70 web_recorder_started [#70-web_recorder_started] `eventType` 为 `70` 表示页面录制已启动, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"web_recorder_started"`。 - `recorderStartTime`: Number 类型,录制开始时间(UTC 时间)。Unix 时间戳,精确到毫秒。 ## 71 web_recorder_stopped [#71-web_recorder_stopped] `eventType` 为 `71` 表示页面录制已停止, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"web_recorder_stopped"`。 - `code`:Number 类型,错误码。如果错误码不为 `0`,则表示页面录制异常停止。 - `message`:String 类型,错误消息,用于提示录制正常或异常停止的原因。 - `details`:String 类型,错误消息具体描述,用于提示录制正常或异常停止的原因的具体描述,你可以根据该信息采取相应措施。 - `fileList`:JSON Array。由每个录制文件的具体信息组成的数组。 - `filename`:String 类型,录制产生的 M3U8 或 MP4 文件的文件名。 - `sliceStartTime`:Number 类型,该文件的录制开始时间,Unix 时间戳,单位为毫秒。 `code` 和 `message` 字段说明如下: | code | message | 说明 | | :--- | :------------------ | :----------------------------------------------------------- | | `0` | `ok` | 正常,用户主动停止录制。 | | `1` | `max_recording_hour` | 录制时长达到设置的最大录制时长(`maxRecordingHour`)导致录制停止。 | | `2` | `capability_limit` | 待录制页面使用了不受支持的功能导致录制停止。 | | `3` | `start_engine_failed` | 录制服务启动失败导致录制停止。 | | `4` | `page_load_timeout` |使用[检测页面加载超时](/zh-CN/realtime-media/cloud-recording/build/optimize-and-operate/webpage#检测页面加载超时)功能的情况下,页面加载超时导致录制停止。 | | `5` | `access_url_failed` | 打开待录制页面发生错误导致录制停止。 | | `6` | `recorder_error` | 录制发生错误不可继续导致录制停止。 | 回调示例如下: ```json { "msgName": "web_recorder_stopped", "code": 1, "message": "max_recording_hour", "details": "max recording hour is 4", "fileList": [ { "filename": "test_p1627613634_www.m3u8", "sliceStartTime": 1627613641393 }, { "filename": "test_p1627613634_www_0.mp4", "sliceStartTime": 1627613641393 } ] } ``` ## 72 web_recorder_capability_limit [#72-web_recorder_capability_limit] `eventType` 为 `72` 表示待录制页面使用了不受支持的功能,录制即将停止。`details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"web_recorder_capability_limit"`。 - `limitType`:String 类型,限制类型名称,包含如下几种 - `"resolution"`:待录制页面中包含超过 1920 × 1080 分辨率的视频源。 - `"WebGL"`:待录制页面使用了 WebGL 功能。 - `"bandwidth"`:上行带宽超过 10 M,或者下行带宽超过 1 G。 ## 73 web_recorder_reload [#73-web_recorder_reload] `eventType` 为 `73` 表示页面录制过程中,页面重新加载, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"web_recorder_reload"`。 - `reason`:String 类型,页面重新加载的原因。包含以下原因: - `"audio_silence"`:检测到页面音频丢失。 - `"page_load_timeout"`:检测到页面加载超时。该回调仅在以下条件下返回该字段:启用[检测页面加载超时](/zh-CN/realtime-media/cloud-recording/build/optimize-and-operate/webpage#检测页面加载超时)功能,且页面加载超时。 ## 100 rtmp_publish_status [#100-rtmp_publish_status] `eventType` 为 `100` 表示页面录制的 CDN 推流状态变化, `details` 中包含以下字段: - `msgName`:String 类型,消息名称,即 `"rtmp_publish_status"`。 - `rtmpUrl`:String 类型,CDN 推流地址。 - `status`:String 类型,页面录制当前的推流状态,包括以下状态: - `connecting`:正在连接 CDN 服务器。 - `publishing`:正在推流。 - `onhold`:推流暂停。 - `disconnected`:连接 CDN 服务器失败,声网建议你更换 CDN 推流地址。