設定 Android

了解如何為 Android 裝置設定適用於串流媒體的 Analytics。

重要

我們於 2021 年 8 月 31 日停止支援第 4 版 Mobile SDK 後，Adobe 也將停止支援 Media Analytics SDK iOS 版和 Android 版。如需詳細資訊，請參閱 Media Analytics SDK 支援終止常見問題集。

先決條件

  • 取得適用於 Media SDK 的有效設定參數
    在您設定分析帳戶後，即可從 Adobe 代表取得這些參數。

  • 在您的應用程式實作 Android 適用的 ADBMobile
    如需 Adobe Mobile SDK 文件的詳細資訊，請參閱 Experience Cloud 解決方案適用的 Android SDK 4.x。

  • 在您的媒體播放器中提供下列功能：

    • 訂閱播放器事件專用的 API - 當您的播放器中發生事件時，Media SDK 需要您呼叫一組簡易 API。
    • 提供播放器資訊的 API - 此資訊包含媒體名稱和播放點位置等詳細內容。

SDK 實作

  1. 將下載的 Media SDK 新增至專案。

    1. 展開 Android 壓縮檔案 (例如 MediaSDK-android-v2.*.zip)。

    2. 驗證 MediaSDK.jar 目錄中存在 libs/ 檔案.

    3. 將程式庫新增至專案。

      IntelliJ IDEA：

      1. 在​「專案導覽」​面板中，以滑鼠右鍵按一下專案。

      2. 選取​「開啟模組設定」。

      3. 在​「專案設定」​下，選取​「資料庫」。

      4. 按一下 + 新增新程式庫。

      5. 選取​「Java」 並導覽至 MediaSDK.jar 檔案。

      6. 選取您計劃使用行動程式庫所在的模組。

      7. 按一下​「套用」，然後按​「確定」，關閉「模組設定」視窗。

      Eclipse：

      1. 在 Eclipse IDE 中，用滑鼠右鍵按一下專案名稱。

      2. 按一下「建立路徑 > 新增外部封存檔」。

      3. 選擇 MediaSDK.jar.

      4. 按一下​「開啟」。

      5. 再次以滑鼠右鍵按一下專案，然後按一下「組建路徑 > 設定組建路徑」。

      6. 依序按一下​「順序」​和​「匯出」​標籤。

      7. 確認已選取 MediaSDK.jar 檔案。

  2. 匯入資料庫。

    import com.adobe.primetime.va.simple.MediaHeartbeat;
import com.adobe.primetime.va.simple.MediaHeartbeat.MediaHeartbeatDelegate;
import com.adobe.primetime.va.simple.MediaHeartbeatConfig;
import com.adobe.primetime.va.simple.MediaObject;

  3. 建立 MediaHeartbeatConfig 例項。

    以下示範 MediaHeartbeatConfig 初始化：

    // Media Heartbeat Initialization
config.trackingServer = _<SAMPLE_HEARTBEAT_TRACKING_SERVER>_;
config.channel = <SAMPLE_HEARTBEAT_CHANNEL>;
config.appVersion = <SAMPLE_HEARTBEAT_SDK_VERSION>;
config.ovp =  <SAMPLE_HEARTBEAT_OVP_NAME>;
config.playerName = <SAMPLE_PLAYER_NAME>;
config.ssl = <true/false>;
config.debugLogging = <true/false>;

  4. 實作 MediaHeartbeatDelegate 介面。

    public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}

    // Replace <bitrate>, <startupTime>, <fps>, and
// <droppeFrames> with the current playback QoS values.
@Override
public MediaObject getQoSObject() {
    return MediaHeartbeat.createQoSObject(<bitrate>,
                                          <startupTime>,
                                          <fps>,
                                          <droppedFrames>);
}

//Replace <currentPlaybackTime> with the video player current playback time
@Override
public Double getCurrentPlaybackTime() {
    return <currentPlaybackTime>;
}

  5. 建立 MediaHeartbeat 例項。

    合併使用 MediaHeartbeatConfig 例項和 MediaHertbeatDelegate 例項，以建立 MediaHeartbeat 例項。

    // Replace <MediaHertbeatDelegate> with your delegate instance
MediaHeartbeat _heartbeat =
  new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    重要

    請確保您的 MediaHeartbeat 例項可供存取，並且​不會在工作階段結束前遭到取消配置。此例項將用於下列所有追蹤事件。

新增應用程式權限

使用 Media SDK 的應用程式需要下列權限，才能在追蹤呼叫中傳送資料：

  • INTERNET
  • ACCESS_NETWORK_STATE

若要新增這些權限，請在應用程式專案目錄裡的 AndroidManifest.xml 檔案中加入下列各行：

  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

在 Android 中從 1.x 版移轉至 2.x 版

在 2.x 版中，所有公用方法皆已整合至 com.adobe.primetime.va.simple.MediaHeartbeat 類別，讓開發人員更容易操作。此外，所有的設定現已整合至 com.adobe.primetime.va.simple.MediaHeartbeatConfig 類別。

如需有關從 1.x 移轉至 2.x 的資訊，請參閱舊版實作文件。

本頁內容