在 StreamLive 中,您可以在频道运行时对频道进行事件处理。具体方式是通过与频道关联 Plan 来设置执行时间、执行事件,在该执行时间点时,频道将开始执行事件。
查看事件
登录 StreamLive 控制台,在 Channel 中,单击需要设置 Plan 的频道名称,进入频道详情页面,然后选择详情页中的 Plan 标签页,即可看到当前频道下的 Plan 列表: 创建事件
单击 Plan 标签页左上角的 Create Event,来创建新的事件。当前可支持的事件类型包括:
Input Switch:对运行中的频道,切换正在接收的输入。
Time Record: 对正在运行的频道,执行分时段录制。
SCTE-35 Time Signal:设置 SCTE-35 time_signal 事件。
SCTE-35 Splice Insert:设置 SCTE-35 splice_insert 事件。
SCTE-35 Return to Network:设置 SCTE-35 Return to Network 事件。
Timed Metadata:设置 ID3 数据插入事件。
Static Image Activate:设置静态图形叠加事件。
Static Image Deactivate:取消静态图形叠加。
Motion Graphics Activate:设置动态图形叠加事件。
Motion Graphics Deactivate:取消动态图形叠加。
Ad Break:设置广告插入事件,目前支持L形广告插入。
创建输入切换类型的事件
Event Type:选择 Input Switch。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time:在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Input Attachment:选择已在该频道绑定并想切换的 Input 名称。
创建定时录制类型的事件
Event Type:选择 Time Record。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
OutputGroupName:选择需要进行录制的 OutputGroup 名称,具体名称可在 Output Group Setting 页面查看。
ManifestName:输入录制生成的 Manifest 文件名。无需输入 .m3u8 或 .mpd 后缀。
DestinationUrl:输入需要保存文件的 COS 地址。
Timing:选择录制的时间段,该时间为 UTC 时间。
创建SCTE-35 Time Signal事件
对于 SCTE-35 类型的事件,可以先参考官方文档《SCTE STANDARD - SCTE 35 2022》。
Event Type:选择 SCTE-35 Time Signal。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
SCTE-35 Descriptor:可以通过 Add 增加多个 SCTE-35 Descriptor。
对于每个 SCTE-35 Descriptor 支持配置以下信息:
Segmentation Event ID:Event 标识。支持整数,最小值为0、最大值为4294967295。
Segmentation Event Cancel Indicator:标明前一个 Event 是否取消。
Delivery Restrictions:设置播放端限制。
Segmentation Duration:Segment 时长。单位为90kHz,支持整数,最小值为0、最大值为1099511627775。
Segmentation UPID Type:对应 SCTE-35 segmentation_upid_type 参数。支持整数,最小值为0、最大值为255。
Segmentation UPID:对应 SCTE-35 segmentation_upid 参数。支持字符串,最大255个字符。只有在 Segmentation UPID Type 为0时 Segmentation UPID 才允许为空。
Segmentation Type ID:对应 SCTE-35 segmentation_type_id 参数。支持整数,最小值为0、最大值为255。
Segment Num:对应 SCTE-35 segment_num 参数。支持整数,最小值为0、最大值为255。
Segments Expected:对应 SCTE-35 segment_expected 参数。支持整数,最小值为0、最大值为255。
Subsegment Num:对应 SCTE-35 sub_segment_num 参数。支持整数,最小值为0、最大值为255。
Subsegments Expected:对应 SCTE-35 sub_segments_expected 参数。支持整数,最小值为0、最大值为255。
创建 SCTE-35 Splice Insert 事件
对于 SCTE-35 类型的事件,可以先参考官方文档《SCTE STANDARD - SCTE 35 2022》。
Event Type:选择 SCTE-35 Splice Insert。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time、Immediate、Fixed PTS。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Fixed PTS:在指定的 PTS 执行事件,PTS 输入值可以是1到233之间的正整数。当 Start Type 选择为 Fixed PTS 后,您还需要在 Input Attachment、Input Pipeline 的下拉选择框中,选择需要绑定的 Input 和 Pipeline。请注意,PTS 值的精度需要与所选择的 Input 保持一致。
Splice Event ID:Event 标识。支持整数,最小值为0、最大值为4294967295。
Duration:Segment 时长。单位为90kHz,支持整数,最小值为0、最大值为8589934591。
创建 SCTE-35 Return to Network 事件
对于 SCTE-35 类型的事件,可以先参考官方文档《SCTE STANDARD - SCTE 35 2022》。
Event Type:选择 SCTE-35 Return to Network。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time、Immediate、Fixed PTS。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Fixed PTS:在指定的 PTS 执行事件,PTS 输入值可以是1到233之间的正整数。当 Start Type 选择为 Fixed PTS 后,您还需要在 Input Attachment、Input Pipeline 的下拉选择框中,选择需要绑定的 Input 和 Pipeline。请注意,PTS 值的精度需要与所选择的 Input 保持一致。
Splice Event ID:Event 标识。支持整数,最小值为0、最大值为4294967295。
创建 Timed Metadata 事件
Event Type:选择 Timed Metadata。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time:在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
ID3:请参考 ID3说明文档,输入以 base64 编码的 ID3 元数据,最大长度为1024个字符。 此外,对于在此频道中需要透传 ID3 元数据的 Output,需要在 Output 中开启 ID3 Passthrough 开关。
创建 Static Image Activate 事件
Event Type:选择 Static Image Activate。此图形叠加事件的生效类型为全局叠加,即频道中的所有 Output 均会生效。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Image URL:图片文件的存储地址,地址需要以 http 或者 https 开头。
Layer:当需要叠加多层图形时,可以通过 Layer 进行精确控制,支持输入0-7之间的整数值,值越大的 Layer 将展示在更顶层。
Image X:叠加图片的左边缘与视频画面左边缘的距离,单位为像素。支持0-4096之间的整数值。如果叠加图片的右边缘超出了视频画面的右边缘,那叠加图形的右侧将被裁剪到与视频画面右边缘对齐。
Image Y:叠加图片的顶部与视频画面顶部的距离,单位为像素。支持0-2160之间的整数值。如果叠加图片的底部超出了视频画面的底部,那叠加图形的底部将被裁剪到与视频画面底部对齐。
Opacity:叠加图片的透明度,支持0-100之间的整数值,0代表透明、100代表完全不透明。
Width:叠加图片的宽度,单位为像素。支持1-4096之间的整数值,图片宽度将被拉伸到目标值。此外,当输入为空时,代表保持原图宽度。
Height:叠加图片的高度,单位为像素。支持1-2160之间的整数值,图片高度将被拉伸到目标值。此外,当输入为空时,代表保持原图高度。
Duration:静态图形的展示时长,以毫秒为单位。当输入为空或者0时,代表静态图形会一直展示,直到 Static Image Deactivate 事件生效。
Fade-in:静态图形的淡入时长,以毫秒为单位,最大支持5秒。
Fade-out:静态图形的淡出时长,以毫秒为单位,最大支持5秒。
创建 Static Image Deactivate 事件
Event Type:选择 Static Image Deactivate。此取消图形叠加事件的类型为全局取消,即频道中的所有 Output 均会取消。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Layer:需要取消的图形所在的 Layer,支持输入0-7之间的整数值。
Fade-out:取消图形的淡出时长,以毫秒为单位,最大支持5秒。
创建 Motion Graphics Activate事件
Event Type:选择 Motion Graphics Activate 选项。此图形叠加事件的生效类型为全局叠加,即频道中的所有 Output 均会生效。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
URL:动态图形文件的存储地址,地址需要以 http 或者 https 开头。
Duration:动态图形的展示时长,以毫秒为单位。当输入为空或者0时,代表图形会一直展示,直到 Motion Graphics Deactivate 事件生效。
创建 Motion Graphics Deactivate事件
Event Type:选择 Motion Graphics Deactivate。此取消动图叠加事件的类型为全局取消,即频道中的所有 Output 均会取消。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time: 在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
创建 Ad Break 事件
在直播过程中,如果您希望在直播流画面上叠加 L 形图、画中画或 U 形图,来展示广告信息,那您可以创建 Ad Break Event。创建成功后,后续在频道运行时,当到了 Ad Break Event 的指定执行时间时,系统将在直播流画面上叠加相应图形。
Event Type:选择 Ad Break。
Event Name:输入该事件的名称,可支持数字、下划线、大小写字母,最大长度为32个字符。事件名称在该频道下不能重复。
Start Type:可选择 Fixed Time 或者 Immediate。
Fixed Time:在指定的特定时间执行事件,该时间为 UTC 时间,指定的时间必须在事件开始前至少10秒且不能小于当前时间。
Immediate:立即执行设定的事件。
Copy Configuration:直接复用和引用在 图形叠加配置 中保存好的参数模板。如果不使用 Copy 操作,则需要逐个填写配置参数。 Format:画面版式当前只支持 L 形。
Ad Source:
External ADS:由外部 ADS 根据观众特征返回个性化广告素材。(开发中,暂未上线)
Position:锚点位置,也即 L 形广告的展示位置。Bottom-Left,L 形广告展示在画面的左下角。Bottom-Right,L 形广告展示在画面的右下角。Top-Left,L 形广告展示在画面的左上角。Top-Right,L 形广告展示在画面右上角。
Offset:
Left Offset:当锚点位置选择 Bottom-Left、Top-Left 时,对于被压缩后的原流画面,需要指定原流画面左边缘与整个画面左边缘的偏移量,此偏移量使用整个画面宽度的百分比来表示。
Bottom Offset:当锚点位置选择 Bottom-Left、Bottom-Right 时,对于被压缩后的原流画面,需要指定原流画面底部与整个画面底部的偏移量,此偏移量使用整个画面高度的百分比来表示。
Right Offset:当锚点位置选择 Bottom-Right、Top-Right 时,对于被压缩后的原流画面,需要指定原流画面右边缘与整个画面右边缘的偏移量,此偏移量使用整个画面宽度的百分比来表示。
Top Offset:当锚点位置选择 Top-Left、Top-Right 时,对于被压缩后的原流画面,需要指定原流画面顶部与整个画面顶部的偏移量,此偏移量使用整个画面高度的百分比来表示。
Duration:L 形广告展示的总时长,从 Squeeze In 动效开始,以 Squeeze Out 动效结束,Duration 总时长包含了以下3段时长:Squeeze In 开始到Squeeze In 结束的时段,此时直播原画面将逐渐被压缩,L 形广告将逐渐展示;L 形广告完全被展示的时段;Squeeze Out 开始到 Squeeze Out 结束的时段,这时被压缩的直播原画面将逐渐恢复,L 形广告将逐渐被遮挡。
Squeeze Period:
Squeeze In Period:直播原流画面从全屏状态,逐渐被压缩到目标尺寸和位置,这整个动效的时间长度可以通过 Squeeze In Period 进行设置。Squeeze In Period 单位为毫秒,并且数值必须小于 Duration。
Squeeze Out Period:被压缩的直播原流画面,从被压缩状态逐渐恢复到全屏,这整个动效的时间长度可以通过 Squeeze Out Period 进行设置。Squeeze Out Period 单位为毫秒,并且数值必须小于 Duration。
Effect Preview:根据您已配置的参数,选择屏幕分辨率,单击 Start Preview,画面中将展示预览效果。
删除事件
选择需要删除的事件,在该事件最右侧 Operation 中单击 Delete,在弹出的确认框中单击 Confirm 后即可删除该事件。正在执行中的 Event 无法删除,只有未开始或已执行完的 Event 才能进行删除操作。