全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

模板说明

最近更新时间:2022-03-02 16:08:31

转码模板是以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 如下扩展 可选参数:视频设置补充参数集,object,模板一级参数。

Output结构

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

format结构

名称 类型 必填项 示例值 描述
kshd int 0 集智高清开关参数,0:关闭(默认) 1:开启。
output_format int 271 转码输出档标识,转码核心参数,指定转码输出媒体流的参数档次,见转码输出格式表。
width int 4096 视频宽度,单位px,取值范围:0-3000。
height int 4096 视频高度,单位px,取值范围:0-3000。
abr int 64000 可选参数:自定义音频码率,int,取值范围5000~320000(单位:bps),单位换算 1k=1024byte 如:100k = 102400。
vbr int 800000 自定义视频码率,取值范围20000~30000000(单位:bps),单位换算 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图。
zdParams json object 集智高清参数集。
br_percent_maxrate string 30000000k 目标码率范围上限(包含),目标码率超出该值时系统自动降为br_percent_maxrate。默认为30000000k。单位:m/k/空,大小写不敏感。范围[20000k,30000000k],单位:bps。该值必须大于等于br_percent_minrate
br_percent_minrate string 20000k 目标码率范围下限(包含),目标码率低于该值时系统自动提升至br_percent_minrate。默认为20000k。单位:m/k/空;大小写不敏感。范围[20000k,30000000k],单位:bps。该值必须小于等于br_percent_maxrate
br_percent float 1 码率降低比例。单位:比例。取值范围:(0,1]。取值:以小数展示,精确到小数后2位。如:0.98表示降低至源码率的98%。该参数优先级高于vb和Output_format

zdParams结构

名称 类型 必填项 描述
video_type int 视频类型分以下几种:0:通用1:秀场2:游戏3:动画

zdParams示例如下:
“zdParams”:{“video_type”:2}

Output和format示例如下:

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

        "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
288 COPY self-adapt* COPY COPY COPY COPY COPY COPY COPY

*288模板中源流vcodec格式为非264或非265时,自动转为264

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈