制作スタジオのチャンネルを設定します。
使用状況ノート
リクエストにはChannelIdパラメーターが必要です。
QPS制限
1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須／任意 | 例 | 説明 |
|---|---|---|---|---|
| 操作 | String | 必須 | SetCasterChannel |
実行したい操作。 値をSetCasterChannelに設定します。 |
| CasterId | String | 必須 | a2b8e671-2fe5-4642-a2ec-bf93880e **** |
制作スタジオのID。 CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。 ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。 制作スタジオ > 制作スタジオ管理 注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
|
| ChannelId | String | 必須 | RV01 |
チャンネルの ID。 DescribeCasterChannels 操作を呼び出してIDを取得できます。 チャネルが有効になると、レイアウトはチャネルIDを参照します。 1つのチャンネルに最大1つのビデオリソースを指定できます。 ビデオリソースの数は、制作スタジオのチャンネル数によって制限されます。 値は、RV01やRV12などのRV[Number] 形式でなければなりません。 |
| RegionId | String | 任意 | cn-shanghai |
リージョンの ID |
| ResourceId | String | 任意 | 16A96B9A-F203-4EC5-8E43-CB92E68F **** |
ビデオリソースのID。 AddCasterVideoResource 操作を呼び出したときの応答に含まれます。 |
| SeekOffset | Integer | 任意 | 1,000 |
システムがビデオリソースの読み取りを開始する位置のオフセット。 値は0より大きくなければなりません。これは、最初のフレームからのオフセットを示します。 このパラメーターはライブストリームでは有効になりません。 単位: ミリ秒。 |
| 再生ステータス | Integer | 任意 | 1 |
再生ステータス。 このパラメーターは、ビデオリソースがファイルの場合にのみ有効です。 設定可能な値は以下のとおりです。
|
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
|---|---|---|---|
| RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
リクエストの ID です。 |
例
リクエストの例
http(s):// live.aliyuncs.com/?Action=SetCasterChannel
&CasterId=a2b8e671-2fe5-4642-a2ec-bf93880e ****
&ChannelId=RV01
&ResourceId=16A96B9A-F203-4EC5-8E43-CB92E68F ****
&<共通リクエストパラメーター>正常に処理された場合のレスポンス例
XML 形式
<SetCasterChannelResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</SetCasterChannelResponse>JSON 形式
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。