Configuration d’Android set-up-android
Découvrez comment configurer le module complémentaire Collection de médias en flux continu pour les appareils Android.
Conditions préalables
-
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 :
- Une API pour vous abonner aux événements du lecteur - Le SDK Media exige d’appeler un ensemble d’API simples lorsque des événements se produisent dans votre lecteur.
- Une API qui fournit des informations au lecteur - Ces informations incluent des éléments tels que le nom du média et la position de la tête de lecture.
Implémentation du SDK
-
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 fichierMediaSDK.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.
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;
-
Créez l’instance
MediaHeartbeatConfig
.Voici un exemple d’
MediaHeartbeatConfig
initialisation :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>;
-
Mettez en œuvre l’interface
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>; }
-
Créez l’instance
MediaHeartbeat
.Utilisez l’instance
MediaHeartbeatConfig
et l’instanceMediaHertbeatDelegate
pour créer l’instanceMediaHeartbeat
.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT 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 la version 1.x vers la version 2.x, consultez la documentation sur l’implémentation héritée.