BrightcovePlayerを使用したクロスデバイスレジューム

「このトピックでは、Brightcove Playerでクロスデバイスレジュームを使用する方法を学びます。「

概要

クロスデバイス再開を使用すると、視聴者は 1 つのデバイスで動画の視聴を開始し、後で別のデバイスで中断した動画の視聴を続けることができます。

誰かが自分のモバイルデバイス上でビデオを見始めるとしましょう。その後、彼らは自分のウェブブラウザでプレーヤーで同じビデオを見続けることができます。彼らが中断したところで再生は継続するので、彼らはものを見逃すことはありません。

必要条件

クロスデバイス再開には、次の要件が適用されます。

Brightcove Playerバージョン 6.41.0+

セットアップ

この機能は、Brightcove Video Cloud アカウントをお持ちの方であれば誰でも利用できます。

開始するには、次の操作を行います。

アカウントでクロスデバイス再開を有効にする場合は、アカウントマネージャーにお問い合わせください
使用している動画がダイナミック配信用に取り込まれていることを確認します

クロスデバイス再開の実装

クロスデバイス再開を実装するには、次の手順を実行します。

ブライトコーブアナリティクスでのユーザー識別子の設定
ビューアの再生位置を取得する
Brightcove Playerでの再生を再開する

ユーザー識別子の設定

まず、表示アクティビティを保存するためのユーザー識別子を設定する必要があります。

Brightcove Player

Brightcove Player を使用している場合は、次の手順を実行します。

視聴者のデータは自動的に Brightcove アナリティクスに送信されますが、ユーザー ID を設定する必要があります。これを行うには、setUser()メソッドを使用します。例:
```
myPlayer.bcAnalytics.client.setUser('viewer id');
```
Brightcove Player をホストする Web サイトでは、認証ゲートウェイまたは一部の ID 管理ソリューションを使用して視聴者を追跡できます。このビューアー ID をビューア ID として使用し、ブライトコーブの分析に渡します。

プレーヤーにソースを設定する前に、視聴者 ID を設定することが重要です。プレーヤーを初期化した直後に呼び出す必要があります。

<video-js
    id="myPlayerID"
    data-account="1752604059001"
    data-player="hyQW6GByl"
    data-embed="default"
    controls=""
    data-video-id="6156696074001"
    data-playlist-id=""
    data-application-id=""
    width="640" height="360"></video-js>
  <script src="https://players.brightcove.net/1752604059001/hyQW6GByl_default/index.min.js"></script>

  <script>
    videojs.getPlayer('myPlayerID').ready(function() {
      var myPlayer = this;

      // Set the viewer id for Brightcove analytics
      myPlayer.bcAnalytics.client.setUser('viewer id');
    });
  </script>

いつsetUser()メソッドが使用される場合、値はハッシュされず、後続のすべてのビーコンとともに平文で送信されます。
この場合、player_inituserイベントにはフィールドは含まれませんが、すべてのvideo_*イベントにはそれを含める必要があります。

カスタムプレイヤー

Brightcove Player を使用しないカスタム実装を構築する場合は、データ収集 API userリクエストにパラメーターを追加します。詳細については、「概要」を参照してください。データ収集 API v2 ドキュメント。

プレーヤーをホストする Web サイトでは、認証ゲートウェイまたは一部の ID 管理ソリューションを使用して、視聴者を追跡できます。このビューア ID をビューア ID として使用して、ブライトコーブアナリティクスに渡します。

Brightcove userに渡されるこのパラメータは次のセクションで使用して、XDR API から再生位置を取得できます。

ビューアの再生位置を取得する

次に、クロスデバイス再開 (XDR) API からビューアの再生位置を取得します。

ビューアの再生位置を取得するには、REST API リクエストを行うサーバーサイドアプリケーションが必要です。

詳細については、「XDR API からの再生位置の取得」を参照してください。

再生を再開する

XDR API からビューアの再生位置を取得したら、その時点から再生を再開できます。

前のセクションのビューアの再生位置を使用して、currentTime()メソッドを使用して再生ヘッドの位置を設定します。

ここに例があります：

// The specific event to use may require some experimentation
player.on('loadstart', function() {

  // This initialPlayhead variable will have to come from the publisher's
  // custom integration.
  player.currentTime(viewer playhead position);
});

サーバー側プロキシを呼び出して XDR API から再生ヘッドを取得するウェブプレーヤーサンプルについては、 github の「クロスデバイス再開」サンプルを参照してください。
プレイリストやその他のマルチビデオシナリオでは、XDR API のプロキシを作成し、新しいビデオごとに最初の再生ヘッドを取得する必要があります。