调用DescribeLiveStreamTranscodeInfo接口查询直播转码配置-视频直播-阿里云

查询转码配置信息。

接口说明

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

QPS 限制

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

live:DescribeLiveStreamTranscodeInfo

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	否	地域 ID。	cn-shanghai
DomainTranscodeName	string	是	主播流域名。	example.com
AppName	string	否	播流所属应用名称。	myapp

返回参数

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

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameters	%s

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

变更历史

更多信息，参考变更详情。