カルーセル再生用のプロダクションスタジオにエピソードリストを追加します。

使用状況ノート

リクエストには、CallbackUrlパラメーターとDomainNameパラメーターが必要です。 DescribeCasterConfig を呼び出して値を取得できます。

QPS limit

1人のユーザーが1秒あたり最大4クエリ (QPS) を実行できます。 Throttling is triggered when the number of calls per second exceeds the QPS limit. スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター

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

実行したい操作。 値をAddCasterEpisodeGroupに設定します。

CallbackUrl String 必須 http://developer.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201 ****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f ****

コールバックURL。

DescribeCasterConfig 操作を呼び出して、CallbackUrlを取得できます。

ClientTokend String 必須 8751ad99-2ddb-4aac-ad44-84b21102 ****

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。
DomainName String 必須 example.com

メインのストリーミングドメイン。
RepeatNum Integer 必須 0

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

  • 0: エピソードリストが1回だけ再生されることを示します。
  • -1: エピソードリストがループモードで再生されることを示します。
SideOutputUrl String 必須 http:// ****/aliyundoc.com:8000/caster/4a82a3d1b7f0462ea37348366201 ****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f ****

カスタムスタンバイURL。

このパラメーターが空の場合、Alibaba Cloudによって自動的に生成された出力アドレスに対応する取り込みアドレスがデフォルトで使用されます。
StartTime String 必須 2018-03-06T19:00:00Z

エピソードリストが再生を開始する時間。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

RegionId String 任意 cn-shanghai

リージョンの ID
Item.N.ItemName String 任意 エピソード1

エピソードNの名前。
アイテムN.VodUrl String 任意 http:// ****/demo.aliyundoc.com:8000/caster/4a82a3d1b7f0462ea37348366201 ****.flv?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f ****

VODファイルのURL。

DeleteCasterVideoResource を介してプロダクションスタジオのビデオソースを照会する場合は、DescribeCasterVideoResourcesインターフェイス呼び出しによって返されたVodUrlパラメーター値を確認してください。

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

ビデオファイルは、MP4、FLV、またはTS形式である必要があります。

レスポンスパラメーター

パラメーター データ型 例 説明
ItemIds List ["21926b36-7dd2-4fde-ae25-51b5bc8e ****", "21926b36-7dd2-4fde-ae25-51b5bc98 ****"]

リスト内のエピソードのID。
ProgramId String 16A96B9A-F203-4EC5-8E43-CB92E68X ****

The ID of the episode list that was added. 追加するプログラムの管理に使用できるIDを記録します。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=AddCasterEpisodeGroup
&CallbackUrl=http://developer.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201 ****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f ****
&ClientToken=8751ad99-2ddb-4aac-ad44-84b21102 ****
&DomainNam e=example.com
&RepeatNum=0
&SideOutputUrl=rtmp:// guide.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****?auth_key=1608953344-0-0-53f0758162964516ac850f2ddc3f****
&StartTime=2018-03-06T19:00:00Z
&<共通リクエストパラメーター>

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

XML 形式 

<AddCasterEpisodeGroupResponse>
      <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
      <ProgramId>16A96B9A-F203-4EC5-8E43-CB92E68X ****</ProgramId>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc8e ****</ItemIds>
      <ItemIds>21926b36-7dd2-4fde-ae25-51b5bc98 ****</ItemIds>
</AddCasterEpisodeGroupResponse>

JSON 形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "ProgramId": "16A96B9A-F203-4EC5-8E43-CB92E68X ****" 、
    "ItemIds": [
      "21926b36-7dd2-4fde-ae25-51b5bc8e ****" 、
      "21926b36-7dd2-4fde-ae25-51b5bc98 ****"
    ]
}

エラーコード

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