阿里云视频直播模板使用说明

阿里云视频直播模板用于对音视频直播进行参数配置,视频直播提供转码、录制、水印、缩略图和通知五种类型的直播模板。

转码模板

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

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

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

目前视频直播提供下述样例模板:

lss.lss_1280x720_cae 智感超清转码,高清720p,16:9,RTMP/FLV/HLS输出
lss.lss_960x720_cae 智感超清转码,高清720p,4:3,RTMP/FLV/HLS输出
lss.lss_854x480_cae 智感超清转码,标清480p,16:9,RTMP/FLV/HLS输出
lss.lss_640x480_cae 智感超清转码,标清480p,4:3,RTMP/FLV/HLS输出
lss.lss_640x360_cae 智感超清转码,标清360p,16:9,RTMP/FLV/HLS输出
lss.lss_480x360_cae 智感超清转码,标清360p,4:3,RTMP/FLV/HLS输出
lss.lss_320x240_cae 智感超清转码,低清240p,4:3,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模板,该模板会保持原有的输入参数再次做转码并添加水印。
  3. 模板名称中带_cae后缀的为智感超清转码模板,码率压缩更大,画质更清晰。您可以前往智感超清解决方案详情页进行开通。

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 可选
声道 音频声道数目 单声道、双声道、与输入一致 可选

录制模板

视频直播提供直播视频录制功能,通过在创建录制模板时指定视频存储路径,并在域名配置中绑定适当的录制模板,即可将直播内容同步录制到对象存储阿里云对象存储或音视频点播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: 录制文件格式

说明:

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

水印模板

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

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

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

  • 图片水印
  • 参数 描述 是否必须
    模板名称 字符串,可由小写字母、数字、下划线组成,必须以小写字母开头,最长40个字符
    类型 图片水印
    图片 支持PNG、JPG、GIF三种图片格式,推荐使用PNG和GIF透明背景的图标。
    有效值:大小<500kb,尺寸< 1280*720像素
    最大宽度 有效值:[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

缩略图模板

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

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

参数 描述 是否必须
模板名称 字符串,可由小写字母、数字、下划线组成,必须以小写字母开头,最长40个字符
模板描述 模板说明信息
图片格式 目前仅支持jpg、gif
尺寸伸缩策略 目前仅支持(Strech)拉伸原视频尺寸
所属地域 支持北京、广州、苏州
选择BOS Bucket 用于存储截到的缩略图的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: 缩略图文件格式

通知模板

您可以通过配置通知模板来实现对直播流的自动监控。在直播状态转变时,或者特定事件发生时,配置了通知模板的直播流会向通知模板的接口地址发送通知。

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

参数描述名称通知模板的名称, 开头必须是小写字母,其余可以是小写字母、_或数字,最多不超过40个字符接口地址通知的回调地址,需要是公网可以访问的地址,目前支持HTTP和HTTPS协议

通知模板默认可以在直播流开启/停止时向接口地址发送通知。您也可以在黄反审核模板处指定