制作スタジオにビデオリソースを追加します。

使用状況ノート

  • ビデオリソースが追加される制作スタジオが作成されている必要があります。 方法については、CreateCasterを参照してください。
  • ビデオリソースの数は、制作スタジオの入力チャネルによって制限されます。

QPS制限

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

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 AddCasterVideoResource

システムはパラメータを指定します。 値: AddCasterVideoResource。

CasterId String 必須 9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****

制作スタジオのID。

CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。

ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。

制作スタジオ > 制作スタジオ管理

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
ResourceName String 必須 test001

ビデオリソースの名前。
RegionId String 任意 cn-shanghai

リージョンの ID
LocationId String 任意 RV01

制作スタジオ内のビデオリソースのロケーションID。

このパラメーターは、制作スタジオでビデオリソースを配置するレイヤーを指定します。 各ロケーションIDは、1つのビデオリソースのみに割り当てることができ、RV[Number] フォーマットでなければならない。 このパラメーターで指定する値は、RV01 ~ RV12のように昇順である必要があります。 番号は の範囲内でなければなりません。

LiveStreamUrl String 任意 rtmp:// **** -demo.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****? auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5 ****

ライブストリームのURL。 このパラメーターは、ビデオリソースがライブストリームの場合に必要です。

注 ビデオリソースがライブストリームでない場合は、リクエストにこのパラメーターを指定しないでください。
StreamId String 任意 faaa9a6b-1234-1a20-2345-874378483 ****

ライブストリームのID。
MaterialId String 任意 f080575eb5f4427684fc0715159a ****

メディアライブラリのマテリアルのID。 このパラメータは有効であり、ビデオリソースがマテリアルである場合にのみ必要です。

DescribeCasterConfig インターフェイスを介してプロダクションスタジオの構成情報を照会する場合は、DescribeCasterConfigインターフェイス呼び出しによって返されるUrgentMaterialId値を確認してください。

VodUrl String 任意 http://developer.aliyundoc.com/AppName/StreamName.flv

ビデオオンデマンド (VOD) ファイルのURL。 このパラメータは、ビデオリソースがメディアライブラリからのものではないビデオファイルである場合にのみ有効になります。

注 VODファイルは、MP4、FLV、またはTS形式でなければなりません。
BeginOffset Integer 任意 1,000

システムがビデオリソースの読み取りを開始する位置のオフセット。 このパラメーターは、ビデオリソースがビデオファイルの場合にのみ有効です。 単位：ミリ秒。

注 0より大きい値は、最初のフレームからのオフセットを示す。
EndOffset Integer 任意 10,000

システムがビデオリソースの読み取りを停止する位置のオフセット。 このパラメーターは、ビデオリソースがビデオファイルの場合にのみ有効です。 単位：ミリ秒。

  • 0より大きい値は、最初のフレームからのオフセットを示す。
  • 0未満の値は、最後のフレームからのオフセットを示します。
RepeatNum Integer 任意 0

最初の再生が完了した後にビデオリソースが繰り返される回数。 設定可能な値は以下のとおりです。

  • 0: ビデオリソースが1回だけ再生されることを示します。 これはデフォルト値です。
  • -1: ビデオリソースがループモードで再生されることを示します。

このパラメーターは、ビデオリソースがビデオファイルの場合にのみ有効です。
PtsCallbackInterval Integer 任意 2,000

プレゼンテーションタイムスタンプ (PTS) コールバックの間隔。 単位：ミリ秒。
注 ビデオリソースのタイプは、ライブストリームURLによって示される。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

リクエストの ID です。
ResourceId String e5542d98-b08c-46bf-83e9-5b09d08c ****

ビデオリソースのID。 このIDは、追加されるビデオリソースの管理に使用できるものとして記録します。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=AddCasterVideoResource
&CasterId=9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****
&ResourceName=test001
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<AddCasterVideoResourceResponse>
      <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
      <ResourceId>e5542d98-b08c-46bf-83e9-5b09d08c ****</ResourceId>
</AddCasterVideoResourceResponse>

JSON 形式 

{
  "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7" 、
  "ResourceId": "e5542d98-b08c-46bf-83e9-5b09d08c ****"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。