Découvrez comment configurer Streaming Media Analytics pour les appareils Android.
Avec l’abandon de la prise en charge des SDK mobiles de version 4 programmée au 31 août 2021, Adobe cessera également de prendre en charge le SDK Media Analytics pour iOS et Android. Pour plus d’informations, reportez-vous à la FAQ sur l’abandon de la prise en charge du SDK Media Analytics.
Obtention de paramètres de configuration valides pour le SDK Media Vous pouvez vous procurer ces paramètres auprès d’un représentant Adobe après avoir configuré votre compte Analytics.
Mise en œuvre d’ADBMobile pour Android dans votre application Pour plus d’informations sur la documentation du kit SDK Adobe Mobile, reportezvous à la rubrique Kit SDK Android 4.x pour les solutions Experience Cloud.
Fournissez les informations suivantes à votre lecteur multimédia :
Ajoutez le SDK Media que vous avez téléchargé à votre projet.
Décompressez le fichier .zip Android (par exemple, MediaSDK-android-v2.*.zip
).
Vérifiez que le répertoire libs/
contient le fichier MediaSDK.jar
.
Ajoutez la bibliothèque à votre projet.
IntelliJ IDEA :
Cliquez avec le bouton droit sur votre projet dans le panneau Navigation dans le projet.
Sélectionnez Ouvrir les paramètres du module.
Sous Paramètres du projet, sélectionnez Bibliothèques.
Cliquez sur + pour ajouter une nouvelle bibliothèque.
Sélectionnez Java et accédez au fichier MediaSDK.jar
.
Sélectionnez les modules dans lesquels vous prévoyez d’utiliser la bibliothèque mobile.
Cliquez sur Appliquer puis sur OK pour fermer la fenêtre Paramètres du module.
Eclipse :
Dans Eclipse IDE, cliquez avec le bouton droit sur le nom du projet.
Cliquez sur Créer un chemin > Ajouter des archives externes.
Sélectionnez MediaSDK.jar
.
Cliquez sur Ouvrir.
Cliquez de nouveau avec le bouton droit sur le projet, puis sélectionnez Créer un chemin > Configurer la création d’un chemin.
Cliquez sur les onglets Commande et Exporter.
Assurez-vous que le fichier MediaSDK.jar
est bien sélectionné.
Importez la bibliothèque.
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;
Créez l’instance MediaHeartbeatConfig
.
Voici un exemple d’ MediaHeartbeatConfig
initialisation :
// 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>;
Mettez en œuvre l’interface 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>;
}
Créez l’instance MediaHeartbeat
.
Utilisez l’instance MediaHeartbeatConfig
et l’instance MediaHertbeatDelegate
pour créer l’instance MediaHeartbeat
.
// Replace <MediaHertbeatDelegate> with your delegate instance
MediaHeartbeat _heartbeat =
new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
Assurez-vous que votre instance MediaHeartbeat
est accessible et reste attribuée jusqu’à la fin de la session. Cette instance sera utilisée pour tous les événements de suivi suivants.
Ajout des autorisations des applications
Votre application utilisant le SDK Media nécessite les autorisations suivantes pour envoyer des données dans les appels de suivi :
INTERNET
ACCESS_NETWORK_STATE
Pour ajouter ces autorisations, ajoutez les lignes suivantes à votre fichier AndroidManifest.xml
, situé dans le répertoire du projet d’application :
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migration de la version 1.x vers 2.x sur Android
Dans les versions 2.x, toutes les méthodes publiques sont consolidées dans la classe com.adobe.primetime.va.simple.MediaHeartbeat
pour faciliter le travail des développeurs. De plus, toutes les configurations sont désormais consolidées dans la classe com.adobe.primetime.va.simple.MediaHeartbeatConfig
.
Pour plus d’informations sur la migration de 1.x vers 2.x, voir mig-1x-2x-overview.md.