调用AddCustomLiveStreamTranscode添加自定义转码配置信息。

调试

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

请求参数

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

系统规定参数。取值：AddCustomLiveStreamTranscode。

App String 是 AppName

播流所属应用名称。
Domain String 是 live.aliyunlive.com

播流域名。
Template String 是 LDtest

转码模板自定义名称。

说明 必须由数字、大小写字母或短横线（-）组成，且字段必须以大小写字母或数字开头，不能与标准的转码模板命名重复。
TemplateType String 是 h264

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

  • h264：自定义H264标准模版。
  • h264-nbhd：自定义H264窄带高清™模版。
  • h265：自定义H265标准模版。
  • h265-nbhd：自定义H265窄带高清模版。
  • audio：纯音频模板。
Height Integer 否 720

转码视频高度。取值范围：

  • Height ≥ 100
  • max（Height,Width）≤ 2560
  • min（Height,Width）≤ 1440
说明 265窄带高清模板不得超过1280×720。
Width Integer 否 576

转码视频宽度。取值范围：

  • Width ≥ 100
  • max（Height,Width）≤ 2560
  • min（Height,Width）≤ 1440
说明 265窄带高清模板不得超过1280×720。
FPS Integer 否 30

转码视频帧率。单位：FPS，取值范围：1~60。

VideoBitrate Integer 否 720

转码视频比特率。单位：kbps，取值范围：1~6000。

说明 转码视频会尽量接近您所设定的比特率，但转码视频的实际比特率不能保证和您所设定的完全一致，尤其是当您设定的比特率过大或过小时。
AudioBitrate Integer 否 512

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

Gop String 否 1

视频GOP（Group of Picture）。单位：帧，取值范围：1~3000。

Profile Integer 否 2

编码级别。视频支持的一组特定的编码功能，一般值越大得到的画面质量越好，同时编解码消耗的资源也越高。取值：

  • 1：baseline（适合移动设备）。
  • 2：main（适合标准分辨率设备）。
  • 3：high（适合高分辨率设备）。
AudioProfile String 否 aac_low

音频编码。取值：

  • aac_low
  • aac_he
  • aac_he_v2
  • aac_ld
AudioCodec String 否 AAC

音频编码格式。可选值：AAC或MP3。

AudioRate Integer 否 96000

音频采样率。取值范围：22050~96000。

说明 如果AudioProfile取值为aac_ld，则采样率不能超过44100。
AudioChannelNum Integer 否 2

音频声道数。取值

  • 1：单声道。
  • 2：双声道。
Lazy String 否 1

参数暂未启用。

返回数据

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

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddCustomLiveStreamTranscode
&App=AppName
&Domain=live.aliyunlive.com
&Template=LDtest
&TemplateType=h264
&<公共请求参数>

正常返回示例

XML格式 

<AddCustomLiveStreamTranscodeResponse>
	  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</AddCustomLiveStreamTranscodeResponse>

JSON格式 

{
    "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

错误码

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