在 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();
}