JavaScript 3.x を使用したコア再生の追跡 track-core-playback-on-javascript

トラッキングの初期設定

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

createMediaObject API

StreamType定数：

MediaType定数：

var mediaObject = ADB.Media.createMediaObject(<MEDIA_NAME>,
                                  <MEDIA_ID,
                                  <MEDIA_LENGTH>,
                                  <STREAM_TYPE>,
                                  <MEDIA_TYPE>);

メタデータのアタッチ

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

• 標準メタデータ

  note note
  NOTE
  標準メタデータのアタッチは任意です。

  • メディアメタデータキー API リファレンス - 標準メタデータキー - JavaScript

    利用可能なメタデータの包括的なセットについては、オーディオおよびビデオパラメーターを参照してください。

• カスタムメタデータ

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

  code language-js
  /* Set context data */ var contextData = {}; //Standard metadata contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode"; contextData[ADB.Media.VideoMetadataKeys] = "Sample Show"; //Custom metadata contextData["isUserLoggedIn"] = "false"; contextData["tvStation"] = "Sample TV Station";

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

メディアセッションの追跡を開始するには、メディアハートビートインスタンスの trackSessionStart を呼び出します。

var mediaObject = ADB.Media.createMediaObject("video-name",
                                              "video-id",
                                              60.0,
                                              ADB.Media.StreamType.VOD,
                                              ADB.Media.MediaType.Video);

var contextData = {};

//Standard metadata
contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode";
contextData[ADB.Media.VideoMetadataKeys] = "Sample Show";

//Custom metadata
contextData["isUserLoggedIn"] = "false";
contextData["tvStation"] = "Sample TV Station";

tracker.trackSessionStart(mediaObject, contextData);

実際の再生開始を追跡

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

tracker.trackPlay();

再生ヘッド値を更新

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

tracker.updatePlayhead(position)

再生の完了を追跡

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

tracker.trackComplete();

セッションの終了を追跡

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

tracker.trackSessionEnd();

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

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

tracker.trackPause();

一時停止のシナリオ

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

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

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

tracker.trackPlay();