Show Menu
TOPICS×

Configuration d’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 .

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

  1. Ajoutez le SDK Media que vous avez téléchargé à votre projet.
    1. Décompressez le fichier .zip Android (par exemple,
      MediaSDK-android-v2.*.zip
      ).
    2. Vérifiez que le répertoire
      libs/
      contient le fichier
      MediaSDK.jar
      .
    3. Ajoutez la bibliothèque à votre projet.
      IntelliJ IDEA :
      1. Cliquez avec le bouton droit sur votre projet dans le panneau
        Navigation dans le projet
        .
      2. Sélectionnez
        Ouvrir les paramètres du module
        .
      3. Sous
        Paramètres du projet
        , sélectionnez
        Bibliothèques
        .
      4. Cliquez sur ]
        +
        [ pour ajouter une nouvelle bibliothèque.
      5. Sélectionnez
        Java
        et accédez au fichier
        MediaSDK.jar
        .
      6. Sélectionnez les modules dans lesquels vous prévoyez d’utiliser la bibliothèque mobile.
      7. Cliquez sur
        Appliquer
        puis sur
        OK
        pour fermer la fenêtre Paramètres du module.
        Eclipse :
      8. Dans Eclipse IDE, cliquez avec le bouton droit sur le nom du projet.
      9. Cliquez sur
        Créer un chemin
         >
        Ajouter des archives externes
        .
      10. Sélectionnez
        MediaSDK.jar
        .
      11. Cliquez sur
        Ouvrir
        .
      12. Cliquez de nouveau avec le bouton droit sur le projet, puis sélectionnez
        Créer un chemin
        >
        Configurer la création d’un chemin
        .
      13. Cliquez sur les onglets
        Commande
        et
        Exporter
        .
      14. Assurez-vous que le fichier
        MediaSDK.jar
        est bien sélectionné.
  2. 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;
  3. 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>;
  4. 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>; }
  5. 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.