文档

字幕规则

更新时间:

字幕模板添加完成后,需要通过字幕规则配置,将字幕模板关联到对应的直播流中。重新推流后,使用字幕流播放地址进行播放,才可以在直播中显示字幕。

前提条件

您已完成字幕模板配置,具体操作,请参见字幕模板

添加字幕规则

  1. 登录视频直播控制台

  2. 在左侧导航栏选择功能管理 > 实时字幕 ,进入实时字幕页面,选择字幕规则页签。

  3. 选择字幕规则需要配置的区域,选择对应区域后仅能配置此区域下的域名和字幕模板。image

  4. 单击添加字幕规则image

字幕规则参数及说明如下表所示:

参数

描述

规则描述

字幕规则描述。支持输入中英文、数字、字符,长度不超过128个字符。

播流域名

选择需要配置的主播放域名。

AppName

播流所属应用名称。AppName必须与推流地址中的AppName名称一样,字幕模板才能生效。支持数字、大小写字母、短划线(-)、下划线(_),长度不超过256个字符。

字幕模板

选择已配置好的字幕模板。若无模板,请先添加字幕模板,具体操作请参见字幕模板

输出设置

建议字幕规则里的输出设置与字幕模板的画面尺寸保持一致,以获取准确的播放效果。字幕流的输出设置支持以下规格:

  • 横屏流畅 360P 640x360

  • 竖屏流畅 360P 360x640

  • 横屏标清 480P 854x480

  • 竖屏标清 480P 480x854

  • 横屏高清 720P 1280x720

  • 竖屏高清 720P 720x1280

  • 横屏超清 1080P 1920x1080

  • 竖屏超清 1080P 1080x1920

拉流触发

字幕流触发方式。

  • 开启时:只有播放直播流才会启动字幕,若5分钟内没有播放则会断掉字幕,后续再有播放才会启动。

  • 关闭时:只要有推流就启动字幕,与是否有播放无关。

  1. 单击提交,完成字幕规则的配置。

说明

字幕规则配置成功后,需要重新推流后,播流中才能带字幕。

字幕流播放

要播放带字幕的直播流需要使用字幕流的播放地址,即需要在StreamName后添加_{字幕模板名称}:

  • RTMP:rtmp://example.aliyundoc.com/app/stream_{字幕模板名称}?auth_key={鉴权串}

  • FLV:http://example.aliyundoc.com/app/stream_{字幕模板名称}.flv?auth_key={鉴权串}

  • M3U8:http://example.aliyundoc.com/app/stream_{字幕模板名称}.m3u8?auth_key={鉴权串}

管理字幕规则

字幕规则页签的规则列表中,选择您需要修改的规则,在操作列单击预览编辑删除按钮:

  • 预览:对字幕实际效果进行预览。

  • 编辑:可对字幕规则参数进行调整。

  • 删除:对字幕规则进行删除。

相关API

添加实时字幕规则

添加字幕规则。

删除字幕规则

删除字幕规则。

更新字幕规则

更新字幕规则。

查询字幕规则

查询字幕规则列表。