Show Menu
TOPICS×

Configuration d’iOS

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 iOS dans votre application
    Pour plus d’informations sur la documentation du kit SDK Adobe Mobile, reportezvous à la rubrique Kit SDK iOS 4.x pour les solutions Experience Cloud.
    À partir d’iOS 9, Apple a introduit une fonction appelée ATS (App Transport Security). Cette fonctionnalité vise à améliorer la sécurité du réseau en veillant à ce que vos applications utilisent uniquement des protocoles et des algorithmes de chiffrement standard. Cette fonctionnalité est activée par défaut, mais vous disposez d’options de configuration vous permettant d’effectuer des choix quant à l’utilisation d’ATS. Pour plus d’informations sur ATS, voir Sécurité du transport des applications.
  • 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. Vérifiez que le répertoire
      libs
      contient les composants logiciels suivants :
      • ADBMediaHeartbeat.h
         : fichier d’en-tête Objective-C utilisé pour les API de suivi de la pulsation iOS.
      • ADBMediaHeartbeatConfig.h
         : fichier d’en-tête Objective-C utilisé pour la configuration du kit SDK.
      • MediaSDK.a
         : binaire gras en bytecode contenant les versions de bibliothèque pour les appareils (armv7, armv7s et arm64) et les simulateurs (i386 et x86_64) iOS.
        Ce binaire doit être lié lorsque la cible est destinée à une application iOS.
      • MediaSDK_TV.a
         : binaire gras en bytecode contenant les versions de bibliothèque pour les nouveaux appareils (arm64) et le nouveau simulateur (x86_64) Apple TV.
        Ce binaire doit être lié lorsque la cible est destinée à une application Apple TV (tvOS).
    2. Ajoutez la bibliothèque à votre projet :
      1. Lancez Xcode IDE et ouvrez votre application.
      2. Dans
        Navigateur de projets
        , faites glisser le répertoire
        libs
        sous votre projet.
      3. Assurez-vous que la case
        Copier les éléments si nécessaire
        est cochée, que
        Créer des groupes
        est sélectionné et qu’aucune des cases dans
        Ajouter à la cible
        n’est cochée.
      4. Cliquez sur
        Terminer
        .
      5. Dans
        Navigateur de projets
        , sélectionnez votre application et vos cibles.
      6. Liez les structures et bibliothèques requises dans la section
        Structures liées
        et
        Bibliothèques
        dans l’onglet
        Général
        .
        Cibles d’une application iOS :
        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd
          Cibles d’une application Apple TV (tvOS) :
        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      7. Vérifiez qu’aucune erreur n’est générée lors de la création de votre application.
  2. Importez la bibliothèque.
    #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
  3. Créez une instance
    ADBMediaHeartbeatConfig
    .
    Cette section vous aide à comprendre les paramètres de configuration
    MediaHeartbeat
    et à définir les bonnes valeurs de configuration sur votre instance
    MediaHeartbeat
    pour un suivi précis.
    Voici un exemple d’
    ADBMediaHeartbeatConfig
    initialisation :
    // Media Heartbeat Initialization ADBMediaHeartbeatConfig *config = [[ADBMediaHeartbeatConfig alloc] init]; 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 = <YES/NO>; config.debugLogging = <YES/NO>;
  4. Mettez en œuvre le protocole
    ADBMediaHeartbeatDelegate
    .
    @interface VideoAnalyticsProvider : NSObject <ADBMediaHeartbeatDelegate> @end @implementation VideoAnalyticsProvider // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> // with the current playback QoS values. - (ADBMediaObject *)getQoSObject { return [ADBMediaHeartbeat createQoSObjectWithBitrate:<bitrate> startupTime:<startuptime> fps:<fps> droppedFrames:<droppedFrames>]; } // Return the current video player playhead position. // Replace <currentPlaybackTime> with the video player current playback time - (NSTimeInterval)getCurrentPlaybackTime { return <currentPlaybackTime>; } @end
  5. Utilisez les instances
    ADBMediaHeartBeatConfig
    et
    ADBMediaHeartBeatDelegate
    pour créer l’instance
    ADBMediaHeartbeat
    .
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
    Assurez-vous que votre instance
    ADBMediaHeartbeat
    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.

Migration de la version 1.x vers 2.x sur iOS

Dans la version 2.x, toutes les méthodes publiques sont consolidées dans la classe
ADBMediaHeartbeat
pour faciliter le travail des développeurs. Toutes les configurations ont été consolidées dans la classe
ADBMediaHeartbeatConfig
.
Pour en savoir plus sur la migration de la version 1.x vers 2.x, consultez la rubrique Migration de VHL 1.x vers 2.x.

Configuration d’une application native pour tvOS

Avec la sortie de la nouvelle Apple TV, vous pouvez désormais créer des applications s’exécutant dans l’environnement natif de tvOS. Vous pouvez soit créer une application complètement native, à l’aide des différentes structures disponibles dans iOS, soit créer votre application à l’aide de modèles XML et de JavaScript. La version 2.0 du SDK Media prend désormais en charge tvOS. Pour en savoir plus sur tvOS, consultez le site du développeur tvOS.
Effectuez les étapes suivantes dans votre projet Xcode. Ce guide est rédigé en supposant que votre projet dispose d’une cible qui est une application Apple TV ciblant tvOS :
  1. Faites glisser le fichier de bibliothèque
    VideoHeartbeat_TV.a
    dans le dossier
    lib
    de votre projet.
  2. Dans l’onglet
    Créer des phases
    de la cible de votre application tvOS, développez la section
    Lier le fichier binaire avec les bibliothèques
    et ajoutez les bibliothèques suivantes :
    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework