需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

云端录制存储参数参考

更新时间不可用

查看云端录制的云端录制存储参数参考，了解关键概念、参数说明、使用限制和接入注意事项。

第三方云存储地区说明

使用自定义录制和自定义截图功能时，你可以通过 StorageConfig 进行录制文件和截图文件的第三方云存储配置，其中 vendor 字段（第三方云存储平台）的取值决定了 region 字段（第三方云存储地区）的取值。

本文介绍 vendor 的不同取值下，region 字段可以配置的值。

当 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

详见阿里云参考文档。

当 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 开启单流录制时，你可以在 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 × 1201565130
120 × 1201550100
320 × 18015140280
180 × 18015100200
240 × 18015120240
320 × 24015200400
240 × 24015140280
424 × 24015220440
640 × 36015400800
360 × 36015260520
640 × 360306001200
360 × 36030400800
480 × 36015320640
480 × 36030490980
640 × 480155001000
480 × 48015400800
640 × 480307501500
480 × 480306001200
848 × 480156101220
848 × 480309301860
640 × 48010400800
1280 × 7201511302260
1280 × 7203017103420
960 × 720159101820
960 × 7203013802760
1920 × 10801520804160
1920 × 10803031506300
表格内容超出当前宽度，可横向滚动查看更多列。

订阅名单设置

默认情况下，云端录制会订阅频道内所有发布的音视频流。你也可以使用 API 进行灵活的用户 ID 订阅。此外，你还可以分别设置音频和视频的订阅白名单或黑名单，并在录制过程中更新订阅名单：

  • 在开始录制时：你可以通过 start 方法中的相关字段设置订阅的黑白名单。

  • 在录制过程中：你可以通过 update 方法中的 streamSubscribe 字段更新订阅名单。

音频订阅名单

云端录制提供了如下字段用来设置音频订阅名单。你可以根据场景需要选择其中一个字段进行设置。

  • subscribeAudioUids：通过用户 ID 指定要订阅的音频流，即音频订阅白名单。
  • unSubscribeAudioUids：指定不订阅的音频流，即音频订阅黑名单。

注意

subscribeAudioUids 和 unSubscribeAudioUids 不可以同时设置。

视频订阅名单

云端录制提供了如下字段用来设置视频订阅名单。你可以根据场景需要选择其中一个字段进行设置。

  • subscribeVideoUids：通过用户 ID 指定要订阅的视频流，即视频订阅白名单。
  • unSubscribeVideoUids：指定不订阅的视频流，即视频订阅黑名单。

注意

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 的视频流。
表格内容超出当前宽度，可横向滚动查看更多列。

信息

上述示例中的 ["#allstream#"] 为通配符，指频道内所有用户 ID。

开发注意事项

在设置订阅名单时，你还需要关注如下注意事项：

  • 音频和视频订阅需要的单独设置。如果你仅设置了音频的订阅名单，但没有设置视频的订阅名单，云端录制服务不会订阅任何视频流。反之亦然。
  • 如果 recordingConfig 中的 streamTypes 为 0（只订阅音频），则不可设置视频订阅名单； 如果 recordingConfig 中的 streamTypes 为 1（只订阅视频），则不可设置音频订阅名单。
  • 当订阅的用户 ID 超过 17 人时，云端录制会按用户 ID 加入频道的时间顺序，订阅前 17 个用户 ID 的视频。当某个订阅的用户 ID 离开频道，云端录制会自动订阅第 18 个加入频道的用户 ID，以此类推。

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利