Queries information about the scenes of a production studio.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeCasterScenes

The operation that you want to perform. Set the value to DescribeCasterScenes.

CasterId String Yes 80787064-1c94-4dc1-85ce-9409960a****

The ID of the production studio.

RegionId String No cn-shanghai

The ID of the region.

SceneId String No b5f8c837-ceeb-424f-b30b-68e94e86****

The ID of the scene.

Response parameters

Parameter Type Example Description
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

The ID of the request.

SceneList Array of Scene

The information about the scenes that were queried.

Scene
SceneId String b5f8c837-ceeb-424f-b30b-68e94e86****

The ID of the scene.

SceneName String scene1

The name of the scene.

OutputType String 0

Indicates whether the output video is in preview mode or program mode. Valid values:

  • 0: indicates that the output videos of the scene are in preview mode.
  • 1: indicates that the output videos of the scene are in program mode.
LayoutId String 37cb2f8b-f152-4338-b928-6704f71d****

The ID of the layout.

StreamUrl String rtmp://sophon-test.aliyunlive.com/caster/4a82a3d1b7f0462ea37348366201****? auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****

The streaming URL.

ComponentIds List ["1506396160-0-0-7de771a77102680861853af862d5****"]

The IDs of components.

Status Integer 0

The status of the scene. Valid values:

  • 0: disabled.
  • 1: enabled.
StreamInfos Array of StreamInfo

The information about the stream.

StreamInfo
OutputStreamUrl String http://live/caster/yule.flv

The streaming URL.

TranscodeConfig String lld

The resolution to which the scene transcodes the stream for playback. Valid values:

  • sd: standard definition.
  • lld: low definition.
  • lud: ultra high definition.
  • lhd: high definition.
VideoFormat String flv

The format to which the scene transcodes the stream for playback. Valid values:

  • flv
  • mp4
  • m3u8
Total Integer 2

The total number of entries that were returned.

Examples

Sample requests

http(s)://live.aliyuncs.com/? Action=DescribeCasterScenes
&CasterId=80787064-1c94-4dc1-85ce-9409960a****
&<Common request parameters>

Sample success responses

XML format

<DescribeCasterScenesResponse>
  <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
  <SceneList>
        <SceneId>b5f8c837-ceeb-424f-b30b-68e94e86****</SceneId>
        <SceneName>scene1</SceneName>
        <LayoutId>37cb2f8b-f152-4338-b928-6704f71d****</LayoutId>
        <StreamUrl>rtmp://live/out/b5447c21fcfe444c9e9b6f7ba208****</StreamUrl>
        <OutputType>0</OutputType>
        <Status>1</Status>
  </SceneList>
  <SceneList>
        <SceneId>86f661ee-c893-4aae-a852-ccacf200****</SceneId>
        <SceneName>scene2</SceneName>
        <StreamUrl>rtmp://live/out/37087ce7a76e424bbb61e8b5eefe****</StreamUrl>
        <OutputType>1</OutputType>
        <Status>1</Status>
        <StreamInfos>
              <VideoFormat>flv</VideoFormat>
              <OutputStreamUrl>http://liveout/caster/fb628e2469f94f2aa2c0c219af8b****_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>rtmp</VideoFormat>
              <OutputStreamUrl>rtmp://liveout/caster/fb628e2469f94f2aa2c0c219af8b****_lld? auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>m3u8</VideoFormat>
              <OutputStreamUrl>http://liveout/caster/fb628e2469f94f2aa2c0c219af8b****.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae64****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
  </SceneList>
</DescribeCasterScenesResponse>

JSON format

{
    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
    "SceneList": [{
            "SceneId": "b5f8c837-ceeb-424f-b30b-68e94e86****",
            "SceneName": "scene1",
            "LayoutId": "37cb2f8b-f152-4338-b928-6704f71d****",
            "StreamUrl": "rtmp://live/out/b5447c21fcfe444c9e9b6f7ba208****",
            "OutputType": 0,
      "Status": 1
        },
        {
            "SceneId": "86f661ee-c893-4aae-a852-ccacf200****",
            "SceneName": "scene2",
            "StreamUrl": "rtmp://live/out/37087ce7a76e424bbb61e8b5eefe****",
            "OutputType": 1,
      "Status": 1,
      "StreamInfos": [
             {
                 "VideoFormat": "flv",
                 "OutputStreamUrl": "http://liveout/caster/fb628e2469f94f2aa2c0c219af8b****_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5****",
                 "TranscodeConfig": "lld"
             },
             {
                 "VideoFormat": "rtmp",
                 "OutputStreamUrl": "rtmp://liveout/caster/fb628e2469f94f2aa2c0c219af8b****_lld? auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765****",
                 "TranscodeConfig": "lld"
             },
             {
                 "VideoFormat": "m3u8",
                 "OutputStreamUrl": "http://liveout/caster/fb628e2469f94f2aa2c0c219af8b****.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae64****",
                 "TranscodeConfig": "lld"
             }
         ]
        }
    ]
}

Error codes

For a list of error codes, visit the API Error Center.