設定 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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now