制作スタジオのビデオリソースを照会します。

使用状況ノート

The production studio being queried must have been created.

QPS制限

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

デバッグ

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

リクエストパラメーター

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

実行したい操作。 実行する操作です。 値をDescribeCasterVideoResourcesに設定します。

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

制作スタジオのID。

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

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

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

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
RegionId String 任意 cn-shanghai

リージョンの ID

レスポンスパラメーター

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

リクエストの ID です。
VideoResources VideoResourceの配列

ビデオリソース。
VideoResource
ResourceId String b5f8c837-ceeb-424f-b30b-68e94e86 ****

ビデオリソースのID。
ResourceName String resource-Name1

ビデオリソースの名前。
LocationId String RV01

ビデオリソースの場所。
LiveStreamUrl String rtmp:// abcLive/liveApp ****/b5447c21fcfe444c9e9b6f7ba208 ****

ライブストリームのURL。
MaterialId String d2c429cd907742ee8f6e76465ad3 ****

The ID of the material.
RepeatNum Integer 0

最初の再生が完了した後の再生回数。 This parameter takes effect only when the video resource is a file. 設定可能な値は以下のとおりです。

  • 0: indicates that the video is played only once. これはデフォルト値です。
  • -1: ビデオがループモードで再生されることを示します。
BeginOffset Integer 1,000

ビデオリソースが読み取られる開始位置のオフセット。 This parameter is returned only when the video resource is a file. 単位: ミリ秒。

0より大きい値は、最初のフレームからのオフセットを示す。

EndOffset Integer 10,000

The offset of the end position where the video resource is read. This parameter is returned only when the video resource is a file. Unit: milliseconds.

  • A value greater than 0 indicates an offset from the first frame.
  • A value smaller than 0 indicates an offset from the last frame.
PtsCallbackInterval Integer 0

プレゼンテーションタイムスタンプ (PTS) コールバックの間隔。 If you set the value to 0, the PTS callback is disabled. このパラメーターは、ビデオリソースがビデオオンデマンド (VOD) ファイルの場合にのみ返されます。

VodUrl String http:// **** -demo.aliyundoc.com/liveCaster****.flv

VODファイルのURL。

このパラメータは、ビデオリソースがメディアライブラリからのものではないMP4、FLV、またはTSファイルである場合にのみ返されます。
Total Integer 2

The total number of returned entries.

例

リクエストの例

https://live.aliyuncs.com/?Action=DescribeCasterVideoResources
&CasterId=9ff2d96b-37ef-40a3-8cb0-4c7b1e2 ****
&<共通リクエストパラメーター>

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

XML 形式 

<DescribeCasterVideoResourcesResponse>
  <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
  <VideoResources>
        <ResourceId>b5f8c837-ceeb-424f-b30b-68e94e86 ****</ResourceId>
        <ResourceName>test001</ResourceName>
        <LocationId>RV01</LocationId>
        <LiveStreamUrl>rtmp:// abcLive/liveApp ****/b5447c21fcfe444c9e9b6f7ba208 ****</LiveStreamUrl>
  </VideoResources>
  <VideoResources>
        <ResourceId>b5f8c837-ceeb-424f-b30b-68e94e86 ****</ResourceId>
        <MaterialId>d2c429cd907742ee8f6e76465ad3****</MaterialId>
        <ResourceName>test002</ResourceName>
        <LocationId>RV02</LocationId>
        <BeginOffset>1000</BeginOffset>
        <EndOffset>10000</EndOffset>
        <PtsCallbackInterval>0</PtsCallbackInterval>
        <RepeatNum>2</RepeatNum>
  </VideoResources>
</DescribeCasterVideoResourcesResponse>

JSON 形式 

{
    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7" 、
    "VideoResources": [
        {
            "ResourceId": "b5f8c837-ceeb-424f-b30b-68e94e86 ****" 、
            "ResourceName": "test001" 、
            "LocationId": "RV01" 、
            "LiveStreamUrl": "rtmp://abcLive/liveApp****/b5447c21fcfe444c9e9b6f7ba208****"
        },
        {
            "ResourceId": "b5f8c837-ceeb-424f-b30b-68e94e86****",
            "MaterialId": "d2c429cd907742ee8f6e76465ad3 ****" 、
            "ResourceName": "test002" 、
            "LocationId": "RV02" 、
            "BeginOffset":1000、
            "EndOffset":10000、
            "PtsCallbackInterval":0,
            "RepeatNum": 2
        }
    ]
}

エラーコード

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