Show Menu
主題×

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