调用DescribeCasterStreamUrl查询导播台流地址。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeCasterStreamUrl

系统规定参数，取值：DescribeCasterStreamUrl。

CasterId String 是 a2b8e671-2fe5-4642-a2ec-bf93880e****

导播台ID。
RegionId String 否 cn-shanghai

地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。
CasterId String a2b8e671-2fe5-4642-a2ec-bf93880e****

导播台ID。
CasterStreams Array of CasterStream

导播台流信息列表。
CasterStream
SceneId String 23ca74e0-aca3-4e7a-8561-9d96f525****

场景ID。
StreamUrl String http://live/caster/out.flv

输出流地址。
OutputType Integer 1

是否正式输出。

  • 0：输出预览。
  • 1：输出正式。
StreamInfos Array of StreamInfo

播放地址列表。
StreamInfo
TranscodeConfig String lld

转码配置。 取值：

  • lsd：标清 。
  • lld：流畅。
  • lud：超清 。
  • lhd：高清 。
VideoFormat String flv

格式。取值：

  • flv。
  • rtmp。
  • m3u8。
OutputStreamUrl String http://out/caster/live_lld.flv

播放地址。
RtmpUrl String rtmp://live/caster/outrtm.flv

Rtmp地址。
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
        }
    ]
}

错误码

访问错误中心查看更多错误码。