AddCasterVideoResource - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

使用状況ノート

ビデオリソースが追加される制作スタジオが作成されている必要があります。方法については、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 エラーセンター」をご参照ください。