API 概览

你可以通过你的业务服务器向声网服务器发送 HTTP 请求，在服务端进行云端录制。本文提供云端录制 RESTful API 的概览信息。

概述

在阅读本文前，你可以参考以下文档，了解云端录制支持的几大功能，以及各功能涉及的重点步骤。

• 单流录制：分开录制每个 UID 的音频和视频。录制服务会实时将 M3U8 和 TS/WebM 文件上传至第三方云存储。如果开启延时转码，录制服务会在录制结束后 24 小时内对录制文件进行转码生成 MP4 文件，并将 MP4 文件上传至你指定的第三方云存储，频道内每个 UID 均会生成一个 MP4 文件。
• 合流录制：将频道内所有 UID 的音视频混合录制为一个音视频文件，并将录制文件上传至第三方云存储。合流模式支持同时生成 HLS 和 MP4 格式的录制文件。
• 视频截图：单流录制模式下，对频道内的视频流进行截图，并将图片文件上传至第三方云存储。视频截图时也支持录制音视频文件。
• 页面录制：将指定网页的页面内容和音频混合录制为一个音视频文件，并将录制文件上传至第三方云存储。页面录制时也支持转推音视频流到 CDN。

前提条件

请确保已开通云端录制服务。

实现流程

一般进行云端录制的步骤如下：

1. 通过 acquire 请求获取一个 resource ID 用于开启云端录制。
2. 在获取到 resource ID 的 5 分钟内调用 start 开始云端录制。开始录制后，你可以按需进行如下操作：
   • 调用 query 请求查询云端录制的状态。
   • 调用 update 更新录制配置。
   • 调用 updateLayout 更新合流布局。
3. 调用 stop 离开频道，停止录制。

请求结构

认证方式

云端录制 RESTful API 仅支持 HTTPS 协议。发送请求时，你需要通过 Basic HTTP 认证，并将生成的凭证填入 HTTP 请求头部的 Authorization 字段。具体生成 Authorization 字段的方法请参考 HTTP 基本认证。

数据格式

所有的请求都发送给域名：api.sd-rtn.com。

• 请求：请求的格式详见各个 API 中的示例。
• 响应：响应内容的格式为 JSON。

所有的请求 URL 和请求包体内容都是区分大小写的。

已知限制

云端录制服务的最大并发频道数为 100。如需提高上限，请联系声网商务。