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

使用状況ノート

ビデオリソースは、この操作を使用して変更する前に、制作スタジオに追加されている必要があります。

QPS制限

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

デバッグ

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

リクエストパラメーター


パラメーター	データ型	必須／任意	例	説明
操作	String	必須	ModifyCasterVideoResource	実行したい操作。値をModifyCasterVideoResourceに設定します。
CasterId	String	必須	9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****	制作スタジオのID。 CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。 ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。制作スタジオ > 制作スタジオ管理注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
ResourceId	String	必須	05ab713c-676e-49c0-96ce-cc408da1 ****	ビデオリソースのID。 AddCasterVideoResource 操作を呼び出すと、ResourceIdパラメーターに反映されます。
RegionId	String	任意	cn-shanghai	リージョンの ID
ResourceName	String	任意	test001	ビデオリソースの名前。
LiveStreamUrl	String	任意	rtmp:// ** .aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201? auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5 **	ライブストリームのURL。このパラメーターは有効で、ビデオリソースがライブストリームの場合にのみ必要です。
MaterialId	String	任意	f080575eb5f4427684fc0715159a ****	マテリアルのID。
VodUrl	String	任意	http://developer.aliyundoc.com/AppName/StreamName.flv	ビデオオンデマンド (VOD) ファイルのURL。このパラメータは、ビデオリソースがメディアライブラリからのものではないビデオファイルである場合にのみ有効になります。注 VODファイルは、MP4、FLV、またはTS形式でなければなりません。
BeginOffset	Integer	任意	0	システムがビデオリソースの読み取りを開始する位置のオフセット。このパラメーターは、ビデオリソースがビデオファイルの場合にのみ有効です。単位：ミリ秒。注 0より大きい値は、第1のフレームからのオフセットを示す。
EndOffset	Integer	任意	10,000	このパラメーターは、ビデオリソースがビデオファイルの場合にのみ有効です。単位：ミリ秒。 0を超える値は、第1のフレームからのオフセットを示す。 0未満の値は、最終フレームからのオフセットを示す。
RepeatNum	Integer	任意	0	最初の再生が完了した後の再生回数。このパラメーターは、ビデオリソースがファイルの場合にのみ有効です。設定可能な値は以下のとおりです。 0: ビデオが1回だけ再生されることを示します。これはデフォルト値です。 -1: ビデオがループモードで再生されることを示します。
PtsCallbackInterval	Integer	任意	2,000	プレゼンテーションタイムスタンプ (PTS) コールバックの間隔。単位：ミリ秒。このパラメーターは、ビデオリソースがVODファイルの場合にのみ有効です。

レスポンスパラメーター


パラメーター	データ型	例	説明
RequestId	String	CF60DB6A-7FD6-426E-9288-122CC1A52FA7	リクエストの ID です。
CasterId	String	9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****	制作スタジオのID。
ResourceId	String	98461064-1c94-4dc1-85ce-94098764 ****	ビデオリソースのID。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=ModifyCasterVideoResource
&CasterId=9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****
&ResourceId=05ab713c-676e-49c0-96ce-cc408da1 ****
&<共通リクエストパラメーター>

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

XML 形式

<ModifyCasterVideoResourceResponse>
      <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
      <CasterId>9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****</CasterId>
      <ResourceId>98461064-1c94-4dc1-85ce-94098764 ****</ResourceId>
</ModifyCasterVideoResourceResponse>

JSON 形式

{
    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7" 、
    "CasterId": "9ff2d96b-37ef-40a3-8cb0-4c7b1e2e ****" 、
    "ResourceId": "98461064-1c94-4dc1-85ce-94098764 ****"
}

エラーコード

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