设置 Android set-up-android
了解如何为Android设备设置流媒体收集加载项。
先决条件
-
获取 Media SDK 的有效配置参数
在设置 Analytics 帐户后,您可以从 Adobe 代表处获取这些参数。 -
在应用程序中实施适用于 Android 的 ADBMobile
有关 Adobe Mobile SDK 文档的更多信息,请参阅适用于 Experience Cloud 解决方案的 Android SDK 4.x。 -
在媒体播放器中提供以下功能:
- 用于订阅播放器事件的 API - Media SDK 要求在播放器中发生事件时调用一组简单的 API。
- 提供播放器信息的 API - 此信息包括媒体名称和播放头位置等详细信息。
SDK 实施
-
将下载的 Media SDK 添加到您的项目中。
-
展开 Android zip 文件(例如,
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 的信息,请参阅旧版实施文档。