設定 Android

重要

我們於 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:

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

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

      10. 選擇 MediaSDK.jar.

      11. 按一下​「開啟」

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

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

      14. 確認已選取 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 的詳細資訊,請參閱 mig-1x-2x-overview.md

本頁內容