# 云端录制存储参数参考 (/zh-CN/realtime-media/cloud-recording/reference/api-reference) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 第三方云存储地区说明 [#第三方云存储地区说明] 使用自定义录制和自定义截图功能时,你可以通过 StorageConfig 进行录制文件和截图文件的第三方云存储配置,其中 vendor 字段(第三方云存储平台)的取值决定了 region 字段(第三方云存储地区)的取值。 本文介绍 `vendor` 的不同取值下,`region` 字段可以配置的值。 1 2 3 5 6 7 8 11 当 `vendor` = 1,即第三方云存储为 Amazon S3 时,`region` 可取如下值: - `0`:US_EAST_1 - `1`:US_EAST_2 - `2`:US_WEST_1 - `3`:US_WEST_2 - `4`:EU_WEST_1 - `5`:EU_WEST_2 - `6`:EU_WEST_3 - `7`:EU_CENTRAL_1 - `8`:AP_SOUTHEAST_1 - `9`:AP_SOUTHEAST_2 - `10`:AP_NORTHEAST_1 - `11`:AP_NORTHEAST_2 - `12`:SA_EAST_1 - `13`:CA_CENTRAL_1 - `14`:AP_SOUTH_1 - `15`:CN_NORTH_1 - `16`:CN_NORTHWEST_1 - `18`:AF_SOUTH_1 - `19`:AP_EAST_1 - `20`:AP_NORTHEAST_3 - `21`:EU_NORTH_1 - `22`:ME_SOUTH_1 - `24`:AP_SOUTHEAST_3 - `25`:EU_SOUTH_1 当 `vendor` = 2,即第三方云存储为阿里云时,`region` 可取如下值: - `0`:CN_Hangzhou - `1`:CN_Shanghai - `2`:CN_Qingdao - `3`:CN_Beijing - `4`:CN_Zhangjiakou - `5`:CN_Huhehaote - `6`:CN_Shenzhen - `7`:CN_Hongkong - `8`:US_West_1 - `9`:US_East_1 - `10`:AP_Southeast_1 - `11`:AP_Southeast_2 - `12`:AP_Southeast_3 - `13`:AP_Southeast_5 - `14`:AP_Northeast_1 - `15`:AP_South_1 - `16`:EU_Central_1 - `17`:EU_West_1 - `18`:EU_East_1 - `19`:AP_Southeast_6 - `20`:CN_Heyuan - `21`:CN_Guangzhou - `22`:CN_Chengdu - `23`:CN_Nanjing - `24`:CN_Fuzhou - `25`:CN_Wulanchabu - `26`:AP_Northeast_2 - `27`:AP_Southeast_7 详见[阿里云参考文档](https://help.aliyun.com/document_detail/31837.html)。 当 `vendor` = 3,即第三方云存储为腾讯云时,`region` 可取如下值: - `0`:AP_Beijing_1 - `1`:AP_Beijing - `2`:AP_Shanghai - `3`:AP_Guangzhou - `4`:AP_Chengdu - `5`:AP_Chongqing - `6`:AP_Shenzhen_FSI - `7`:AP_Shanghai_FSI - `8`:AP_Beijing_FSI - `9`:AP_Hongkong - `10`:AP_Singapore - `11`:AP_Mumbai - `12`:AP_Seoul - `13`:AP_Bangkok - `14`:AP_Tokyo - `15`:NA_Siliconvalley - `16`:NA_Ashburn - `17`:NA_Toronto - `18`:EU_Frankfurt - `19`:EU_Moscow 当 `vendor` = 5,即第三方云存储为 Microsoft Azure 时,无需设置 `region` 字段,即使设置也不生效。 当 `vendor` = 6,即第三方云存储为谷歌云时,无需设置 `region` 字段,即使设置也不生效。 当 `vendor` = 7,即第三方云存储为华为云时,`region` 可取如下值: - `0`:CN_North_1 - `1`:CN_North_4 - `2`:CN_East_2 - `3`:CN_East_3 - `4`:CN_South_1 - `5`:CN_Southwest_2 - `6`:AP_Southeast_1 - `7`:AP_Southeast_2 - `8`:AP_Southeast_3 - `9`:AF_South_1 - `10`:SA_Argentina_1 - `11`:SA_Peru_1 - `12`:NA_Mexico_1 - `13`:SA_Brazil_1 - `14`:LA_South_2 - `15`:SA_Chile_1 当 `vendor` = 8,即第三方云存储为百度智能云时,`region` 可取如下值: - `1`:Baoding - `2`:Suzhou - `3`:Guangzhou - `4`:Hongkong - `5`:Singapore - `6`:Wuhan - `7`:Shanghai 当 `vendor` = 11,即第三方云存储为其他 S3 协议云存储时,无需设置 `region` 字段,即使设置也不生效。 ## 媒体流输出模式设置 [#媒体流输出模式设置] 本节介绍媒体流输出模式。 调用 [`start`](/zh-CN/api-reference/api-ref/cloud-recording/start) 开启单流录制时,你可以在 `clientRequest` 字段中的 `recordingConfig.streamMode` 字段设置媒体流的输出模式。`streamMode` 的支持取值和各模式对比如下: | streamMode | 描述 | 生成索引文件 | 生成切片文件 | 视频编码 | 音频编码 | 支持的功能 | | --- | --- | --- | --- | --- | --- | --- | | `default` | 默认模式 | 每个 UID 生成一个 M3U8 音频索引文件和一个 M3U8 视频索引文件。 | 每个 UID 生成多个 TS 音频切片文件和多个 TS 视频切片文件。如果在 Web 端使用 VP8 编码,则生成多个 TS 音频切片文件和多个 WebM 格式的视频切片文件。 | 不转码 | 转码 | 单流录制、云端截图。 | | `standard` | 标准模式 | 每个 UID 生成一个 M3U8 音频索引文件、一个 M3U8 视频索引文件和一个合并的 M3U8 音视频索引文件。如果在 Web 端使用 VP8 编码,则生成一个合并的 MPD 音视频索引文件。 | 每个 UID 生成多个 TS 音频切片文件和多个 TS 视频切片文件。 如果在 Web 端使用 VP8 编码,则生成多个 WebM 格式的音频文件和多个 WebM 格式的视频文件。 | 不转码 | 转码 | 单流录制、云端截图。 | | `original` | 原始模式。仅订阅音频时(`streamTypes` 为 `0`)时该字段生效。 | 每个 UID 生成一个 M3U8 音频索引文件。 | 每个 UID 生成多个 TS 音频切片文件。 | 无 | 不转码 | 单流音频不转码录制。 | ## 常用视频属性 [#常用视频属性] 单流录制模式下,录制输出的视频属性(分辨率、帧率、码率等)与用户的原始视频属性一致,无法修改。 合流录制模式下,你可以通过 `transcodingConfig` 字段设置录制输出的视频属性。声网推荐你使用默认值。你也可以参考下表设值。如果设置的码率超出合理范围,声网服务器会在合理区间内自动调整码率。 | 分辨率(宽 × 高) | 帧率 (fps) | 通信场景下码率 (Kbps) | 直播场景下码率 (Kbps) | | --------------- | -------- | ------------------------- | ------------------------- | | 160 × 120 | 15 | 65 | 130 | | 120 × 120 | 15 | 50 | 100 | | 320 × 180 | 15 | 140 | 280 | | 180 × 180 | 15 | 100 | 200 | | 240 × 180 | 15 | 120 | 240 | | 320 × 240 | 15 | 200 | 400 | | 240 × 240 | 15 | 140 | 280 | | 424 × 240 | 15 | 220 | 440 | | 640 × 360 | 15 | 400 | 800 | | 360 × 360 | 15 | 260 | 520 | | 640 × 360 | 30 | 600 | 1200 | | 360 × 360 | 30 | 400 | 800 | | 480 × 360 | 15 | 320 | 640 | | 480 × 360 | 30 | 490 | 980 | | 640 × 480 | 15 | 500 | 1000 | | 480 × 480 | 15 | 400 | 800 | | 640 × 480 | 30 | 750 | 1500 | | 480 × 480 | 30 | 600 | 1200 | | 848 × 480 | 15 | 610 | 1220 | | 848 × 480 | 30 | 930 | 1860 | | 640 × 480 | 10 | 400 | 800 | | 1280 × 720 | 15 | 1130 | 2260 | | 1280 × 720 | 30 | 1710 | 3420 | | 960 × 720 | 15 | 910 | 1820 | | 960 × 720 | 30 | 1380 | 2760 | | 1920 × 1080 | 15 | 2080 | 4160 | | 1920 × 1080 | 30 | 3150 | 6300 | ## 订阅名单设置 [#订阅名单设置] 默认情况下,云端录制会订阅频道内所有发布的音视频流。你也可以使用 API 进行灵活的用户 ID 订阅。此外,你还可以分别设置音频和视频的订阅白名单或黑名单,并在录制过程中更新订阅名单: - 在开始录制时:你可以通过 [`start`](/zh-CN/api-reference/api-ref/cloud-recording/start) 方法中的相关字段设置订阅的黑白名单。 - 在录制过程中:你可以通过 [`update`](/zh-CN/api-reference/api-ref/cloud-recording/update) 方法中的 `streamSubscribe` 字段更新订阅名单。 ### 音频订阅名单 [#音频订阅名单] 云端录制提供了如下字段用来设置音频订阅名单。你可以根据场景需要**选择其中一个字段**进行设置。 - `subscribeAudioUids`:通过用户 ID 指定要订阅的音频流,即音频订阅白名单。 - `unSubscribeAudioUids`:指定不订阅的音频流,即音频订阅黑名单。 :::warning[注意] `subscribeAudioUids` 和 `unSubscribeAudioUids` 不可以同时设置。 ::: ### 视频订阅名单 [#视频订阅名单] 云端录制提供了如下字段用来设置视频订阅名单。你可以根据场景需要**选择其中一个字段**进行设置。 - `subscribeVideoUids`:通过用户 ID 指定要订阅的视频流,即视频订阅白名单。 - `unSubscribeVideoUids`:指定不订阅的视频流,即视频订阅黑名单。 :::warning[注意] `subscribeVideoUids` 和 `unSubscribeVideoUids` 不可以同时设置。 ::: ### 示例说明 [#示例说明] 假设录制开始时,频道内共有 `111`、`222`、`333`、`444` 四个用户,中途又进入两个用户 ID 未知的其他用户。下表列出了几种常见的订阅方式以及推荐的字段设置。 | 订阅方式 | 推荐字段设置 | | :----------------------------------------- | :----------------------------------------------------------- | | 订阅全部音频流和视频流 | 无需设置订阅相关字段。 | | 订阅全部音频流,只订阅 `111` 和 `222` 的视频流 | `subscribeAudioUids`: `["#allstream#"]` `subscribeVideoUids: ["111","222"]` | | 订阅全部音频流,不订阅 `111` 和 `222` 的视频流 | `subscribeAudioUids: ["#allstream#"]` `unSubscribeVideoUids: ["111","222"]`。云端录制会订阅全部音频流以及 `333`、`444` 和两个用户 ID 未知的其他用户的视频流。 | | 订阅全部音频流,不订阅视频流 | `subscribeAudioUids: ["#allstream#"]`。将 `streamTypes` 设置为 `0`,也可达到同样的效果。 | | 不订阅 `222` 的音频流,只订阅 `111` 的视频流 | `unSubscribeAudioUids: ["222"]` `subscribeVideoUids: ["111"]`。云端录制会订阅 `111`、`333`、`444` 和两个用户 ID 未知的其他用户的音频流,以及 `111` 的视频流。 | :::info[信息] 上述示例中的 `["#allstream#"]` 为通配符,指频道内所有用户 ID。 ::: ### 开发注意事项 [#开发注意事项] 在设置订阅名单时,你还需要关注如下注意事项: - 音频和视频订阅需要的单独设置。如果你仅设置了音频的订阅名单,但没有设置视频的订阅名单,云端录制服务不会订阅任何视频流。反之亦然。 - 如果 `recordingConfig` 中的 `streamTypes` 为 `0`(只订阅音频),则不可设置视频订阅名单; 如果 `recordingConfig` 中的 `streamTypes` 为 `1`(只订阅视频),则不可设置音频订阅名单。 - 当订阅的用户 ID 超过 17 人时,云端录制会按用户 ID 加入频道的时间顺序,订阅前 17 个用户 ID 的视频。当某个订阅的用户 ID 离开频道,云端录制会自动订阅第 18 个加入频道的用户 ID,以此类推。