输入在线媒体流 RESTful API
你可以通过 RESTful API 创建云端播放器，将一路在线媒体流作为直播视频源输入到声网频道内。输入成功后，该媒体流会在声网频道内自动播放，供频道内的远端用户欣赏。
开通服务
第一次使用输入在线媒体流，需要在声网控制台开通服务，步骤如下：
- 登录控制台，在项目管理页面，选择需要开通输入在线媒体流服务的项目，点击编辑按钮进入编辑项目页面。
- 在编辑项目页面的实时互动拓展能力模块找到输入在线媒体流，点击启用。
- 点击开启输入在线媒体流。
- 点击应用。
开通成功后你可以在用量页面看到输入在线媒体流的使用情况。
通过 Basic HTTP 认证
声网 RESTful API 要求 Basic HTTP 认证。每次发送 HTTP 请求时，都必须在请求头部填入 Authorization 字段。关于如何生成该字段的值，请参考 RESTful API 认证。
工作原理
输入一路在线媒体流至声网频道内播放相当于创建了一个云端播放器（cloud player）。用户可以通过 RESTful API 控制云端播放器，实现对该媒体流的控制：
Create：在项目中创建一个云端播放器。Delete：在项目中销毁一个云端播放器。Update：更新指定的云端播放器。List：分页列出该项目中所有云端播放器。
Create：创建云端播放器
HTTP 请求
POST https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players路径参数
appId：String 型必填参数。声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。region: String 型必填参数。创建Player的区域。声网支持分区域创建Player，目前支持以下区域：cn：中国大陆ap：除中国大陆以外的亚洲区域na：北美eu：欧洲
region 与你的媒体流源站在同一个区域。region 的值为小写。查询参数
使用 Query Parameters 时的请求 URL 示例：
https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players?streamIp={streamIp}streamIp ：String 型可选参数。媒体流源站 IP 地址。必须使用有效的 IPv4 地址。该参数可以保障媒体流的传输质量：
- 如果源媒体流只在
region区域内的部分区域提供服务，请使用该参数。 - 如果源媒体流可在
region区域内的广泛的区域提供服务，请忽略该参数。
请求头部
Content-Type：application/jsonAuthorization：该字段的值需参考认证说明。X-Request-ID：UUID（通用唯一识别码），标识本次请求。传入该字段后，声网服务器会在响应 header 中返回该字段。
X-Request-ID 赋值。如果用户不赋值，声网服务器会自动生成一个 UUID 传入。请求包体
请求包体为 JSON Object 类型的 player 字段，包含如下字段：
null 或 ""。uid：（可选）Number 类型。云端播放器在声网频道内的用户 UID。取值范围为 0 到（232-1）。取值 0 时，声网服务器自动为 player 分配一个 UID。该字段和account二选一必填。如果不设置用户名（UID 或 Account），该云端播放器不能创建，声网服务器会返回400(Bad Request)的状态码。请确保该值与频道内其他用户、云端播放器的 UID 都不同，否则影响播放质量。account：（可选）String 类型。云端播放器在声网频道内的用户 Account。使用该字段前请先阅读如何使用 String 型用户名。该字段不能超过 255 字节，也不能为空字符串。支持的字符集范围（共 89 个字符）如下：- 所有小写英文字母（a-z）
- 所有大写英文字母（A-Z）
- 数字 0-9
- 空格
- "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","
该字段和uid二选一必填。如果不设置用户名（UID 或 Account），该云端播放器不能创建，声网服务器会返回400(Bad Request)的状态码。请确保该值与频道内其他用户、云端播放器的 Account 都不同，否则影响播放质量。channelName：（必填）String 类型。声网频道名称。字符串长度必须在 64 字节以内，支持以下字符集（共 89 个字符）：- 所有小写英文字母（a-z）
- 所有大写英文字母（A-Z）
- 数字 0-9
- 空格
- "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ","
token：（可选）String 类型。云端播放器在声网频道内使用的动态密钥。如在声网控制台未启用 App 证书，则不需要向token传值；如在声网控制台已启用 App 证书，则必须传入token：idleTimeout：（可选）Number 类型。云端播放器处于空闲状态的最大时长（秒），即媒体流为非播放状态的最大时长。空闲状态超过设置的idleTimeout后，该播放器会自动销毁。取值范围为 5 到 600。默认值为 300。如果取值小于 5，声网服务器会自动调整为 5；如果取值大于 600，声网服务器会自动调整为 600。audioOptions：（可选）JSON Object 类型。云端播放器的音频转码配置。将该字段设置为空或不设置则表示使用默认设置。Profile：Number 类型。音频场景。用于设置音频采样率、码率、编码模式和声道数。0：默认设置。- 通信场景下，该选项代表指定 32 kHz 采样率，语音编码，单声道，编码码率最大值为 18 Kbps。
- 直播场景下，该选项代表指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 64 Kbps。
1：SPEECH_STANDARD。指定 32 kHz 采样率，语音编码, 单声道，编码码率最大值为 18 Kbps。2：MUSIC_STANDARD。指定 48 kHz 采样率，音乐编码, 单声道，编码码率最大值为 64 Kbps。3：MUSIC_STANDARD_STEREO。指定 48 kHz采样率，音乐编码, 双声道，编码码率最大值为 80 Kbps。4：MUSIC_HIGH_QUALITY。指定 48 kHz 采样率，音乐编码, 单声道，编码码率最大值为 96 Kbps。5：MUSIC_HIGH_QUALITY_STEREO。指定 48 kHz 采样率，音乐编码, 双声道，编码码率最大值为 128 Kbps。
volume：Number 类型，云端播放器的的音量大小。取值范围 [0,200]。默认值为 100，表示原始音量。
videoOptions：（可选）JSON Object 类型。云端播放器的视频转码配置。将该字段设置为空或不设置则表示使用默认设置。width：Number 类型。输出视频宽度 (pixel)。取值范围为 [66,1920]。默认值为源媒体流的视频宽度。height：Number 类型。输出视频高度 (pixel)。取值范围为 [66,1080]。默认值为源媒体流的高度宽度。widthHeightAdaption：Bool 类型。是否开启横竖屏自适应模式：true：开启横竖屏自适应模式。成功开启后，如果源媒体流为横屏模式，则输出视频宽度和高度为 1280 × 720；如果源媒体流为竖屏模式，则输出视频宽度和高度为 720 × 1280。false：（默认）不开启横竖屏自适应模式。
frameRate：Number 类型。输出视频的编码帧率 (fps)。取值范围为 [1,30]。默认值为 15。详见输出视频参考表。bitrate：Number 类型。输出视频的编码码率 (Kbps)。取值范围为 [1,10000]。详见输出视频参考表。默认值为标准码率，即声网依据当前频道场景、分辨率、帧率为你设置的最合适的码率。codec：String 类型。输出视频的编码格式。目前仅支持且默认为标准 H.264。
如果设置为其他值，则默认为 H.264 视频编码格式。fillMode：String 类型。视频画面的显示方式：fit：（默认）等比缩放视频，直到画面在视窗内完整显示。fill：等比缩放视频，直至充满视窗。
streamUrl：（必填）String 类型。在线媒体流 URL 地址。必须为有效的 HTTP/HTTPS/RTMP/HLS 地址，且长度在 1024 个字符以内。如需发布图片到声网频道，则设置streamUrl为你需要发布的图片 URL，云端播放器会将图片转换为视频，并发布到声网频道。目前支持 JPEG 和 PNG 格式的图片。你可以通过videoOptions设置视频转码相关参数。playTs：（可选）Number 类型。云端播放器开始播放在线媒体流时的 Unix 时间戳（秒）。假设云端播放器创建时的 Unix 时间戳是 T，playTs的取值范围为 [T - 86400,T + 300]。默认值为 0，代表云端播放器在创建成功时自动播放在线媒体流。假设playTs取值为 S：- 当 S = T 或 0 时，云端播放器在创建成功时自动播放在线媒体流。
- 当 S > T 时，云端播放器会在 S 时刻开始播放在线媒体流。这种取值方式适用于定时播放。
- 当 S < T 时，如果在线媒体流是直播流，云端播放器在创建成功时直接播放直播流；如果在线媒体流是点播流，云端播放器会从 T - S 时刻（秒）的位置开始播放点播流。这种取值方式适用于应对云端播放器运行出错的场景。举例来说，如果云端播放器 A 在运行中出错，你可以重新创建一个云端播放器 B 并将
playTs字段设为云端播放器 A 开始播放在线媒体流时的 Unix 时间戳。
name：（可选）String 类型。云端播放器的名字。长度必须在 64 个字符以内，支持的字符集范围为：- 所有小写英文字母（a-z）
- 所有大写英文字母（A-Z）
- 数字 0-9
- "-", "_"
不传值时，name为空。同一时间，一个项目下可以有多个name为空的云端播放器。同一时间，一个项目下不允许出现重名的云端播放器，用户尝试创建同名的云端播放器时会收到响应状态码409(Conflict)。encryptMode：（可选）String 类型。内置加密模式。声网推荐使用aes-128-gcm2或aes-256-gcm2加密模式。这两种模式支持使用盐，安全性更高。aes-128-xts：128 位 AES 加密，XTS 模式。aes-256-xts：256 位 AES 加密，XTS 模式。aes-128-ecb：128 位 AES 加密，ECB 模式。sm4-128-ecb：128 位 SM4 加密，ECB 模式。aes-128-gcm：128 位 AES 加密，GCM 模式。aes-256-gcm：256 位 AES 加密，GCM 模式。aes-128-gcm2：128 位 AES 加密，GCM 模式。 相比于aes-128-gcm加密模式，aes-128-gcm2加密模式安全性更高且需要设置盐（encryptKdfSalt）。aes-256-gcm2：256 位 AES 加密，GCM 模式。相比于aes-256-gcm加密模式，aes-256-gcm2加密模式安全性更高且需要设置盐（encryptKdfSalt）。
encryptKey：String 型可选参数。内置加密密钥，字符串类型，长度无限制。声网推荐使用 32 字节的密钥。如果未指定该参数或将该参数设置为空，则无法启用内置加密。encryptKdfSalt：String 型可选参数。盐，长度为 32 字节。声网推荐你在服务端使用 OpenSSL 随机生成 Base64 编码的盐，详见媒体流加密。只有在 aes-128-gcm2 或 aes-256-gcm2 加密模式下，该参数才生效。repeatTime：（可选）Int 类型。播放媒体流次数。该参数仅适用于点播流。可设为：1：（默认）播放媒体流一次。-1：循环播放媒体流。n：自定义播放媒体流次数。整型，不可设置为 0。
seekPosition：（可选）Number 类型。指定点播文件的播放位置（秒）。默认值为 0，表示从点播文件起始位置播放。必须小于音视频时长。dataStreamOptions：（可选）JSON Object 类型。数据流配置，用于设置视频帧携带的 SEI 信息。该参数仅适用于点播流。enable：设置是否传入 DataStream 类型的 SEI 信息 。true：传入 DataStream 类型的 SEI 信息。false：（默认）不传入 DataStream 类型的 SEI 信息。
DataStream 是 protobuf 类型的数据流格式，示例如下：message PositionData { # 点播流文件的音视频长度（秒），1 表示该字段展示顺序为 1 int32 duration = 1; # 点播文件的播放位置（秒），2 表示该字段展示顺序为 2 int32 position = 2; # 播放点播文件的主播 UID，3 表示该字段展示顺序为 3 int32 uid = 3; }
HTTP 响应
所有可能的响应状态码详见状态码汇总表。
响应头部
X-Request-ID：UUID（通用唯一识别码），标识本次请求。该值为本次请求 header 中X-Request-ID。如果请求出错，请在日志中打印出该值，排查问题。
如果本次请求的响应状态码为401(Unauthorized)，那么响应 header 中无该字段。X-Resource-ID：UUID（通用唯一识别码），标识本次请求创建的云端播放器的 ID：- 响应状态码为 2XX 时， 该字段为本次创建的云端播放器的 ID。
- 响应状态码为
409(Conflict)时，代表本次创建的播放器名字已经存在的播放器名字重复，该字段为那个同名播放器的 ID。请检查并修改本次创建的播放器名字。 - 响应状态码为其他时，该字段为空，本次请求失败。
响应包体
如果状态码为 2XX，请求成功。Body 中包含如下字段：
player：JSON Object 类型，包含如下字段：uid：Number 型字段。返回设置的云端播放器在频道内的 UID。account：String 型字段。返回设置的云端播放器在频道内的用户 Account。id：String 型字段。云端播放器的 ID。它是声网服务器生成的一个 UUID（通用唯一识别码），标识已创建的一个云端播放器。createTs：Number 型字段。云端播放器创建的 Unix 时间戳（秒）。status：String 型字段。云端播放器的运行状态："idle"：播放未开始。"connecting"：声网服务器正在连接媒体流地址或正在探测音视频数据。"running"：正在播放。"failed"：声网服务器无法连接媒体流地址或该媒体流无法播放。
fields：String 型字段。JSON 编码方式的字段掩码，详见谷歌 protobuf FieldMask 文档。用于指定返回player字段的子集。在使用uid的示例中，fields指定了声网服务器返回player字段中的uid，id，createTS和status字段子集。
如果状态码不为 2XX，请求失败。Body 中包含 String 类型的 message 字段，描述失败的具体原因。
请求示例
下面展示自定义音频和视频转码配置的请求示例：
{
"player": {
"audioOptions": {
"profile": 1
},
"videoOptions": {
"width": 1920,
"height": 1080,
"frameRate": 15,
"bitrate": 400,
"codec": "H.264",
"gop": 30,
"fillMode": "fill"
},
"streamUrl": "rtmp://example.agora.io/live/class32/101",
"channelName": "class32",
"token": "2a784467d6",
"uid": 101,
"idleTimeout": 300,
"playTs": 1575508644,
"name": "test"
}
}响应示例
{
"player": {
"uid": 101,
"id": "2a784467d647bb87b60b719f6fa56317",
"createTs": 1575508644,
"status": "running"
},
"fields": "player.uid,player.id,player.createTs,player.status"
}Delete：销毁一个云端播放器
HTTP 请求
DELETE https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players/{id}路径参数
appId：String 型必填参数。声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。id：String 型必填参数。云端播放器的 ID。region: String 型必填参数。Cloud Player 所在的区域。必须与创建 Cloud Player 设置的region一致。
请求头部
Authorization：该字段的值需参考认证说明。X-Request-ID：UUID（通用唯一识别码），标识本次请求。传入该字段后，声网服务器会在响应 header 中返回该字段。
HTTP 响应
所有可能的响应状态码详见状态码汇总表。
Delete 一个已经销毁过的云端播放器，响应状态码也为 2XX。
响应头部
X-Request-ID：UUID（通用唯一识别码），标识本次请求。该值为本次请求 header 中X-Request-ID。如果请求出错，请在日志中打印出该值，排查问题。
如果本次请求的响应状态码为
401(Unauthorized)，那么响应 header 中无该字段。
X-Resource-ID：UUID（通用唯一识别码），标识本次请求销毁的云端播放器的 ID。同本次请求 URL 中传入的id值。
响应包体
如果状态码为 2XX，则请求成功。Body 为空。
如果状态码不为 2XX，请求失败。Body 中包含 String 类型的
message字段，描述失败的具体原因。
Update：更新指定的云端播放器
HTTP 请求
PATCH https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players/{playerid}路径参数
appId: String 型必填参数。声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。playerid: String 型必填参数。云端播放器的 ID。region: String 型必填参数。云端播放器所在的区域，必须与创建云端播放器设置的region一致。
查询参数
sequence：Number 型必填参数。Update 请求的序列号。取值需要大于或等于 0。请确保后一次 Update 请求的序列号大于前一次 Update 请求的序列号。序列号可以确保声网服务器按照你指定的最新配置来更新云端播放器。
声网推荐你在第一次调用 Update 时，将
sequence填0。在第二次调用 Update 时，将sequence填1。在第三次调用 Update 时，将sequence填2。依次类推。声网服务器会按照最新 Update 请求（即最大的序列号）更新云端播放器。
PATCH https://api.sd-rtn.com/{region}/v1/projects/{appId}/cloud-player/players/{playerid}?sequence={sequence}请求头部
Authorization：该字段的值需参考认证说明。X-Request-ID：UUID（通用唯一识别码），标识本次请求。传入该字段后，声网服务器会在响应 header 中返回该字段。
请求包体
你可以同时如下更新多个字段：
streamUrlisPauseaudioOptionsaudioOptions.volumeseekPosition
isPause：Bool 类型，是否暂停播放媒体流源文件：true：暂停播放媒体流源文件。false：（默认）播放播放媒体流源文件。
其他字段含义详见 Create 请求 body。
HTTP 响应
所有可能的响应状态码详见状态码汇总表。
响应头
X-Request-ID：UUID（通用唯一识别码），标识本次请求。该值为本次请求头中X-Request-ID。如果请求出错，请在日志中打印出该值，排查问题。如果本次请求的响应状态码不是 2XX，那么响应头中可能无该字段。
X-Resource-ID：UUID（通用唯一识别码），标识本次请求销毁的云端播放器的 ID。同本次请求 URL 中传入的id值。
响应包体
如果状态码为 2XX，则请求成功。Body 为空。
如果状态码不为 2XX，请求失败。Body 中包含 String 类型的
message字段，描述失败的具体原因。
请求示例
"player": {
"audioOptions": {
"volume": 10
},
"isPause": false,
"streamUrl": "http://XXXX",
"seekPosition": 40
}List：查询一个项目下所有云端播放器
HTTP 请求
GET https://api.sd-rtn.com/v1/projects/{appId}/cloud-player/players路径参数
appId：String 型必填参数。声网为每个开发者提供的 App ID。在声网控制台创建一个项目后即可得到一个 App ID。一个 App ID 是一个项目的唯一标识。
查询参数
使用 Query parameters 时的请求 URL 示例：
https://api.sd-rtn.com/v1/projects/{appId}/cloud-player/players?filter={filter}&pageSize={pageSize}&pageToken={pageToken}filter：String 型可选参数。指定过滤条件。声网服务器只列出该项目下符合过滤条件的云端播放器。目前的过滤条件为用户创建播放器时传入的channelName。假设用户频道名为class32，则将 URL 示例中filter={filter}改写为filter=channelName eq class32；假设用户频道名为bigclass，则将 URL 示例中filter={filter}改写为filter=channelName eq bigclass。eq 前后有空格，空格需按照 URL 规范进行 encode。
pageSize：Number 型可选参数。指定分页大小。取值范围为 1 到 500。默认值为 200，即如果不设值，声网服务器将列出单页内至多 200 个云端播放器。pageToken：String 型可选参数。指定页码，标明该页的次序。如果不设值，声网服务器将返回第一页。
推荐用法：
首次使用 List 时，不向该参数传值，得到首页的查询结果和声网服务器返回的nextPageToken值。下一次使用 List 时，将nextPageToken值传入pageToken查询下一页的云端播放器。
使用以上字段后，声网服务器会从指定项目中过滤出符合条件的云端播放器，根据指定的分页大小进行分页，返回指定页码的页面上所有云端播放器。云端播放器根据创建时间（createTs）升序排列。
请求头部
Authorization：该字段的值需参考认证说明。X-Request-ID：UUID（通用唯一识别码），标识本次请求。传入该字段后，声网服务器会在响应 header 中返回该字段。
HTTP 响应
所有可能的响应状态码详见状态码汇总表。
响应头部
X-Request-ID：UUID（通用唯一识别码），标识本次请求。该值为本次请求 header 中 X-Request-ID。如果请求出错，请在日志中打印出该值，排查问题。
响应包体
如果状态码为 2XX，则请求成功。Body 中包含如下字段：
totalSize：Number 型字段，符合查询条件的云端播放器数量。players：JSON Array 型字段，包含如下字段：个别 `player` 可能暂时只包含id，name，createTs三个字段，用户的程序需要能够处理这种情况。name：String 型字段。云端播放器的名字。streamUrl：String 型字段。在线媒体流 URL 地址。channelName：String 型字段。声网频道名称。uid：Number 型字段。云端播放器在声网频道内的用户 UID。account：String 型字段。云端播放器在声网频道内的用户 Account。id：String 型字段。云端播放器的 ID。它是声网服务器生成的一个 UUID（通用唯一识别码），标识已创建的一个云端播放器。createTs：Number 型字段。云端播放器创建的 Unix 时间戳（秒）。status：String 型字段。云端播放器的运行状态："idle"：播放未开始。"connecting"：声网服务器正在连接媒体流地址或正在探测音视频数据。"running"：正在播放。"failed"：声网服务器无法连接媒体流地址或该媒体流无法播放。
fields：String 型字段。JSON 编码方式的字段掩码，详见谷歌 protobuf FieldMask 文档。用于指定返回players数组中每个 player 中的字段子集。在使用uid的示例中，fields指定声网服务器返回players数组中每个 player 中的name,streamUrl,channelName,uid,id,createTs和status字段子集。nextPageToken：String 型字段。本次查询页面的下一页页码，方便用户下一次调用List方法继续查询。如果返回的该字段为空字符串，则本次请求已查询到最后一页。
如果状态码不为 2XX，请求失败。Body 中包含 String 类型的 message 字段，描述失败的具体原因。
响应示例
{
"totalSize": 10,
"players": [{
"name": "class32_101",
"streamUrl": "rtmp://example.agora.io/live/class32/101",
"channelName": "class32",
"uid": 101,
"id": "2a784467d647bb87b60b719f6fa56317",
"createTs": 1575508644,
"status": "running"
}, {
"name": "class68_422",
"streamUrl": "rtmp://example.agora.io/live/class68/422",
"channelName": "class68",
"uid": 422,
"id": "0b719f6fa563172a784467d647bb87b6",
"createTs": 1575588644,
"status": "connecting"
}],
"fields": "player.name,player.streamUrl,player.channelName,player.uid,player.id,player.createTs,player.status",
"nextPageToken": "7b60b719f"
}API 限流说明
声网服务器限制用户 API 调用速率，超出限制速率时会返回状态码 429(Too Many Requests)。
| API | 限流说明 |
|---|---|
Create |
name）的云端播放器时，每个不同名字的云端播放器的创建速率上限为 2 次/秒。name）的云端播放器时，云端播放器的创建速率上限为 50 次/ 秒。 |
Delete |
一个项目中，销毁云端播放器的速率上限为 100 次/秒。 |
List |
filter）时，查询速率上限为 2 次/秒 和 15 次/分钟。filter）时，查询速率上限为 10 次/秒和 20 次/分钟。 |
状态码汇总表
- 如果状态码为 2XX，则请求成功。
- 如果状态码不为 2XX，则请求失败。请根据对应的响应报文 Body 中的
message字段内容排查问题。
| 状态码 | 可能的 message 字段内容 |
|---|---|
| 200 OK | / |
| 400 Bad Request | |
| 401 Unauthorized | Invalid authentication credentials. |
| 403 Forbidden | |
| 404 Not Found | Resource is not found and destroyed. |
| 409 Conflict | Resource with the same name already exists. |
| 429 Too Many Requests | |
| 500 Unknown | Some internal error happened. Contact us to help fix it. |
| 503 Service Unavailable | |
| 504 Gateway Timeout | Gateway timeout. Query to check whether the player has been created, or to create another one instead. |
注意事项
本节总结使用输入在线媒体流 RESTful API 的基础注意事项：
- 请确保声网频道场景为直播。
- 如果你需要同一个频道内仅有一个云端播放器，请你务必使用
name参数，详见name参数解释。 - 如果你需要同一个频道内有多个云端播放器，请确保每个云端播放器的用户名 UID/Account 都是唯一的，详见
uid或account参数解释。 - 请确保将
region设置为媒体流源站所在区域，详见region参数解释。 - 云端播放器可能因为服务故障等原因自动销毁。声网推荐你开通消息通知服务，监听云端播放器事件。
- 使用
List方法时，响应 Body 中的players字段有时会仅包含id,name,CreateTs这三个字段，请确保你的业务逻辑能够处理这种情况。 - 使用
Create/Delete方法创建/销毁云端播放器，且响应状态码为504 Gateway Timeout时，请使用List方法查询该云端播放器的真实状况，以防止产生不受管理的云端播放器。 - 创建云端播放器并收到请求成功的响应报文后，需要等待约 10 秒再使用
List方法查询，否则可能查询不到任何信息。 - 请求出错时，请务必在日志中打印出响应 Header 中的
X-Request-ID和X-Resource-ID字段值，以方便排查问题。 - 最大并发任务数默认为 20，表示允许在一个项目下最多同时运行 20 个输入在线媒体流任务。如需更高配额，请联系技术支持。
- 针对网络故障，以及非声网云，软件，设施和不可抗力因素等因素导致的输入在线媒体流中断，声网为了保证更好的用户体验，提供自动故障迁移服务，该服务会在尽量短的时间内完成迁移(预计 4 分钟内)，迁移期间输入在线媒体流任务中断，可能导致部分数据丢失。如果对于频道内较多观众端的场景或关键性业务，你需要基于当前业务的重要性和声网提供的自动迁移时效性来考虑是否采用更高的质量保障，例如准备多路流保障以应对迁移期间的快速切换，或者可以采用退避重试策略主动迁移以减少迁移时间。
如需了解更多集成建议，请参考输入在线媒体流集成最佳实践。
