模板管理

直播模板用于对音视频直播进行参数配置,LSS提供转码、录制、水印、缩略图四种类型的直播模板。

转码模板

转码模板可以配置音视频编码标准、码率、输出流类型等基本参数,包括两类:

  • 样例模板:系统内置,方便您直接使用从而简化域名配置。
  • 用户模板:自定义模板,根据需求量身定制从而更好地适配用户业务场景。

1.从侧边栏“模板管理->转码”进入转码模板管理页面,点击“新建用户模板”进入模板创建页面后,可基于样例模板或空模版创建用户模板。

目前LSS提供下述样例模板:

preset description
lss.forward_only RTMP/FLV/HLS输出,只做转发,保持输入分辨率与码率不变
lss.lss_1280x720 高清720p,16:9,RTMP/FLV/HLS输出
lss.lss_960x720 高清720p,4:3,RTMP/FLV/HLS输出
lss.lss_854x480 标清480p,16:9,RTMP/FLV/HLS输出
lss.lss_640x480 标清480p,4:3,RTMP/FLV/HLS输出
lss.lss_640x360 标清360p,16:9,RTMP/FLV/HLS输出
lss.lss_480x360 标清360p,4:3,RTMP/FLV/HLS输出
lss.lss_320x240 低清240p,4:3,RTMP/FLV/HLS输出
lss.all_as_input 保持输入分辨率与码率不变,RTMP/FLV/HLS输出

说明:

  1. 上述模板中,除了forward_only只转发不做转码,使用其他模板均收取转码费用。
  2. forward_only模板对应的stream不支持加水印,如需添加水印,建议使用all_as_input模板,该模板会保持原有的输入参数再次做转码并添加水印。

2.填写模板基本信息和配置项后点击“完成并创建”。

参数详情:

分类 参数名称 描述 可选值 必要性
基本信息
样例模板 为用户提供参考模板,包括内置转码模板和空模版。 内置转码模板、已创建的用户模板、空模版 必填
模板名称 命名自定义模板,命名规则见控制台,用户命名空间内唯一 - 必填
模板描述 自定义模版的类型描述,包括清晰度、分辨率等 - 可选
直播类型 包括两种类型的转码模板,仅用于转发的模板和实时转码的模板 仅转发、实时转码 必填

转码模板的高级配置项参见下表,其中视频和音频项至少配置一种。

分类 参数名称 描述 可选值 必要性
视频
编码标准 视频编解码 h264 可选
编码规格 指定目标视频所用编码规格 baseline, main, high 可选
码率 视频目标码率(单位 bps) - 可选
最大帧率 目标视频最大帧率 10, 15, 20, 23.97, 24, 25, 29.97, 30, 50, 60 可选
最大宽度 目标视频的最大宽度 128 ~ 4096,必须为2的倍数 可选
最大高度 目标视频的最大高度 96 ~ 3072,必须为2的倍数 可选
尺寸伸缩策略 视频图像的尺寸伸缩策略 keep,保持原始视频尺寸(默认值); shrinkToFit,原始视频尺寸自适应; stretch,表示拉伸原始视频尺寸。 可选
音频
编码标准 音频编码方式 目前音频编码标准只支持AAC 可选
采样率 音频采样率 22050, 32000, 44100, 48000, 96000,(auto)与输入保持一致 可选
码率 音频目标码率 大于等于1000 可选
声道 音频声道数目 单声道、双声道、与输入一致 可选

录制模板

LSS提供直播视频录制功能,通过在创建录制模板时指定视频存储路径,并在域名配置中绑定适当的录制模板,即可将直播内容同步录制到对象存储BOS音视频点播VOD

录制策略如下:

  • 主播端连接不断开且网络稳定,则录制为一个视频文件。
  • 主播端断开,或者网络不稳定均有可能导致录制多个视频文件,具体策略如下:

    • 主播端断开,每断开一次就录制一个视频文件;
    • 主播端网络不稳定,无流时长在30秒内不会触发新的录制操作,超过30秒才会重新录制一个视频文件。

从侧边栏“模板管理->录制”进入录制模板管理页面,点击“新建录制模板”进入模板创建页面,填写模板基本信息和配置项后点击“完成并创建”。

参数名称 描述 必要性
模板名称 录制模板的名称 必填
模板描述 当前模板的相关信息 可选
存储模式 同步录制到对象存储BOS或音视频点播VOD 必选
录制模式 与输出流一致 必选
所属地域 北京、广州、苏州 必选
选择BOS Bucket 选择录制文件保存的BOS Bucket路径 必选
录制视频格式 MP4、M3U8、FLV 必选
单个录制文件时长 设置录制的视频文件时长,输入1~360分钟 必选
自动合并时间间隔 当选择录制到BOS(包括标准及低频)并选择录制视频格式为m3u8时,支持自定义自动合并视频时间间隔 必选
录制文件命名模式 系统默认pattern=%d%a/%s/recording_%t.%f;
其中,%d: domain
%a: App名称
%s: stream名称
%t: 录制开始时间,CST时区,精确到秒
%T: 录制结束时间,CST时区,精确到秒
%f: 录制文件格式
例如,生成的录制文件名形如'domain/appName/streamName/recording_20160213120931.mp4'
可选

说明:

  • 录制到 VOD点播时,仅支持 MP4 格式;录制到BOS 时,支持MP4、M3U8、FLV格式。
  • 使用BOS Bucket存储时,用户需要对录制模板中使用的Bucket授予LSS服务账号WRITE权限(目前在用户创建录制模板时,LSS服务会自动添加该授权)。
  • 请不要删除录制文件的Bucket和WRITE权限,否则在直播过程中无法正常录制视频流。

水印模板

在直播流中,可以通过水印模板(支持图片水印和时间戳水印)对输出视频添加水印,水印模版中定义水印的详细参数集合用于完成水印添加,包括水印形态(图片、时间戳)、水印大小、位置等。

说明:
水印仅支持在转码线路里播放。

从侧边栏“模板管理->水印”进入水印模板管理页面,点击“新建水印模板”进入模板创建页面,填写模板基本信息和配置项后点击“完成并创建”。

  • 图片水印
参数 描述 是否必须
模板名称 字符串,可由小写字母、数字、下划线组成,必须以小写字母开头,最长40个字符
类型 图片水印
图片 支持PNG、JPG、GIF三种图片格式,推荐使用PNG和GIF透明背景的图标。有效值:大小<200kb,尺寸< 200*200像素
最大宽度 有效值:[10-4096]间的偶数。不设置时,如果设置了最大高度则会根据原始图片宽高比计算水印宽度,否则和原始图片宽度保持一致
最大高度 有效值:[10-3072]间的偶数。不设置时,如果设置了最大宽度则会根据原始图片宽高比计算水印高度,否则和原始图片高度保持一致
伸缩策略 目前仅支持:keep(与原图片宽高比例一致)
显示位置 九宫格形式,分左上、中上、右上、左中、居中、右中、左下、中下、右下
水平偏移 显示位置有水平偏移时有效。单位:像素,有效值:[0-4096],默认值:10
垂直偏移 显示位置有垂直偏移时有效。单位:像素,有效值:[0-3072],默认值:10
  • 时间戳水印
参数 描述 是否必须
模板名称 字符串,可由小写字母、数字、下划线组成,必须以小写字母开头,最长40个字符
类型 时间戳水印
时区 支持CST(中国标准时间)UTC(世界统一时间)两种类型
透明度 有效值:[0-100]%,0表示完全透明,100%表示完全不透明
文字样式 设置字体、大小、颜色。字体目前仅支持Arial;大小有效值:[1-72],默认值:16;颜色默认值:白色
颜色背景 默认值:无
显示位置 九宫格形式,分左上、中上、右上、左中、居中、右中、左下、中下、右下
水平偏移 显示位置有水平偏移时有效。单位:像素,有效值:[0-4096],默认值:10
垂直偏移 显示位置有垂直偏移时有效。单位:像素,有效值:[0-3072],默认值:10

缩略图模板

在直播流中,可以通过缩略图模板为输出视频生成缩略图,缩略图模版中定义缩略图的详细参数集合用,包括图片格式、伸缩策略及尺寸大小、BOS Bucket及所属区域等。

从侧边栏“模板管理->缩略图”进入缩略图模板管理页面,点击“新建缩略图模板”进入模板创建页面,填写模板基本信息和配置项后点击“完成并创建”。

参数 描述 是否必须
模板名称 字符串,可由小写字母、数字、下划线组成,必须以小写字母开头,最长40个字符
模板描述 模板说明信息
图片格式 目前仅支持jpg、gif
尺寸伸缩策略 目前仅支持(Strech)拉伸原视频尺寸
所属地域 支持北京、广州、苏州,默认值:北京
选择BOS Bucket 指定目标BOS Bucket后,系统会授权LSS服务访问此Bucket
缩略图宽度 [10-4096]间的偶数,输入值超过视频实际宽度时按输入值输出
缩略图高度 [10-3072]间的偶数,输入值超过视频实际高度时按输入值输出
截图间隔 [1-21600],单位:秒
文件命名模式 系统默认pattern=%d%a/%s/thumbnails/%t.%f;每个参数仅设置一次
其中,%d:domain
%a: App名称
%s: Stream流名称
%t: 缩略图截图时间,CST时区,精确到秒;建议设置%t,否则同一个流的每个截图会覆盖前一张,最终该流中只保存了最后一张截图
%f: 缩略图文件格式
例如,生成的缩略图文件名形如'domain/appName/streamName/thumbnails/20160213120931.jpg'