制作スタジオのチャンネルを設定します。

使用状況ノート

リクエストにはChannelIdパラメーターが必要です。

QPS制限

1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 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

再生ステータス。 このパラメーターは、ビデオリソースがファイルの場合にのみ有効です。 設定可能な値は以下のとおりです。

  • 1: ビデオが再生されていることを示します。 これはデフォルト値です。
  • 0: 再生が一時停止していることを示します。

レスポンスパラメーター

パラメーター データ型 例 説明
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 エラーセンター」をご参照ください。