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

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now