プロダクションスタジオのストリーミングURLを照会します。

Usage note

You must create a production studio before calling this operation to query the information.

QPS limit

A single user can perform a maximum of 15 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.

デバッグ

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

リクエストパラメーター

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

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

CasterId String 必須 a2b8e671-2fe5-4642-a2ec-bf93880e ****

制作スタジオのID。

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

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

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

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

リージョンの ID

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。
CasterId String a2b8e671-2fe5-4642-a2ec-bf93880e ****

制作スタジオのID。
CasterStreams CasterStreamの配列

制作スタジオのストリームに関する情報。
CasterStream
SceneId String 23ca74e0-aca3-4e7a-8561-9d96f525 ****

シーンのID。
StreamUrl String http:// live/caste r/example.org

ストリーミングURL。
OutputType Integer 1

出力ストリームがプレビューモードかプログラムモードかを示します。

  • 0: シーンの出力ビデオがプレビューモードであることを示します。
  • 1: シーンの出力ビデオがプログラムモードであることを示します。
StreamInfos StreamInfoの配列

ストリームに関する情報。
StreamInfo
TranscodeConfig String lld

シーンが再生のためにストリームをトランスコードする解像度。 設定可能な値は以下のとおりです。

  • lsd: 標準定義。
  • lld: 低い定義。
  • lud: 超高い定義。
  • lhd: 高解像度。
VideoFormat String flv

シーンが再生のためにストリームをトランスコードするフォーマット。 設定可能な値は以下のとおりです。

  • flv。
  • rtmp。
  • m3u8.
OutputStreamUrl String http:// out/caste r/example.net

ストリーミングURL。
RtmpUrl String rtmp:// live/caste r/example.edu

リアルタイムメッセージングプロトコル (RTMP) URL。
Total Integer 1

返されたストリームの数。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeCasterStreamUrl
&CasterId=a2b8e671-2fe5-4642-a2ec-bf93880e ****
&<共通リクエストパラメーター>

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

XML 形式 

<DescribeCasterStreamUrlResponse>
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <CasterId>a2b8e671-2fe5-4642-a2ec-bf93880e ****</CasterId>
  <CasterStreams>
        <StreamUrl>rtmp:// live/caster/1975ee99db904ebb83908d43bc87 ****?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e0 ****</StreamUrl>
        <SceneId>23ca74e0-aca3-4e7a-8561-9d96f525 ****</SceneId>
        <OutputType>1</OutputType>
        <StreamInfos>
              <VideoFormat>flv</VideoFormat>
              <OutputStreamUrl>http:// live/caster/fb628e2469f94f2aa2c0c219af8b ****_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>rtmp</VideoFormat>
              <OutputStreamUrl>rtmp:// live/caster/fb628e2469f94f2aa2c0c219af8b ****_lld?auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>m3u8</VideoFormat>
              <OutputStreamUrl>http:// live/caster/fb628e2469f94f2aa2c0c219af8b ****.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae64 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
  </CasterStreams>
  <CasterStreams>
        <StreamUrl>rtmp:// live/caster/3a2e3cf978f3496f96d44e28b542 ****?auth_key=1506396160-0-0-6182084bd33e93a72029764f5cfb ****</StreamUrl>
        <SceneId>9445dbed-7aef-4cae-925f-8a3a026f ****</SceneId>
        <OutputType>0</OutputType>
  </CasterStreams>
</DescribeCasterStreamUrlResponse>

JSON 形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e ****" 、
    "CasterStreams": [
        {
            "StreamUrl": "rtmp:// live/caster/1975ee99db904ebb83908d43bc87 ****?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e0 ****" 、
            "SceneId": "23ca74e0-aca3-4e7a-8561-9d96f525 ****" 、
            "OutputType": 1、
            "StreamInfos": [
                {
                    "VideoFormat": "flv" 、
                    "OutputStreamUrl": "http:// live/caster/fb628e2469f94f2aa2c0c219af8b ****_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5 ****" 、
                    "TranscodeConfig": "lld"
                },
                {
                    "VideoFormat": "rtmp" 、
                    "OutputStreamUrl": "rtmp:// live/caster/fb628e2469f94f2aa2c0c219af8b ****_lld?auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765 ****" 、
                    "TranscodeConfig": "lld"
                },
                {
                    "VideoFormat": "m3u8" 、
                    "OutputStreamUrl": "http:// live/caster/fb628e2469f94f2aa2c0c219af8b ****.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae64 ****" 、
                    "TranscodeConfig": "lld"
                }
            ]
        },
        {
            "StreamUrl": "rtmp:// live/caster/3a2e3cf978f3496f96d44e28b542 ****?auth_key=1506396160-0-0-6182084bd33e93a72029764f5cfb ****" 、
            "SceneId": "9445dbed-7aef-4cae-925f-8a3a026f ****" 、
            "OutputType": 0
        }
    ]
}

エラーコード

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