上传模块事件

当 payload 中的 serviceType 返回 2 时，表示该回调事件与上传模块相关。本页介绍上传模块相关的回调事件。如果你想查看其他云端录制的相关事件，可以参考回调事件概览。

上传模块回调包含如下事件：

eventType	事件描述
30	上传服务已启动
31	所有录制文件已上传至指定的第三方云存储
32	所有录制文件已经全部上传完成，但至少有一片上传到声网备份云
33	录制文件上传到第三方云存储的进度
45	云端截图成功

30 uploader_started

eventType 为 30 表示上传服务已启动， details 中包含以下字段：

• msgName：String 类型，消息名称，即 uploader_started。
• status：Number 类型，事件状态，0 表示正常，其他值表示异常。

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 类型，用户 UID，表示录制的是哪个用户的音频流或视频流。合流录制模式下，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
}

合流录制且不生成 MP4

JSON

{
  "msgName": "uploaded",
  "fileList": [
    {
      "fileName": "xxx.m3u8",
      "trackType": "audio_and_video",
      "uid": "0",
      "mixedAllUser": true,
      "isPlayable": true,
      "sliceStartTime": 1619170461821
    }
  ],
  "status": 0
}

合流录制并生成 MP4

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
}

页面录制并生成 MP4

JSON

{
  "msgName": "uploaded",
  "status": 0
}

32 backuped

eventType 为 32 表示所有录制文件已经全部上传完成，但至少有一片上传到声网备份云，声网备份云会自动将这部分文件上传到指定的第三方云存储。 details 中包含以下字段：

• msgName：String 类型，消息名称，即 backuped。
• status：Number 类型，事件状态，0 表示正常，其他值表示异常。
• fileList：JSON Array，由每个录制文件的具体信息组成的数组。
  • fileName：String 类型，已经上传到指定三方云存储的录制文件名。
  • trackType：String 类型，录制文件的类型。
    • "audio"：纯音频文件。
    • "video"：纯视频文件。
    • "audio_and_video"：音视频文件。
  • uid：String 类型，用户 UID，表示录制的是哪个用户的音频流或视频流。合流录制模式下，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
}

合流录制且不生成 MP4

JSON

{
  "msgName": "backuped",
  "fileList": [
    {
      "fileName": "xxx.m3u8",
      "trackType": "audio_and_video",
      "uid": "0",
      "mixedAllUser": true,
      "isPlayable": true,
      "sliceStartTime": 1619170461821
    }
  ],
  "status": 0
}

合流录制并生成 MP4

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
}

页面录制并生成 MP4

JSON

{
  "msgName": "backuped",
  "status": 0
}

33 uploading_progress

eventType 为 33 表示当前上传的进度，录制开始后每分钟会通知一次。 details 中包含以下字段：

• msgName：String 类型，消息名称，即 uploading_progress。
• progress：Number 类型，0 到 10000 之间的数字，当前已上传文件与已录制的文件的比例乘以 10000。这个数字是不断变动的，录制退出后，到达 10000 表示上传完成。

45 recorder_snapshot_file

eventType 为 45 表示云端截图成功并上传至第三方云存储，details 中包含以下字段：

• msgName：String 类型，消息名称，即 recorder_snapshot_file。
• fileName: String 类型，截图生成的 JPG 文件的文件名。格式为："fileName": "<fileNamePrefix>/<file name>"。其中 fileNamePrefix 指截图文件在第三方云存储中的存储位置。