設定 Android set-up-android
瞭解如何為Android裝置設定串流媒體收集附加元件。
先決條件
-
取得適用於 Media SDK 的有效設定參數
在您設定分析帳戶後,即可從 Adobe 代表取得這些參數。 -
在您的應用程式實作 Android 適用的 ADBMobile
如需 Adobe Mobile SDK 文件的詳細資訊,請參閱 Experience Cloud 解決方案適用的 Android SDK 4.x。 -
在您的媒體播放器中提供下列功能:
- 訂閱播放器事件專用的 API - 當您的播放器中發生事件時,Media SDK 需要您呼叫一組簡易 API。
- 提供播放器資訊的 API - 此資訊包含媒體名稱和播放點位置等詳細內容。
SDK 實作
-
將下載的 Media SDK 新增至專案。
-
展開 Android 壓縮檔案 (例如
MediaSDK-android-v2.*.zip
)。 -
驗證
MediaSDK.jar
目錄中存在libs/
檔案. -
將程式庫新增至專案。
IntelliJ IDEA:
-
在 「專案導覽」 面板中,以滑鼠右鍵按一下專案。
-
選取 「開啟模組設定」。
-
在 「專案設定」 下,選取 「資料庫」。
-
按一下 + 新增新程式庫。
-
選取 「Java」 並導覽至
MediaSDK.jar
檔案。 -
選取您計劃使用行動程式庫所在的模組。
-
按一下 「套用」,然後按 「確定」,關閉「模組設定」視窗。
Eclipse:
-
在 Eclipse IDE 中,用滑鼠右鍵按一下專案名稱。
-
按一下「建立路徑 > 新增外部封存檔」。
-
選擇
MediaSDK.jar
. -
按一下 「開啟」。
-
再次以滑鼠右鍵按一下專案,然後按一下「組建路徑 > 設定組建路徑」。
-
依序按一下 「順序」 和 「匯出」 標籤。
-
確認已選取
MediaSDK.jar
檔案。
-
-
-
匯入資料庫。
code language-java 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;
-
建立
MediaHeartbeatConfig
例項。以下示範
MediaHeartbeatConfig
初始化:code language-java // 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>;
-
實作
MediaHeartbeatDelegate
介面。code language-java public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
code language-java // 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>; }
-
建立
MediaHeartbeat
例項。合併使用
MediaHeartbeatConfig
例項和MediaHertbeatDelegate
例項,以建立MediaHeartbeat
例項。code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT 請確保您的 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 的資訊,請參閱舊版實作文件。