Flash 専用 プレーヤ API をクローズド キャプションに使用する
このトピックでは、Video Cloud 動画にクローズド キャプションを含めるために使用する、キャプション モジュール API を紹介します。この API は、Video Cloud の Flash 専用プレーヤ API の一部です。
ほとんどの場合、ブライトコーブでは、Flash 専用プレーヤ API ではなく、スマート プレーヤ API の使用を推奨します。スマート プレーヤ API でキャプション モジュールを使用する方法について参照してください。
このトピックを進めるにあたり、ユーザーが Flash 専用プレーヤ API に精通していると仮定しています。詳細は、「プレーヤ API の概要」、「プレーヤ API の基礎」、および「プレーヤ API リファレンス」を参照してください。よりシンプルなものとして、標準のプレーヤ テンプレートである Accessible Video Player を使用することも可能です。
キャプション モジュール API を使用して、Video Cloud 動画にクローズド キャプションを割り当てることができます。Video Cloud は、クローズド キャプションのための DFXP（Distribution Format Exchange Profile）フォーマットをサポートしています。DFXP は、W3C が開発した、XML ベースのキャプション付加形式です。それは、配信システム間での交換に使用するための、TTAF（Timed Text Authoring Format）の抽象ドキュメント タイプです。他の XML 形式と同様に、要素と属性で定義されます。DFXP 文書インスタンスのルート ドキュメントは、timed text（tt）要素でなければなりません。「TTML 仕様」にて定義されているように、有効な名前空間を含むなど、DFXP ドキュメントが有効であることを確認してください。
サンプル DFXP ファイル
Timed Text Markup Language（TTML）仕様に従った、基本サンプル DFXP ファイルの本体を次に挙げます。
<body region="subtitleArea">
<div>
<p xml:id="subtitle1" begin="0.76s" end="3.45s">
矛盾していますよね。
</p>
<p xml:id="subtitle2" begin="5.0s" end="10.0s">
網膜にできる画像は<br/>
逆転しているなんて。
</p>
<p xml:id="subtitle3" begin="10.0s" end="16.0s" style="s2">
不思議ですね。<br/>
ものが上下逆に見えないのは、なぜでしょう。
</p>
<p xml:id="subtitle4" begin="17.2s" end="23.0s">
脳も逆転している<br/>
そんな理論は、聞いたことがないでしょう？
</p>
<p xml:id="subtitle5" begin="23.0s" end="27.0s" style="s2">
実際、逆転していません！なんて素晴らしい事実でしょう！
</p>
<p xml:id="subtitle6a" begin="28.0s" end="34.6s" style="s2Left">
しかし、どうやって証明しますか？
</p>
<p xml:id="subtitle6b" begin="28.0s" end="34.6s" style="s1Right">
つまり、私たちが
</p>
<p xml:id="subtitle7" begin="34.6s" end="45.0s" style="s1Right">
脳の頂点と呼んでいる部分が<br/>
本当は底なんです
</p>
<p xml:id="subtitle8" begin="45.0s" end="52.0s" style="s1Right">
そして、底と呼んでいる部分が<br/>
本当は頂点なんです。
</p>
<p xml:id="subtitle9a" begin="53.5s" end="58.7s">
単に名前の問題です。
</p>
<p xml:id="subtitle9b" begin="53.5s" end="58.7s" style="s2">
本当に楽しいですね！
</p>
</div>
</body>
キャプション モジュール API
この API では、（DFXP フォーマットの）キャプション ファイルをロードし、ID ごとに現在の動画または特定の動画にそれを割り当てることでできます。API は、ファイルのロードおよびパースの結果により、成功またはエラー イベントをディスパッチします。また、API は、キャプションの言語を設定し、キャプションが利用可能な言語をすべて取得するメソッドを提供します。
- loadDFXP（url、videoID）： DFXP ファイルの URL を与えられると、動画にキャプション ファイルをロードします。
- setLanguage（language）： キャプションに使用する言語を設定します。
- getLanguages（videoID）： 対象動画に利用可能なキャプションの言語をすべて返します。
利用可能なメソッドおよびイベントに関する詳細は、「プレーヤ API リファレンス」を参照してください。
例
プラグインを使用して DFXP キャプション ファイルをロードする方法を示す簡単な例は、「動画に DFXP キャプションを表示する」を参照してください。
制約事項
これは、弊社のクローズド キャプションのサポートの最初のリリースです。現在のサポートをベースにする計画ですが、このリリースの時点では API にいくつかの制限があります。
- ブライトコーブは、DFXP ファイルの作成やホストを行いません。クローズド キャプション コンテンツの作成でヘルプが必要な場合、弊社パートナにお問い合わせください。
- 現在、DFXP フォーマットのキャプションのみをサポートしています。SUB、SRT、SBV、SAMI、SML など、他のフォーマットのキャプションはサポートしていません。
- 現在スタイルの要素あるいはスタイルの属性を、DFXP ファイルでサポートしていません。
