设置 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

在此页面上