调用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
                }
            }
        }
    }
}

错误码

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