实时字幕

使用限制

• 实时字幕仅支持北京、上海、新加坡、印尼、沙特地区。

• 单个用户最多可添加300个字幕模板。

使用流程

步骤一：添加字幕模板

• 通过控制台配置，具体操作请参见：字幕模板。

• 通过API配置，已提供以下接口供用户使用。

  添加直播字幕模板	添加字幕模板。
  更新字幕模板	更新字幕模板。
  删除字幕模板	删除字幕模板。
  查询字幕模板	查询字幕模板列表。

步骤二：添加字幕规则

• 通过控制台配置，具体操作请参见：字幕规则。

• 通过API配置，已提供以下接口供用户使用。

  添加实时字幕规则	添加字幕规则。
  删除字幕规则	删除字幕规则。
  更新字幕规则	更新字幕规则。
  查询字幕规则	查询字幕规则列表。

步骤三：直播推流

通过控制台的地址生成器或自主拼接直播流地址生成直播推流地址。具体操作详见：生成推流地址和播放地址。

步骤四：播放字幕流

要播放带字幕的直播流需要使用字幕流的播放地址，即需要在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设置：可以调用接口添加实时字幕规则添加字幕规则，或调用接口更新字幕规则更新字幕规则时设置参数IsLazy，取值true即为播流触发，取值false即为推流触发。