Chromecast でコア再生を追跡 track-core-playback-on-chromecast

トラッキングの初期設定

いつユーザーが再生の意図をトリガーする（ユーザーが再生をクリックする、または自動再生がオンになる）かを識別し、MediaObject インスタンスを作成します。

MediaObjectAPI リファレンス:

createMediaObject

mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);

StreamType定数：

ADBMobile メディア

MediaType定数：

ADBMobile メディア

ビデオメタデータのアタッチ

オプションで、コンテキストデータ変数を使用して標準またはカスタムのビデオメタデータオブジェクトをビデオトラッキングセッションにアタッチします。

• 標準のビデオメタデータ

  Chromecast での標準メタデータの実装

  note note
  NOTE
  メディアオブジェクトへの標準のビデオメタデータオブジェクトのアタッチはオプションです。

• カスタムメタデータ

  カスタム変数の変数オブジェクトを作成し、このビデオのデータを設定します。次に例を示します。

  code language-js
  /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };

意図を追跡して再生を開始

メディアセッションの追跡を開始するには、media オブジェクトの trackSessionStart を呼び出します。

ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);

実際の再生開始を追跡

ビデオの再生開始（ビデオの最初のフレームが画面に表示）に関するイベントをビデオプレーヤーから識別し、trackPlay を呼び出します。

ADBMobile.media.trackPlay();

再生ヘッド値を更新

再生ヘッドが変更されたときは、mediaUpdatePlayhead の位置の値を複数回更新します。
ビデオオンデマンド（VOD）の場合、値はメディアアイテムの開始時からの秒数で指定されます。
ライブストリーミングでは、プレーヤーがコンテンツのデュレーションに関する情報を提供しない場合、その日の午前 0 時（UTC）からの秒数を指定できます。

ADBMobile().media.updatePlayhead(position)

再生の完了を追跡

ビデオの再生完了（ユーザーがコンテンツを最後まで視聴）に関するイベントをビデオプレーヤーから識別し、trackComplete を呼び出します。

ADBMobile.media.trackComplete();

セッションの終了を追跡

ビデオ再生のアンロード／終了（ユーザーがビデオを閉じる、またはビデオの再生が完了してアンロードされる）に関するイベントをビデオプレーヤーから識別し、trackSessionEnd を呼び出します。

ADBMobile.media.trackSessionEnd();

考えられるすべての一時停止シナリオを追跡

ビデオの一時停止に関するイベントをビデオプレーヤーから識別し、trackPause を呼び出します。

ADBMobile.media.trackPause();

一時停止のシナリオ

ビデオプレーヤーが一時停止するあらゆるシナリオを識別して、trackPause が適切に呼び出されるようにします。以下のシナリオでは、アプリで trackPause() () を呼び出す必要があります。

• アプリ内でユーザーが明示的に一時停止をクリックする。
• プレーヤー自体が一時停止状態になる。
• （モバイルアプリケーション）- ユーザーがアプリケーションをバックグラウンドに移行した場合でも、アプリケーションのセッションを開いたままにしておきたい。
• （モバイルアプリケーション）- 何らかのシステムの割り込みが生じ、アプリケーションがバックグラウンドに移行する。例：ユーザーに電話がかかってきた場合や、別のアプリケーションのポップアップが表示された場合でも、アプリケーションのセッションを終了せず、ユーザーが中断した場所からビデオを再開できるようにしたい。

一時停止からのビデオ再生およびビデオ再開に関するイベントをプレーヤーから識別し、trackPlay を呼び出します。

ADBMobile.media.trackPlay();