キューポイントを追加

入門

キューポイントは、ビデオタイムライン上の指定された場所です。ビデオが再生されると、キューポイントに到達するたびにイベントが自動的にブロードキャストされます。PlayerAPIを使用すると、これらのイベントをリッスンして、必要なアクションを実行できます。さらに、プレーヤーに保存されているビデオメタデータからすべてのキューポイント情報を読み取ることができますmediainfoオブジェクト、それはあなたがすることを可能にしますビデオタイムラインでキューポイントをマークします必要に応じて何らかの方法で。

キューポイントには次の2種類があります。

• 広告キューポイント：これらは、広告リクエストを行う必要がある場所をマークするために使用されます（ビデオとプレーヤーで広告が有効になっている場合）。
• コードキューポイント：これらは、Player APIを使用して何らかのアクションを実行するために使用されます-いくつかの典型的な使用法は、ある種の行動を促すフレーズ（CTA）を表示したり、ビデオコンテンツに関連する画像やテキストをビデオオーバーレイとして表示したり、プレーヤーの周りのページ。

実装の概要

キューポイントを追加できますスタジオメディアモジュール。このサンプルで使用する方法であるCMS APIを使用してそれらを追加することもできます。

HTTPメソッド

キューポイントは、次のいずれかの場合に追加できます。ビデオを作成するまたは後で更新リクエスト。このサンプルでは、既存のビデオにそれらを追加します。ビデオアップデートリクエスト、つまり、PATCH方法。

終点

ビデオ更新リクエストのエンドポイントは次のとおりです。

          https://cms.api.brightcove.com/v1/accounts/account_id / videos /  video_id

リクエスト本文

リクエストの本文は、ビデオメタデータの多くのアイテムを含むことができるJSONオブジェクトです。ここでは、cue_points次のサンプルのように、キューポイントオブジェクトの配列に設定されているフィールド。

          {
          "cue_points": [
              {
                "name": "Ad Cue Point",
                "type": "AD",
                "time": 2.0,
                "metadata": null,
                "force_stop": false
              },
              {
                "name": "Code Cue Point",
                "type": "CODE",
                "time": 4.0,
                "metadata": "The metadata might be text or the url for an image to display",
                "force_stop": true
              }
            ]
          }

キューポイントオブジェクトフィールド

以下は、キューポイントオブジェクトのフィールドの説明です。

注

• ^[1] 技術的には、キューポイントは次のキューポイントに到達するまでアクティブです。したがって、Brightcove Playerから取得できるキューポイント配列には、startTimeとendTime同様にtimeキューポイント用。

サンプルアプリ

Pen CMS API のサンプルを参照してください。キューポイントを追加 Brightcove Learning Services（ @ rcrooks1969） オンCodePen。