我在获取一个从WebVTT文件读取元数据的工作示例时遇到麻烦，该文件是由HTML5页面中<track>的<video>元素指定的。明确地说，我不是在谈论从视频文件本身中读取元数据(例如，使用MPEG传输流)。我在说的是用于字幕视频的<track>元素。 <track>的属性之一是kind，可以将其指定为以下任意值:
我正在尝试使用元数据类型来访问存储在相应的WebVTT文件中的文本，我打算使用JavaScript对其进行操作。我知道这是可能的，因为它是mentioned by Silvia Pfeiffer和by the maker of Captionator，这是我用来实现解释
<track>标记功能的JavaScript polyfill。但是，我只是无法正常工作。我的代码基于Captionator文档的标题示例。我添加了一个按钮来检索元数据并在单击按钮时显示它。不幸的是，它一直显示“未定义”而不是元数据。有什么想法我可能做错了吗？另外，有人知道我可以在哪里工作的例子吗？我在任何地方都找不到。
如果您愿意看一下我的代码，我将其包括在下面:
<!DOCTYPE html>
<html>
<head>
<title>HTML5 Video Closed Captioning Example</title>
<meta charset="utf-8">
<link rel="stylesheet" type="text/css" media="screen" href="js/Captionator-v0.5-12/css/captions.css"/>
</head>
<body>
<h1>HTML5 Video Closed Captioning Example</h1>
<div>
<p id="metadataText">Metadata text should appear here</p>
<input type='button' onclick='changeText()' value='Click here to display the metadata text'/>
</div>
<video controls autobuffer id="videoTest" width="1010" height="464">
<source src="http://localhost:8080/Videos/testVideo.webm" type="video/webm" />
<source src="http://localhost:8080/Videos/testVideo.mp4" type="video/mp4" />
<!-- WebVTT Track Metadata Example -->
<track label="Metadata Track" kind="metadata" src="http://localhost:8080/Videos/Timed_Text_Tracks/testVideo_metadata.vtt" type="text/webvtt" srclang="en" />
</video>
<!-- Include Captionator -->
<script type="text/javascript" src="js/Captionator-v0.5-12/js/captionator.js"></script>
<!-- Example Usage -->
<script type="text/javascript" src="js/Captionator-v0.5-12/js/captionator-example-api.js"></script>
<script type="text/javascript">
window.addEventListener("load",function() {
captionator.captionify(null,null,{
debugMode: !!window.location.search.match(/debug/i),
sizeCuesByTextBoundingBox: !!window.location.search.match(/boundingBox/i),
enableHighResolution: !!window.location.search.match(/highres/i),
});
var videoObject = document.getElementsByTagName("video")[0];
videoObject.volume = 0;
document.body.appendChild(generateMediaControls(videoObject));
},false);
function changeText() {
document.getElementById('metadataText').innerHTML = testVar;
var cueText = document.getElementById("video").tracks[0].activeCues[0].getCueAsSource();
document.getElementById('metadataText').innerHTML = cueText;
}
</script>
</body>
</html>
我的WebVTT文件如下所示:
WEBVTT
0
00:00.000 --> 00:04.000
Testing 1 2 3 . . .
最佳答案
您访问提示的方式是正确的-那里没有问题(尽管Captionator 0.6从.tracks属性更改为.textTracks属性，使其更符合规范。如果您可以偶尔遇到错误，我会建议使用0.6以提高其标准合规性-我编写了以下代码以使用.textTracks-如果您想继续使用稳定分支，请替换为.tracks。)
问题与文本轨道本身的加载有关。目前，您实际上并没有在告诉Captionator加载轨道。因为这是异步发生的，并且在请求时会出现不可避免的延迟，导致无法提供其内容，因此您需要以适合加载时间和潜在加载错误的方式编写代码。
您也不必等待Captionator本身的加载-可能用户可能在不知不觉中单击该按钮之前就已经单击-触发了一个讨厌的JavaScript错误。在本地机器上进行测试时，这不会成为问题，但是一旦部署到互联网上，您将看到各种比赛条件和其他不良情况。考虑禁用该按钮，直到页面和字幕数据都已加载。
我试图使Captionator API尽可能接近实际的JS API，该API很快就会在浏览器中着陆-因此将来，这将与您与 native 浏览器功能进行交互的方式相同。一旦该功能在 native 可用，Captionator就会自动退出，并且您的代码应该(假设它们不再更改API!)只能与 native API一起使用。
首先，您需要实际请求Captionator加载内容。这是通过将轨道的“显示模式”设置为SHOWING或2来完成的。
var video = document.getElementByID("myVideo");
video.textTracks[0].mode = 2; // SHOWING
或者，您可以将轨道的状态分配给
HIDDEN(1)-仍会触发加载，并且cueChange事件仍会触发-但不会在屏幕上绘制提示。在Captionator中，我根本不会绘制要显示的元数据轨道，但是开发中的(笨拙的)WebKit API会显示出来。video.textTracks[0].mode = 1; // HIDDEN
然后，您需要监听提示的加载时间和可用时间:
video.textTracks[0].onload = function() { /* Your Code Here... */ }
或出现问题时:
video.textTracks[0].onerror = function() { /* Whoah, something went wrong... */ }
一旦加载了内容，就可以访问
TextTrack.cues数组(从技术上来说就是TextTrackCueList。)在加载之前，TextTrack.cues属性将是null。var myCueText = video.textTracks[0].cues[0].text;
请注意，Captionator会解析每个提示的提示文本，除非轨道类型为
metadata ，否则请确保分配正确的轨道类型。您可能最终得到Captionator认为抛出“无效”的数据或标签。您还可以通过将processCueHTML选项设置为false来针对常规提示也关闭此检查。考虑到这一点，以下是我重写您的代码的方法:
<div>
<p id="metadataText">Metadata text should appear here</p>
<input type='button' onclick='changeText()' value='Click here to display the metadata text' id="changetext" disabled />
</div>
<video controls autobuffer id="videoTest" width="512" height="288">
<!-- Your video sources etc... -->
<!-- The metadata track -->
<track label="Metadata Track" kind="metadata" src="metadata.vtt" type="text/webvtt" srclang="en" />
</video>
<!-- Include Captionator -->
<script type="text/javascript" src="captionator.js"></script>
<script type="text/javascript">
document.addEventListener("readystatechange",function(event) {
if (document.readyState === "complete") {
captionator.captionify();
document.querySelectorAll("#changetext")[0].removeAttribute("disabled");
}
},false);
function changeText() {
// Get the metadataText paragraph
var textOutput = document.querySelectorAll("#metadataText")[0];
// Get the metadata text track
var metadataTrack = document.querySelectorAll("video")[0].textTracks[0];
if (metadataTrack.readyState === captionator.TextTrack.LOADED) {
// The cue is already ready to be displayed!
textOutput.innerHTML = metadataTrack.cues[0].text;
} else {
// We check to see whether we haven't already assigned the mode.
if (metadataTrack.mode !== captionator.TextTrack.SHOWING) {
textOutput.innerHTML = "Caption loading...";
// The file isn't loaded yet. Load it in!
metadataTrack.mode = captionator.TextTrack.SHOWING; // You can use captionator.TextTrack.HIDDEN too.
metadataTrack.onload = function() {
textOutput.innerHTML = metadataTrack.cues[0].text;
}
metadataTrack.onerror = function() {
textOutput.innerHTML = "Error loading caption!";
}
}
}
}
</script>
在这里，我们将禁用该按钮，以防止处于慢速连接(或反射速度很快的人!)上的用户在Captionator或元数据轨道准备就绪之前点击该按钮，并监听加载事件-在这一点上，我们重新启用按钮，并可以照常检索提示文本。