メディアモジュールのでのキューポイントの操作
キューポイントは、動画内の特定時点を示すマーカーです。キューポイントを使用すると、ミッドロール広告（商用ブレイクなど、動画コンテンツの再生中に発生する広告）をトリガーしたり、長い形式の動画でチャプターやシーンを区切ったりすることができます。
キューポイントには 2 つのタイプがありますが、どちらも単にキューポイントオブジェクトの typeプロパティに文字列値を指定します。適切な値は、キューポイント情報の処理中にカスタム JavaScript で使用される場合にのみ役立ちます。
- Ad - ADの文字列値を typeプロパティに割り当てます。
- Code - CODE の文字列値を型プロパティに割り当てます。
Media モジュールまたはカタログ API を使用して、キューポイントをビデオに追加できます。Catalog API を使用したキューポイントの追加の詳細については、開発者向けドキュメント「プログラムによるキューポイントの実装」を参照してください。
キューポイントの追加
ビデオにキューポイントを追加するには、Media モジュールを開き、次の手順に従います。
- ビデオタイトルのリンクをクリックして、ビデオのプロパティページを開きます。
- プレビュープレーヤーを使用してビデオを再生します。キューポイントを追加するポイントでビデオを一時停止します。
- [ キューポイントを追加] をクリックします。
- 必要に応じて、キューポイントのタイムコード (hh: mm: ss)の値を調整します。secondsフィールドは、小数点以下のミリ秒をサポートすることに注意してください。
- [ キューポイントのタイプ] を選択し、適切なメタデータを追加します。
- 広告 -広告リクエストが行われます。広告キューポイントを使用する場合は、プレーヤーを広告用に構成する必要があります。
- コード -キューポイントはプログラムによって処理されます。詳細については、「プログラムによるキューポイントの実装」開発者ドキュメントを参照してください。
- キューポイントの名前を入力します。名前の値にはプログラムからアクセスすることができます。
- メタデータ (コードキューポイントの場合) またはキー/値のペア (広告キューポイントの場合) を入力します。
- Metadata -キューポイントとともに格納されるオプションのメタデータ。メタデータにはプログラムからアクセスすることができます。コードキューポイントを使用してメタデータを渡す場合の一例は、ビデオの再生中にさまざまなアクション呼び出しを表示する場合です。ブライトコーブプレーヤーのサンプルをご覧ください。キューポイントは CTAを例として表示します。
- キー/値のペア -広告リクエストに渡すことができるキー/値のペア。キーと値のペアは、2 つのリンクされたデータ項目のセットです。キーとは、あるデータ項目の一意の識別子であるキーと、識別されるデータまたはそのデータの場所へのポインタである値です。キーと値のペアは、よりターゲットを絞ったアドバタイズメントを提供するために使用できます。ここに入力されたものは、
{mediainfo.ad_keys}マクロが挿入される広告タグにコピーされます。詳細については、「IMA3 プラグインを使用した広告」を参照してください。
キューポイントをビデオに追加した後、実行時に、キューポイントは HTML5 WebVTT キューエレメントに変換されます。この変換が行われると、キューポイントデータの一部（タイプやキューポイントタイムなど）がテキストトラックに変換されます。キューポイント時間の値は WebVTT startTimeendTimeキューとプロパティにマッピングされます。見るこのドキュメント VTTCueインターフェイスの詳細については。
キューポイントの編集
ビデオのキューポイントを編集するには、Media モジュールを開き、次の手順に従います。
- ビデオタイトルのリンクをクリックして、ビデオのプロパティページを開きます。
- タイムラインで編集するキューポイントをクリックします。
- キューポイントのプロパティを編集し、[保存]をクリックします。
キューポイントの削除
キューポイントを削除するには、Media モジュールを開き、次の手順に従います。
- ビデオタイトルのリンクをクリックして、ビデオのプロパティページを開きます。
- タイムラインで削除するキューポイントをクリックします。
- 削除アイコンをクリックします（
）キューポイントプロパティの横。 - 削除を確認します。