调用DescribeLiveStreamTranscodeInfo查询转码配置信息。

使用说明

先获取主播流域名,再调用本接口查询转码配置信息。

QPS限制

本接口的单用户QPS限制为60次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

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

系统规定参数。取值:DescribeLiveStreamTranscodeInfo

DomainTranscodeName String example.com

主播流域名。

返回数据

名称 类型 示例值 描述
DomainTranscodeList Array of DomainTranscodeInfo

转码配置信息。

DomainTranscodeInfo
TranscodeName String example.com

主播流域名。

TranscodeApp String liveApp****

应用名称。

TranscodeTemplate String lld

转码模版。取值:

  • 标准质量模板
    • lld:流畅。
    • lsd:标清。
    • lhd:高清。
    • lud :超清。
  • 窄带高清™转码模板
    • ld:流畅。
    • sd:标清。
    • hd:高清。
    • ud:超清。
CustomTranscodeParameters Struct

自定义转码配置。

AudioBitrate Integer 64

转码音频比特率。单位:Kbps,取值范围:1~1000

AudioChannelNum Integer 2

音频声道数。取值:

  • 1:单声道。
  • 2:双声道。
AudioCodec String ACC

音频编码格式。

AudioProfile String aac_low

音频编码等级。取值:

  • aac_low
  • aac_he
  • aac_he_v2
  • aac_ld
AudioRate Integer 44100

音频采样率。取值:22050~96000

说明 如果AudioProfile取值为aac_ld,则采样率不能超过44100。
Bframes String 0

去B帧。固定取值:0

FPS Integer 15

转码视频帧率。单位:FPS。

Gop String 10

视频GOP(Group of Picture)。单位:帧,取值范围:1~3000

Height Integer 1200

转码视频高度。

RtsFlag String true

低延时的标签。固定取值true

说明 当转码为低延时转码时,才返回此参数。
TemplateType String h264

自定义转码模版类型。取值:

  • h264:自定义H264标准模版。
  • h264-nbhd:自定义H264窄带高清™模版。
  • h265:自定义H265标准模版。
  • h265-nbhd:自定义H265窄带高清模版。
  • audio:纯音频模板。
VideoBitrate Integer 3000

转码视频比特率。单位:Kbps。

VideoProfile String high

视频的编码等级。取值:

  • baseline:适合移动设备。
  • main:适合标准分辨率设备。
  • high:适合高分辨率设备。
Width Integer 1000

转码视频宽度。

EncryptParameters Struct

加密配置。

EncryptType String aliyun

加密类型。固定取值aliyun

KmsKeyExpireInterval String 3600

换Key周期。取值范围:60~3600,单位:秒。

KmsKeyID String afce5722-81d2-43c3-9930-7601da11****

用户KMS主密钥ID。

RequestId String 62136AE6-7793-45ED-B14A-60D19A9486D3

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamTranscodeInfo
&DomainTranscodeName=example.com
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveStreamTranscodeInfoResponse>
  <RequestId>62136AE6-7793-45ED-B14A-60D19A9486D3</RequestId>
  <DomainTranscodeList>
        <DomainTranscodeInfo>
              <TranscodeTemplate>lld</TranscodeTemplate>
              <TranscodeApp>liveApp****</TranscodeApp>
              <TranscodeName>example.com</TranscodeName>
              <CustomTranscodeParameters>
                    <FPS>15</FPS>
                    <Gop>10</Gop>
                    <TemplateType>h264</TemplateType>
                    <AudioBitrate>64</AudioBitrate>
                    <Bframes>0</Bframes>
                    <AudioProfile>aac_low</AudioProfile>
                    <AudioChannelNum>2</AudioChannelNum>
                    <VideoProfile>high</VideoProfile>
                    <Height>1200</Height>
                    <RtsFlag>true</RtsFlag>
                    <Width>1000</Width>
                    <AudioRate>44100</AudioRate>
                    <AudioCodec>ACC</AudioCodec>
                    <VideoBitrate>3000</VideoBitrate>
              </CustomTranscodeParameters>
              <EncryptParameters>
                    <KmsKeyID>afce5722-81d2-43c3-9930-7601da11****</KmsKeyID>
                    <EncryptType>aliyun</EncryptType>
                    <KmsKeyExpireInterval>3600</KmsKeyExpireInterval>
              </EncryptParameters>
        </DomainTranscodeInfo>
  </DomainTranscodeList>
</DescribeLiveStreamTranscodeInfoResponse>

JSON格式

{
    "DescribeLiveStreamTranscodeInfoResponse": {
        "RequestId": "62136AE6-7793-45ED-B14A-60D19A9486D3",
        "DomainTranscodeList": {
            "DomainTranscodeInfo": {
                "TranscodeTemplate": "lld",
                "TranscodeApp": "liveApp****",
                "TranscodeName": "example.com",
                "CustomTranscodeParameters": {
                    "FPS": 15,
                    "Gop": 10,
                    "TemplateType": "h264",
                    "AudioBitrate": 64,
                    "Bframes": 0,
                    "AudioProfile": "aac_low",
                    "AudioChannelNum": 2,
                    "VideoProfile": "high",
                    "Height": 1200,
                    "RtsFlag": true,
                    "Width": 1000,
                    "AudioRate": 44100,
                    "AudioCodec": "ACC",
                    "VideoBitrate": 3000
                },
                "EncryptParameters": {
                    "KmsKeyID": "afce5722-81d2-43c3-9930-7601da11****",
                    "EncryptType": "aliyun",
                    "KmsKeyExpireInterval": 3600
                }
            }
        }
    }
}

错误码

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