Show Menu
TOPICS×

Configuración de Android

Con la finalización de la compatibilidad con los SDK para móviles de la versión 4 el 31 de agosto de 2021, Adobe también dejará de ofrecer compatibilidad con el SDK de Media Analytics para iOS y Android. Para obtener más información, consulte Preguntas frecuentes sobre el fin de la asistencia del SDK de Media Analytics .

Requisitos previos

  • Obtenga parámetros de configuración válidos para Media SDK
    : Estos parámetros se pueden obtener de un representante de Adobe una vez creada la cuenta de Analytics.
  • Implemente ADBMobile para Android en su aplicación
    : Para obtener más información sobre la documentación del SDK de Adobe Mobile, consulte SDK de Android 4.x para las soluciones de Experience Cloud.
  • Proporcione las siguientes capacidades en su reproductor de contenidos
    :
    • Una API para suscribirse a eventos del reproductor
      : Media SDK requiere que llame a un conjunto de API simples cuando se produzcan eventos en el reproductor.
    • Una API que proporciona información del reproductor
      : Esta información incluye detalles como el nombre del medio y la posición del cabezal de reproducción.

Implementación del SDK

  1. Añada el Media SDK descargado al proyecto.
    1. Descomprima el archivo zip de Android (por ejemplo,
      MediaSDK-android-v2.*.zip
      ).
    2. Compruebe si el archivo
      MediaSDK.jar
      existe en el directorio
      libs/
      .
    3. Añada la biblioteca al proyecto.
      IntelliJ IDEA:
      1. Haga clic con el botón secundario en el proyecto desde el panel
        Navegación del proyecto
        .
      2. Seleccione
        Abrir configuración del módulo
        .
      3. En
        Configuración del proyecto
        , seleccione
        Bibliotecas
        .
      4. Haga clic en
        +
        para agregar una biblioteca nueva.
      5. Seleccione
        Java
        y busque el archivo
        MediaSDK.jar
        .
      6. Seleccione los módulos en los que va a utilizar la biblioteca móvil.
      7. Haga clic en
        Aplicar
        y, a continuación, en
        Aceptar
        para cerrar la ventana Configuración del módulo.
        Eclipse:
      8. En Eclipse IDE, haga clic con el botón secundario en el nombre del proyecto.
      9. Haga clic en
        Ruta de compilación
        >
        Agregar archivos externos
        .
      10. Seleccione
        MediaSDK.jar
        .
      11. Haga clic en
        Abrir
        .
      12. Vuelva a hacer clic con el botón derecho en el proyecto y, a continuación, seleccione
        Ruta de compilación
        >
        Configurar ruta de compilación
        .
      13. Haga clic en las pestañas
        Ordenar
        y
        Exportar
        .
      14. Asegúrese de que el archivo
        MediaSDK.jar
        está seleccionado.
  2. Importe la biblioteca.
    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. Cree la instancia de
    MediaHeartbeatConfig
    .
    Este es un ejemplo de una inicialización de
    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. Implemente la interfaz de
    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. Cree la instancia de
    MediaHeartbeat
    .
    Utilice la instancia de
    MediaHeartbeatConfig
    y la instancia de
    MediaHertbeatDelegate
    para crear la instancia de
    MediaHeartbeat
    .
    // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    Asegúrese de que la instancia de
    MediaHeartbeat
    es accesible y
    no se desasigna hasta el final de la sesión
    . Esta instancia se utilizará para todos los eventos de seguimiento posteriores.
Añadir permisos de aplicación
La aplicación que utiliza Media SDK requiere los siguientes permisos para enviar datos en las llamadas de seguimiento:
  • INTERNET
  • ACCESS_NETWORK_STATE
Para agregar estos permisos, agregue las siguientes líneas al archivo
AndroidManifest.xml
en el directorio del proyecto de la aplicación:
  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migración de la versión 1.x a 2.x en Android
En las versiones 2.x, todos los métodos públicos se incluyen en la clase
com.adobe.primetime.va.simple.MediaHeartbeat
para facilitar el trabajo de los desarrolladores. Asimismo, todas las configuraciones están consolidadas en la clase
com.adobe.primetime.va.simple.MediaHeartbeatConfig
.
Para obtener información detallada sobre la migración de 1.x a 2.x, consulte mig-1x-2x-overview.md.