Configuración de Android set-up-android
Obtenga información sobre cómo configurar el complemento de recopilación de medios de streaming para dispositivos Android.
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
-
Añada el Media SDK descargado al proyecto.
-
Descomprima el archivo zip de Android (por ejemplo,
MediaSDK-android-v2.*.zip
). -
Compruebe si el archivo
MediaSDK.jar
existe en el directoriolibs/
. -
Añada la biblioteca al proyecto.
IntelliJ IDEA:
-
Haga clic con el botón secundario en el proyecto desde el panel Navegación del proyecto.
-
Seleccione Abrir configuración del módulo.
-
En Configuración del proyecto, seleccione Bibliotecas.
-
Haga clic en + para agregar una biblioteca nueva.
-
Seleccione Java y busque el archivo
MediaSDK.jar
. -
Seleccione los módulos en los que va a utilizar la biblioteca móvil.
-
Haga clic en Aplicar y, a continuación, en Aceptar para cerrar la ventana Configuración del módulo.
Eclipse:
-
En Eclipse IDE, haga clic con el botón secundario en el nombre del proyecto.
-
Haga clic en Ruta de compilación > Agregar archivos externos.
-
Seleccione
MediaSDK.jar
. -
Haga clic en Abrir.
-
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.
-
Haga clic en las pestañas Ordenar y Exportar.
-
Asegúrese de que el archivo
MediaSDK.jar
está seleccionado.
-
-
-
Importe la biblioteca.
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;
-
Cree la instancia de
MediaHeartbeatConfig
.Este es un ejemplo de una inicialización de
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>;
-
Implemente la interfaz de
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>; }
-
Cree la instancia de
MediaHeartbeat
.Utilice la instancia de
MediaHeartbeatConfig
y la instancia deMediaHertbeatDelegate
para crear la instancia deMediaHeartbeat
.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT 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 sobre la migración de 1.x a 2.x, consulte la documentación de Implementación heredada.