# 设置单流不转码录制 (/zh-CN/realtime-media/cloud-recording/build/recording-modes/individual-mode/set-individual-without-transcoding) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 在仅录制音频的场景下,如果单流转码录制生成的文件无法满足你的需求,例如你需要调整音频编码属性或去除录制文件中的静音片段,则可以采用单流不转码录制。关于单流音频转码与不转码录制的区别,可参考[单流音频转码与不转码对比](/zh-CN/realtime-media/cloud-recording/reference/concepts#转码)。 本文介绍如何使用云端录制 RESTful API 进行单流音频不转码录制,并重点说明了相关参数的设置方法。 ## 前提条件 [#前提条件] 开始前,请参考[使用 RESTful API 开始云端录制](/zh-CN/realtime-media/cloud-recording/get-started/quick-start)进行一次完整的录制流程体验。 ## 实现步骤 [#实现步骤] 本节介绍如何在[申请录制服务器资源](/zh-CN/realtime-media/cloud-recording/get-started/quick-start#申请录制服务器资源)后,开始单流不转码录制。 ### 开始录制 [#开始录制] 调用 [`start`](/zh-CN/api-reference/api-ref/cloud-recording/start) 方法开始云端录制。 以下介绍开始单流音频不转码录制请求的关键配置,确保你进行正确设置以实现预期的录制效果。 1. 在调用 `start` 方法时,将 `mode` 参数设置为 `individual`,开启单流录制模式。 :::warning[注意] 录制模式的设置必须在开始录制的时候完成,不支持在录制开始后切换模式。 ::: 2. 设置 `recordingConfig` 中的如下参数: | 字段 | 配置内容 | | :---------------------------- | :------------------------------------------------------------------------------- | | `recordingConfig.streamTypes` | 订阅媒体流类型,单流音频不转码录制设置为 `0` (仅订阅音频)。 | | `recordingConfig.streamMode` | [媒体流输出模式](/zh-CN/realtime-media/cloud-recording/reference/api-reference#媒体流输出模式设置),单流音频不转码录制设置为 `original`(原始模式)。 | | `recordingConfig.subscribeUidGroup` | 预估的订阅人数峰值。该字段在单流录制模式下必填;例如订阅人数为 1 到 2 个用户 ID 时,可设置为 `0`。更多取值说明可参考 [云端录制存储参数参考](/zh-CN/realtime-media/cloud-recording/reference/api-reference#录制的音视频流配置项)。 | 3. 参照[快速开始](/zh-CN/realtime-media/cloud-recording/get-started/quick-start#开始录制)配置 `storageConfig` 相关参数。 开启单流音频不转码录制的请求 Body 示例如下: ```shell # [!code highlight:1] curl --location --request POST 'https://api.sd-rtn.com/v1/apps//cloud_recording/resourceid//mode/individual/start' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --header 'Authorization: ' \ --data '{ "cname": "show", "uid": "123", "clientRequest": { "token": "", # [!code highlight:14] "recordingConfig": { "channelType": 1, "streamTypes": 0, "streamMode": "original", "subscribeUidGroup": 0, }, "storageConfig": { "vendor": 2, "region": 3, "bucket": "", "accessKey": "", "secretKey": "", "fileNamePrefix": [ "quickstart" ] } } }' ``` #### 响应示例 [#响应示例] ```json { "cname": "show", "uid": "123", "resourceId": "SGXETXXX", // [!code highlight:1] "sid": "04a85XXX" } ``` 你需要复制 `sid` 以备后用。 ### 进阶功能:延时混音 [#进阶功能延时混音] 在单流音频不转码录制场景下,你可以通过 `appsCollection` 和 `transcodeOptions` 字段开启延时混音。录制服务会在录制结束后 24 小时内合并并转码指定频道内用户的录制文件,然后上传到指定的第三方云存储。 ### 停止录制 [#停止录制] 录制完成后,调用 [`stop`](/zh-CN/api-reference/api-ref/cloud-recording/stop) 方法离开频道,停止录制。录制停止后如需再次录制,必须再调用 `acquire` 方法请求一个新的 Resource ID。 #### 请求示例 [#请求示例] ```shell curl --location --request POST 'https://api.sd-rtn.com/v1/apps/{your_app_id}/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", "uid": "xxx" } ], // [!code highlight:1] "uploadingStatus": "uploaded" }, "cname": "show", "uid": "123" } ``` `uploadingStatus` 字段表示录制文件上传状态,当值为 `uploaded` 时表示录制文件已上传至第三方云存储。 ### 查看录制文件 [#查看录制文件] 单流不转码生成的录制文件示意图如下: 你可以参考第三方云存储的官方文档来查看存储在云端的录制文件。录制文件包含一个 M3U8 和多个 TS 文件,点击即可播放。如需了解文件详情,可参考[录制文件介绍](/zh-CN/realtime-media/cloud-recording/build/manage-recorded-files/introduce-recorded-files)。如需将文件转换成 MP3、M4A、AAC 等格式,可参考[转换录制文件格式](/zh-CN/realtime-media/cloud-recording/build/manage-recorded-files/convert-format)对录制后的文件进行转换。 ## 参考信息 [#参考信息] ### 常见问题 [#常见问题] - [应用崩溃后对云端录制有什么影响?](/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) ### 相关文档 [#相关文档] 在单流不转码录制过程中,你还可以参考如下文档: - [媒体流输出模式](/zh-CN/realtime-media/cloud-recording/reference/api-reference#媒体流输出模式设置) - [管理录制文件](/zh-CN/realtime-media/cloud-recording/build/manage-recorded-files/introduce-recorded-files)