tencent cloud

媒体直播

产品简介
购买指南
计费说明
欠费停服说明
控制台指南
Input 管理
Channel 管理
Asset 管理
Plan 管理
功能实践
实现直播
流实时监控
数字版权保护(DRM)
溯源水印
容灾切换
多输入切换
推断流回调事件
轮播
定时录制
精彩集锦
时移
延播
多码率自适应
字幕
直播转推
直播截图
SCTE-35
PDT(HLS)
归档(录制)
杜比音频
输出至 YouTube
广告实践
资源标签
API 文档
History
Introduction
API Category
Making API Requests
Input Management APIs
Input Security Group Management APIs
Channel Management APIs
Plan APIs
Watermark Management APIs
Statistics APIs
Data Types
Error Codes
StreamLive 政策
数据处理和安全协议
隐私政策
相关协议
Service Level Agreement

Plan 管理

PDF
聚焦模式
字号
最后更新时间: 2025-12-25 15:12:24
在 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 事件


只有在频道的 Global Overlay Configuration 配置中,开启了Image Overlay Configuration功能开关后,Event Type 中才会展示 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 事件


只有在频道的 Global Overlay Configuration 配置中,开启了Image Overlay Configuration功能开关后,Event Type 中才会展示 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事件


只有在频道的 Global Overlay Configuration 配置中,开启了 Motion Graphics Configuration 功能开关后,Event Type 中才会展示 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事件


只有在频道的 Global Overlay Configuration配置中,开启了Motion Graphics Configuration功能开关后,Event Type 中才会展示 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
Upload Creatives:上传固定的广告素材。并且只有在频道的 Global Overlay Configuration 配置中,开启了 Motion Graphics Configuration 功能开关后,才能使用此选项。
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 才能进行删除操作。




帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈