Aprenda a configurar Streaming Media Analytics para dispositivos 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.
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:
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 directorio libs/
.
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.
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
:
// 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
.
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>;
}
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 sobre la migración de 1.x a 2.x, consulte la documentación de Implementación heredada.