查询转码配置信息 - 视频直播

使用说明

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

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveStreamTranscodeInfo	系统规定参数。取值：DescribeLiveStreamTranscodeInfo。
DomainTranscodeName	String	是	example.com	主播流域名。
AppName	String	否	myapp	播流所属应用名称。

返回数据

名称	类型	示例值	描述
RequestId	String	62136AE6-7793-45ED-B14A-60D19A9486D3	请求ID。
DomainTranscodeList	Array of DomainTranscodeInfo		转码配置信息。
DomainTranscodeInfo
TranscodeApp	String	liveApp****	应用名称。
TranscodeTemplate	String	lld	转码模版。取值：标准质量模板： lld：流畅。 lsd：标清。 lhd：高清。 lud ：超清。窄带高清™转码模板： ld：流畅。 sd：标清。 hd：高清。 ud：超清。
IsLazy	Boolean	true	是否开启强制转码。取值： true：延迟转码。 false：强制转码。
TranscodeName	String	example.com	主播流域名。
CustomTranscodeParameters	Object		自定义转码配置。
BitrateWithSource	Map		码率随源配置。
VideoProfile	String	high	视频的编码等级。取值： baseline：适合移动设备。 main：适合标准分辨率设备。 high：适合高分辨率设备。
AudioBitrate	Integer	64	转码音频比特率。单位：kbps，取值范围：1~1000。
Height	Integer	1200	转码视频高度。
RtsFlag	String	true	低延时的标签。固定取值true。说明当转码为低延时转码时，才返回此参数。
TemplateType	String	h264	自定义转码模版类型。取值： h264：自定义H264标准模版。 h264-nbhd：自定义H264窄带高清™模版。 h265：自定义H265标准模版。 h265-nbhd：自定义H265窄带高清模版。 audio：纯音频模板。
Bframes	String	0	去B帧。固定取值：0。
ExtWithSource	Map		其他随源配置。
AudioRate	Integer	44100	音频采样率。取值：22050~96000。说明如果AudioProfile取值为aac_ld，则采样率不能超过44100。
FpsWithSource	Map		帧率随源配置。
AudioCodec	String	ACC	音频编码格式。
FPS	Integer	15	转码视频帧率。单位：FPS。
Gop	String	10	视频GOP（Group of Picture）。单位：帧，取值范围：1~3000。
Width	Integer	1000	转码视频宽度。
VideoBitrate	Integer	3000	转码视频比特率。单位：kbps。
AudioChannelNum	Integer	2	音频声道数。取值： 1：单声道。 2：双声道。
AudioProfile	String	aac_low	音频编码等级。取值： aac_low aac_he aac_he_v2 aac_ld
ResWithSource	Map		分辨率随源配置。
EncryptParameters	Object		加密配置。
EncryptType	String	aliyun	加密类型。固定取值aliyun。
KmsKeyID	String	afce5722-81d2-43c3-9930-7601da11****	用户KMS主密钥ID。
KmsKeyExpireInterval	String	3600	换Key周期。取值范围：60~3600，单位：秒。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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