Show Menu
主题×

设置 Android

Adobe 将于 2021 年 8 月 31 日终止支持版本 4 Mobile SDK,届时还将终止对适用于 iOS 和 Android 的 Media Analytics SDK 的支持。有关更多信息,请参阅 Media Analytics SDK 支持终止常见问题解答

先决条件

  • 获取 Media SDK 的有效配置参数
    在设置 Analytics 帐户后,您可以从 Adobe 代表处获取这些参数。
  • 在应用程序中实施适用于 Android 的 ADBMobile
    有关 Adobe Mobile SDK 文档的更多信息,请参阅 适用于 Experience Cloud 解决方案的 Android SDK 4.x
  • 在媒体播放器中提供以下功能:
    • 用于订阅播放器事件的 API
      - Media SDK 要求在播放器中发生事件时调用一组简单的 API。
    • 提供播放器信息的 API
      - 此信息包括媒体名称和播放头位置等详细信息。

SDK 实施

  1. 下载 的 Media SDK 添加到您的项目中。
    1. 展开 Android zip 文件(例如,
      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