# 上传模块事件 (/zh-CN/realtime-media/cloud-recording/build/implement-core-features/uploading)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
当 payload 中的 serviceType 返回 2 时,表示该回调事件与上传模块相关。
本页介绍上传模块相关的回调事件。如果你想查看其他云端录制的相关事件,可以参考[回调事件概览](/zh-CN/realtime-media/cloud-recording/reference/ncs-events)。
上传模块回调包含如下事件:
| `eventType` | 事件描述 |
| ------------- | ------------------------------------------------------------ |
| [`30`](#30) | 上传服务已启动 |
| [`31`](#31) | 所有录制文件已上传至指定的第三方云存储 |
| [`32`](#32) | 录制文件上传到声网备份云;新单流录制的 `stranded` 上传状态处理见下文 |
| [`33`](#33) | 录制文件上传到第三方云存储的进度;新单流录制(`mode=raw`)已移除此事件 |
| [`45`](#45) | 云端截图成功 |
## 30 uploader_started [#30-uploader_started]
`eventType` 为 `30` 表示上传服务已启动, `details` 中包含以下字段:
- `msgName`:String 类型,消息名称,即 `uploader_started`。
- `status`:Number 类型,事件状态,0 表示正常,其他值表示异常。
## 31 uploaded [#31-uploaded]
`eventType` 为 `31` 表示所有录制文件已上传至指定的第三方云存储, `details` 中包含以下字段:
- `msgName`:String 类型,消息名称,即 `uploaded`。
- `status`:Number 类型,事件状态,`0` 表示正常,其他值表示异常。
- `fileList`:JSON Array,由每个录制文件的具体信息组成的数组。
- `fileName`:String 类型,已经上传到指定三方云存储的录制文件名。
- `trackType`:String 类型,录制文件的类型。
- `"audio"`:纯音频文件。
- `"video"`:纯视频文件。
- `"audio_and_video"`:音视频文件。
- `uid`:String 类型,用户 ID,表示录制的是哪个用户的音频流或视频流。合流录制模式下,`uid` 为 `"0"`。
- `mixedAllUser`:Boolean 类型,是否将所有用户合并录制。
- `true`:所有用户合并在一个录制文件中。
- `false`:每个用户分开录制。
- `isPlayable`:Boolean 类型,是否可以在线播放。
- `true`:可以在线播放。
- `false`:无法在线播放。
- `sliceStartTime`:Number 类型,该文件的录制开始时间,Unix 时间戳,单位为毫秒。
回调示例如下:
```json
{
"msgName": "uploaded",
"fileList": [
{
"fileName": "xxx.m3u8",
"trackType": "audio",
"uid": "57297",
"mixedAllUser": false,
"isPlayable": true,
"sliceStartTime": 1619172871089
},
{
"fileName": "xxx.m3u8",
"trackType": "audio",
"uid": "10230",
"mixedAllUser": false,
"isPlayable": true,
"sliceStartTime": 1619172871099
}
],
"status": 0
}
```
```json
{
"msgName": "uploaded",
"fileList": [
{
"fileName": "xxx.m3u8",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619170461821
}
],
"status": 0
}
```
```json
{
"msgName": "uploaded",
"fileList": [
{
"fileName": "xxx.mp4",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619172632080
},
{
"fileName": "xxx.m3u8",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619172632080
}
],
"status": 0
}
```
```json
{
"msgName": "uploaded",
"status": 0
}
```
## 32 backuped [#32-backuped]
:::caution[新单流录制的上传状态]
新单流录制(`mode=raw`)新增 `stranded` 上传状态,表示部分录制文件尚未上传至指定的第三方云存储。录制服务会继续自动重试上传,直至上传成功;该状态不表示文件丢失。停止录制后,请检查 [`stop`](/zh-CN/api-reference/api-ref/cloud-recording/stop) 响应中的 `serverResponse.uploadingStatus`。如果为 `stranded`,业务侧应保留“上传未完成”状态,等待文件上传完成后再进行依赖完整录制文件的播放或处理。
:::
以下为 `backuped` 回调的含义、字段和示例。
`eventType` 为 `32` 表示所有录制文件已经全部上传完成,但至少有一片上传到声网备份云,声网备份云会自动将这部分文件上传到指定的第三方云存储。 `details` 中包含以下字段:
- `msgName`:String 类型,消息名称,即 `backuped`。
- `status`:Number 类型,事件状态,0 表示正常,其他值表示异常。
- `fileList`:JSON Array,由每个录制文件的具体信息组成的数组。
- `fileName`:String 类型,已经上传到指定三方云存储的录制文件名。
- `trackType`:String 类型,录制文件的类型。
- `"audio"`:纯音频文件。
- `"video"`:纯视频文件。
- `"audio_and_video"`:音视频文件。
- `uid`:String 类型,用户 ID,表示录制的是哪个用户的音频流或视频流。合流录制模式下,`uid` 为 `"0"`。
- `mixedAllUser`:Boolean 类型,是否将所有用户合并录制。
- `true`:所有用户合并在一个录制文件中。
- `false`:每个用户分开录制。
- `isPlayable`:Boolean 类型,是否可以在线播放。
- `true`:可以在线播放。
- `false`:无法在线播放。
- `sliceStartTime`:Number 类型,该文件的录制开始时间,Unix 时间戳,单位为毫秒。
回调示例如下:
```json
{
"msgName": "backuped",
"fileList": [
{
"fileName": "xxx.m3u8",
"trackType": "audio",
"uid": "57297",
"mixedAllUser": false,
"isPlayable": true,
"sliceStartTime": 1619172871089
},
{
"fileName": "xxx.m3u8",
"trackType": "audio",
"uid": "10230",
"mixedAllUser": false,
"isPlayable": true,
"sliceStartTime": 1619172871099
}
],
"status": 0
}
```
```json
{
"msgName": "backuped",
"fileList": [
{
"fileName": "xxx.m3u8",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619170461821
}
],
"status": 0
}
```
```json
{
"msgName": "backuped",
"fileList": [
{
"fileName": "xxx.mp4",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619172632080
},
{
"fileName": "xxx.m3u8",
"trackType": "audio_and_video",
"uid": "0",
"mixedAllUser": true,
"isPlayable": true,
"sliceStartTime": 1619172632080
}
],
"status": 0
}
```
```json
{
"msgName": "backuped",
"status": 0
}
```
## 33 uploading_progress [#33-uploading_progress]
:::caution[新单流录制不支持此事件]
新单流录制(`mode=raw`)已移除事件 `33`(`uploading_progress`),不会按分钟推送上传进度。迁移时,请移除对该事件的依赖。录制结束后,可通过 [`stop`](/zh-CN/api-reference/api-ref/cloud-recording/stop) 响应中的 `serverResponse.uploadingStatus` 判断上传状态,并处理 `stranded` 状态。
:::
以下说明适用于仍支持该事件的旧版及其他录制模式。
`eventType` 为 `33` 表示当前上传的进度,录制开始后每分钟会通知一次。 `details` 中包含以下字段:
- `msgName`:String 类型,消息名称,即 `uploading_progress`。
- `progress`:Number 类型,0 到 10000 之间的数字,当前已上传文件与已录制的文件的比例乘以 10000。这个数字是不断变动的,录制退出后,到达 10000 表示上传完成。
## 45 recorder_snapshot_file [#45-recorder_snapshot_file]
新单流录制(`mode=raw`)的截图回调中,`payload.serviceScene` 为 `"rtsc/raw-recording"`,不再使用旧版截图的 `"rtc_snapshot"`。事件编号仍为 `45`。
`eventType` 为 `45` 表示云端截图成功并上传至第三方云存储,`details` 中包含以下字段:
- `msgName`:String 类型,消息名称,即 `recorder_snapshot_file`。
- `fileName`: String 类型,截图生成的 JPG 文件的文件名。格式为:`"fileName": "/"`。其中 `fileNamePrefix` 指截图文件在第三方云存储中的存储位置。