模板说明

最近更新时间:2020-11-20 11:54:33

转码模板是以Json格式预先设定一套转码参数,在拉流URL中携带转码参数,用来标识转码流,详情见直播转码操作详解

直播模板结构

名称 类型 必填项 示例值 描述
UniqName string "myuniqname" 客户域名标识,模板一级参数,由2~128位字母、数字、下划线组成。
App string "live" 客户频道名,模板一级参数,由2~32位字母、数字、下划线组成。
Preset string "test" 模板名称,模板一级参数,在用户直播转码模板命名空间唯一,由2~32位字母、数字、下划线组成。
Description string "demo" 模板描述,模板一级参数。
Output json array 如下扩展 转码输出流媒体参数集,模板一级参数,用于设定一到多组参数集,每一组参数产生一路转码输出流。
Video json object 如下扩展 视频设置补充参数集,模板一级参数。

Output结构

名称 类型 必填项 示例值 描述
format json object 如下扩展 "format"转码输出流关键参数集。

format结构

名称 类型 必填项 示例值 描述
output_format int 265 转码输出档标识,转码核心参数,指定转码输出媒体流的参数档次,见转码输出格式表。
width int 1080 视频宽度,单位px,取值范围:0-3000
height int 1920 视频高度,单位px,取值范围:0-3000
abr int 64000 可选参数:自定义音频码率,int,取值范围20000~320000,单位换算 1k=1024byte 如:100k = 102400
vbr int 800000 自定义视频码率,取值范围100000~10000000,单位换算 1k=1024byte 如:100k = 102400
fr int 25 自定义帧率,取值范围1~30
gop int 5 I帧间隔,单位:秒,默认5
suffix String "_mysuffix" 自定义拉流后缀名,string,由字母、数字、下划线组成,必须下划线开头。
remuxflag int 0 音视频转码选项,默认0。0:音视频都转码;1:音频原样输出,视频转码;2:视频原样输出,音频转码;3:音视频都原样输出。
exstream int 0 指定转出纯音频或纯视频:默认0。0:音视频都保留;1:只保留视频;2:只保留音频。
logo_switch int 0 视频加水印LOGO开关选项,用来确定是否对视频添加水印,默认0。0:关闭;1:开启,开启时必须在Video->LOGO中配置LOGO图。

Output和format示例如下:

{
    "app": "demo",
    "preset" : "for_RC-DSQ",
    "description": "live transcode for RC-DSQ",
    "output":[{
            "format": {
            "output_format": 265
            "vbr": 100, 
            "fr": 5
             ...
        }
    },
   {   

        "format":{...}
    }]
}

Video结构

名称 类型 必填项 示例值 描述
LOGO json array 如下扩展 水印图片参数集。

LOGO结构

名称 类型 必填项 示例值 描述
pic String "/bucketname/objectname" 水印图片所在的ks3中路径,必须是公共可访问,且与转码服务在同一region。
optimal_w int 480 自定义水印图片宽度
optimal_h int 640 自定义水印图片高度
offsetX int -10 水印图片横向偏移,基准位置为左上角顶点,向右为正,向左为负,默认10
offsetY int 10 水印图片纵向偏移,基准位置为左上角顶点,向下为正,向上为负,默认10

Video和LOGO示例如下:

{
    "app": "demo",
    "preset" : "for_RC-DSQ",
    "description": "live transcode for RC-DSQ",
    "output":[{   
         "format":{...}
    }],
    "Video":{ 
        "LOGO":[{
        "pic":"/mybucketname/myobjectname",
        "optimal_w":480,
        "optimal_h":640,
        "offsetX": -10,
        "offsetY": 10
      },
      {
        ...
      }]
  }
}

转码输出格式表

为方便用户接入,直播转码使用一个output_format值作为一组转码默认参数的代号,即转码预设模板代号,是转码必选参数。预设模板参见下表。

对一般使用场景,只设置output_format足矣,转码会首先对输入源流进入嗅探,根据结果自动决策一组折中的转码参数集,其过程远比下表中罗列的更为复杂。

如果发现预设模板方案不能满足自身业务需求,可以使用视频云提供的SDK/API,调整转码模板中各转码参数,比如帧率、码率、加水印等。如何使用模板与转码输出格式表,请参照模板使用示例。如果您在配置模板中有任何问题,请咨询技术支持。

output_format container vcodec acodec resolution fps vbitrate(bps) samplerate(Hz) channels abitrate(bps)
256 flv h264 aac 144P 10 150K 22050 2 24K
257 flv h264 aac 240P 15 250K 22050 2 32K
258 flv h264 aac 360P 18 500K 22050 2 48K
259 flv h264 aac 480P 24 800K 44100 2 64K
260 flv h264 aac 540P 25 900K 44100 2 64K
261 flv h264 aac 720P 25 1100K 44100 2 96K
263 flv h264 aac 960P 30 1700K 44100 2 128K
264 flv h264 aac 1080P 30 2M 44100 2 128K
266 flv h264 aac 1440P(2K) 30 3M 44100 2 128K
268 flv h264 aac 2160P(4K) 30 6M 44100 2 128K
271 flv h264 aac COPY self-adapt self-adapt 44100 2 128K
274 flv h265 aac 360P 18 400K 22050 2 48K
275 flv h265 aac 480P 24 600K 44100 2 64K
276 flv h265 aac 540P 25 650K 44100 2 64K
277 flv h265 aac 720P 25 800K 44100 2 96K
279 flv h265 aac 960P 30 1200K 44100 2 128K
280 flv h265 aac 1080P 30 1400K 44100 2 128K
282 flv h265 aac 1440P(2K) 30 2M 44100 2 128K
284 flv h265 aac 2160P(4K) 30 4M 44100 2 128K
287 flv h265 aac COPY self-adapt self-adapt 44100 2 128K

金山云,开启您的云计算之旅

免费注册