设置延时混音

在单流音频录制下，如果希望结束录制后获取频道内所有用户混音后的录制文件，你可以在开始单流音频不转码录制时进一步设置延时混音功能。设置后，录制服务会在录制结束后 24 小时内（特殊情况下会达到 48 小时以上）将指定频道内所有 UID 的录制文件合并且转码生成一个 MP3/M4A/AAC 文件，并将录制文件上传至你指定的第三方云存储。 本文介绍如何使用云端录制 RESTful API 进行延时混音，并重点说明了相关参数的设置方法。

注意

在延时混音的场景下，录制文件会在声网边缘服务器上缓存，最长不超过 24 小时。如果你的业务对信息安全敏感，为了确保数据合规，请慎重考虑是否使用延时混音功能。如有任何疑虑，请联系声网技术支持。

前提条件

开始前，请参考使用 RESTful API 开始云端录制进行一次完整的录制流程体验。

实现步骤

本节介绍如何在申请录制服务器资源后，设置延时混音。

为了实现延时混音功能，调用 acquire 申请录制服务器资源时需要将 ClientRequest.scene 设为 2。

以下介绍设置延时混音的 clientRequest 关键配置，确保你进行正确设置以实现预期的录制效果。

• 设置 appsCollection.combinationPolicy 字段为 postpone_transcoding。

• 设置 transcodeOptions.transConfig.transMode 字段为 audioMix。

• 按需设置 format 和 audio 字段，支持取值详见 API 文档 。

在调用 start 时参考如下代码设置，即可实现延时混音：

JSON

{
  "cname": "httpClient463224",
  "uid": "527841",
  "clientRequest": {
    "token": "<your_token>",
    "appsCollection": {
      "combinationPolicy": "postpone_transcoding"
    },
    "transcodeOptions": {
      "container": {
        "format": "mp3"
      },
      "transConfig": {
        "transMode": "audioMix"
      },
      "audio": {
        "sampleRate": "48000",
        "bitrate": "48000",
        "channels": "2"
      }
    },
    "recordingConfig": {
      "channelType": 1,
      "streamTypes": 0,
      "streamMode": "original",
      "maxIdleTime": 30,
      "subscribeAudioUids": [
        "123",
        "456"
      ],
      "subscribeUidGroup": 0
    },
    "recordingFileConfig": {
      "avFileType": [
        "hls"
      ]
    },
    "storageConfig": {
      "vendor": 2,
      "region": 3,
      "bucket": "<your_storage_bucket_name>",
      "accessKey": "<your_storage_access_key>",
      "secretKey": "<your_storage_secret_key>",
      "fileNamePrefix": [
        "quickstart"
      ]
    }
  }
}