Android でのコア再生の追跡 track-core-playback-on-android

トラッキングの初期設定

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

createMediaObject API

StreamType定数：

MediaType定数：

MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
  <MEDIA_ID>, <MEDIA_LENGTH>, <STREAM_TYPE>, <MEDIA_TYPE>);

メタデータのアタッチ

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

• 標準メタデータ

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

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

  • メディアメタデータキー API リファレンス - 標準メタデータキー - Android
  • 利用可なビデオメタデータの包括的なセットについては、オーディオおよびビデオパラメーターを参照してください。

• カスタムメタデータ

  カスタム変数のディクショナリを作成し、このメディアのデータを設定します。次に例を示します。

  code language-java
  HashMap<String, String> mediaMetadata = new HashMap<String, String>(); mediaMetadata.put("isUserLoggedIn", "false"); mediaMetadata.put("tvStation", "Sample TV Station"); mediaMetadata.put("programmer", "Sample programmer");

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

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

public void onVideoLoad(Observable observable, Object data) {
    _heartbeat.trackSessionStart(mediaInfo, mediaMetadata);
}

実際の再生開始を追跡

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

// Video is rendered on the screen) and call trackPlay.
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}

再生の完了を追跡

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

public void onVideoComplete(Observable observable, Object data) {
    _heartbeat.trackComplete();
}

セッションの終了を追跡

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

// Closes the media and/or the media completed and unloaded,
// and call trackSessionEnd().
public void onMainVideoUnload(Observable observable, Object data) {
    _heartbeat.trackSessionEnd();
}

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

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

public void onVideoPause(Observable observable, Object data) {
    _heartbeat.trackPause();
}

一時停止のシナリオ

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

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

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

// trackPlay()
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}