音视频直播LSS

    模板管理

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

    转码模板

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

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

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

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

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

    录制模板

    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透明背景的图标。有效值:大小<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

    缩略图模板

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

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

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

    通知模板

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

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

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

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