# 实现单流录制(旧版) (/zh-CN/realtime-media/cloud-recording/build/recording-modes/individual-mode/legacy-set-individual) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 云端录制支持单流录制、合流录制和页面录制三种模式,其中[单流录制](/zh-CN/realtime-media/cloud-recording/reference/concepts#单流录制)模式指分别录制频道中每个用户 ID 的音频流和视频流,录制结束后每个用户 ID 会生成对应的音频文件和视频文件。 本文介绍如何使用云端录制的 RESTful API 并设置核心字段,进行单流转码录制,并生成特定格式的文件。如果你不需要指定单流录制生成的文件格式,可以使用[单流音频不转码录制](/zh-CN/realtime-media/cloud-recording/build/recording-modes/individual-mode/set-individual-without-transcoding)。 ## 前提条件 [#前提条件] 开始前,请参考[使用 RESTful API 开始云端录制](/zh-CN/realtime-media/cloud-recording/get-started/quick-start)进行一次完整的录制流程体验。 ## 实现步骤 [#实现步骤] 本节介绍如何在[申请录制服务器资源](/zh-CN/realtime-media/cloud-recording/get-started/quick-start/restful-api#申请录制服务器资源)后,实现单流音视频转码录制。 ### 开始录制 [#开始录制] 调用 [`start`](/zh-CN/api-reference/api-ref/cloud-recording/start) 方法开始云端录制。 #### 请求示例 [#请求示例] 以下介绍开始单流音频转码录制请求的关键配置,确保你进行正确设置以实现预期的录制效果。 1. 在调用 `start` 方法时,将 `mode` 参数设置为 `individual`,开启单流录制模式。 :::caution[注意] 录制模式的设置必须在开始录制的时候完成,不支持在录制开始后切换模式。 ::: 2. 设置 `recordingConfig` 中的如下参数: | 字段 | 配置内容 | | :---------------------------- | :------------------------------------------------------------------------------- | | `recordingConfig.streamTypes` | 订阅媒体流类型,`2` 为订阅音频和视频。具体设置参见 [`streamTypes` 参数说明](/zh-CN/api-reference/api-ref/cloud-recording/start)。 | | `recordingConfig.streamMode` | [媒体流输出模式](/zh-CN/realtime-media/cloud-recording/reference/api-reference#媒体流输出模式设置),为获得能直接播放的 MP4 文件,建议设置为 `standard`(标准模式)或 `default`(默认模式)。 | 3. 参照[快速开始](/zh-CN/realtime-media/cloud-recording/get-started/quick-start/restful-api#开始录制)配置 `storageConfig` 相关参数。 单流音视频转码录制的请求 Body 示例如下: ```shell # [!code highlight:1] curl --location --request POST 'https://api.sd-rtn.com/v1/apps//cloud_recording/acquire' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: ' \ --data '{ "cname": "show", "uid": "123", "clientRequest": { "token": "", "recordingConfig": { "channelType": 1, # [!code highlight:2] "streamTypes": 2, "streamMode": "default", "videoStreamType": 0, "maxIdleTime": 30, "subscribeAudioUids": [ "123", "456" ], "subscribeVideoUids": [ "123", "456" ], "subscribeUidGroup": 0 }, "recordingFileConfig": { "avFileType": [ "hls" ] }, # [!code highlight:8] "storageConfig": { "vendor": 2, "region": 3, "bucket": "", "accessKey": "", "secretKey": "", "fileNamePrefix": [ "quickstart", ] }, } } ``` #### 响应示例 [#响应示例] ```json { "cname": "show", "uid": "123", "resourceId": "SGXETXXX", // [!code highlight:1] "sid": "04a85XXX" } ``` 你需要复制 `sid` 以备后用。 ### 停止录制 [#停止录制] 录制完成后,调用 [`stop`](/zh-CN/api-reference/api-ref/cloud-recording/stop) 方法离开频道,停止录制。录制停止后如需再次录制,必须再调用 `acquire` 方法请求一个新的 Resource ID。 #### 请求示例 [#请求示例-1] ```shell curl --location --request POST 'https://api.sd-rtn.com/v1/apps//cloud_recording/resourceid//sid//mode/individual/stop' \ --header 'Content-Type: application/json' \ --data '{ "cname": "show", "uid": "123", "clientRequest": { "async_stop": false } }' ``` #### 响应示例 [#响应示例-1] ```json { "resourceId": "SGXETXXX", "sid": "04a85XXX", "serverResponse": { "fileListMode": "json", "fileList": [ { "fileName": "xxxxxxx", "isPlayable": true, "mixedAllUser": false, "sliceStartTime": xxxxxxxxxx, "trackType": "audio_and_video", "uid": "xxx" } ], // [!code highlight:1] "uploadingStatus": "uploaded" }, "cname": "show", "uid": "123" } ``` `uploadingStatus` 字段表示录制文件上传状态,当值为 `uploaded` 时表示录制文件已上传至第三方云存储。 ## 参考信息 [#参考信息] ### 录制文件音视频编码配置 [#录制文件音视频编码配置] 单流录制模式下录制文件的音视频编码配置如下: - 音频编码配置:采样率固定为 48 kHz,声道数和码率与原始音频流一致。 - 视频编码配置:与原始视频流一致。 根据录制内容的不同,录制生成的文件如下表所示: | 录制内容 | 字段设置 | 录制生成文件 | | --- | --- | --- | | 仅录制音频 | `streamTypes` 设为 `0` | 每个用户 ID 生成一个 M3U8 文件和多个 TS 文件。TS 文件内仅存储该用户 ID 的音频数据。 | | 仅录制视频 | `streamTypes` 设为 `1` | 每个用户 ID 生成一个 M3U8 文件和多个 TS/WebM 文件。TS/WebM 文件内仅存储该用户 ID 的视频数据。 | | 同时录制音视频,且使用录制的标准模式 | `streamTypes` 设为 `2`,`streamMode` 设为 `standard`。 | [set-individual-html-0-3-2 details](#table-slot-set-individual-html-0-3-2) | | 同时录制音视频,且使用录制的默认模式 | `streamTypes` 设为 `2`,`streamMode` 设为 `default`。 | 每个用户 ID 分别生成 M3U8 音频索引文件和视频索引 HLS 文件,以及多个 TS 音频切片文件和 TS 视频切片文件。 | **set-individual-html-0-3-2 details** - 每个用户 ID 生成一个 M3U8 音频文件、一个 M3U8 视频文件、一个合并的 M3U8 音视频文件,以及多个 TS 音频切片文件和 TS 视频切片文件。 - 如果在 Web 端使用 VP8 编码,录制结束后你可以获得合并的 MPD 音视频索引文件,以及多个 WebM 格式的音频文件和多个 WebM 格式的视频文件。 如下展示单流转码录制,同时录制音视频时生成的文件,以频道中有两个用户 `uid 1` 和 `uid 2` 为例: standard 模式 default 模式 :::info[信息] 生成后的 M3U8 或 MPD 格式的音频、视频文件可以直接播放。 ::: ### 开发注意事项 [#开发注意事项] 在进行单流录制过程中,你需要关注如下注意事项: - 使用标准模式录制(`streamMode` 为 `standard`),如果录制过程中将 Native 端切换到 Web 端(或反之),录制结束后你会获得 M3U8 格式和 MPD 格式的两个音视频索引文件,无法连贯播放整个录制过程。 - 如果在录制过程中禁用视频轨道,则录制效果详见下表: | 发流端类型 | 禁用视频轨道的方法 | 录制效果 | | :---------- | :----------------------------------------------------------- | :------------------- | | Native 端 | 调用 [`muteLocalVideoStream`](/zh-CN/api-reference/rtc/android/publishnsubscribe#api_irtcengine_mutelocalvideostream) 或 [`disableVideo`](/zh-CN/api-reference/rtc/android/video/video-basic#api_irtcengine_disablevideo) 方法 |不继续生成视频切片文件,在本切片内用户画面显示最后一帧。 | | Web 端 | 调用 [`setEnabled`](/zh-CN/api-reference/rtc/web/interfaces/ilocalvideotrack#setenabled) 方法 | 不继续生成视频切片文件,在本切片内用户画面显示最后一帧。 | ### 相关文档 [#相关文档] 在单流转码录制过程中,你还可以参考如下文档: - [媒体流输出模式](/zh-CN/realtime-media/cloud-recording/reference/api-reference#媒体流输出模式设置) - [设置订阅名单](/zh-CN/realtime-media/cloud-recording/reference/api-reference#订阅名单设置) - [转换录制文件格式](/zh-CN/realtime-media/cloud-recording/build/manage-recorded-files/convert-format) - [录制文件介绍](/zh-CN/realtime-media/cloud-recording/build/manage-recorded-files/introduce-recorded-files) ### API 参考 [#api-参考] 你可以参考以下方法了解字段详情: - [`acquire`](/zh-CN/api-reference/api-ref/cloud-recording/acquire) - [`start`](/zh-CN/api-reference/api-ref/cloud-recording/start) - [`stop`](/zh-CN/api-reference/api-ref/cloud-recording/stop) ### 常见问题 [#常见问题] - [应用崩溃后对云端录制有什么影响?](/zh-CN/reference/faq/integration/abnormal_exit) - [如何选择云存储 bucket 区域及处理跨区上传问题?](/zh-CN/reference/faq/integration/bucket_region) - [为什么无法通过浏览器调用云端录制 RESTful API?](/zh-CN/reference/faq/product/call_api_in_browser) - [为什么第三方云储存中没有录制文件?](/zh-CN/reference/faq/integration/fail_to_upload) - [如何获取 M3U8 文件地址?](/zh-CN/reference/faq/integration/acquire_file_directory) - [云端录制如何处理服务器断网、进程被杀问题?](/zh-CN/reference/faq/integration/high_availability)