所有文档

          音视频直播 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协议

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