模板说明

最近更新时间:2021-03-04 16:40:08

查看PDF

转码模板是以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结构

名称 类型 必填项 示例值 描述
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

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

  • 内容不全,不深入
  • 内容更新不及时
  • 描述不清晰,比较混乱
  • 系统或功能太复杂,缺乏足够的引导
  • 内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈