VTTRegion

有限可用性

此功能不是基线功能,因为它在一些最广泛使用的浏览器中不起作用。

VTTRegion 接口是 WebVTT API 的一部分,它描述了视频的一部分,以便将 VTTCue 渲染到该部分。

构造函数

VTTRegion()

返回一个新创建的 VTTRegion 对象。

实例属性

VTTRegion.id

标识区域的字符串。

VTTRegion.width

表示区域的宽度,以视频的百分比表示。

VTTRegion.lines

表示区域的高度,以行数表示。

VTTRegion.regionAnchorX

表示区域锚点 X 偏移量,以区域的百分比表示。

VTTRegion.regionAnchorY

表示区域锚点 Y 偏移量,以区域的百分比表示。

VTTRegion.viewportAnchorX

表示视口锚点 X 偏移量,以视频的百分比表示。

VTTRegion.viewportAnchorY

表示视口锚点 Y 偏移量,以视频的百分比表示。

VTTRegion.scroll

一个枚举,表示添加新提示时如何移动现有提示。

示例

js
const region = new VTTRegion();
region.width = 50; // Use 50% of the video width
region.lines = 4; // Use 4 lines of height.
region.viewportAnchorX = 25; // Have the region start at 25% from the left.
const cue = new VTTCue(2, 3, "Cool text to be displayed");
cue.region = region; // This cue will be drawn only within this region.

规范

规范
WebVTT:Web 视频文本轨道格式
# the-vttregion-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。