Show Menu
TOPICS×

Configurare iOS

Prerequisiti

  • Ottenete parametri di configurazione validi per Media SDK
    Questi parametri possono essere ottenuti da un rappresentante Adobe dopo la configurazione dell'account di analisi.
  • Implementa ADBMobile per iOS nella tua applicazione
    Per ulteriori informazioni sulla documentazione SDK per Adobe Mobile, consulta SDK 4.x per iOS per le soluzioni Experience Cloud.
    A partire da iOS 9, Apple ha introdotto una funzione denominata App Transport Security (ATS). Questa funzione mira a migliorare la sicurezza della rete assicurandosi che le app utilizzino solo protocolli e cifratori standard di settore. Questa funzione è abilitata per impostazione predefinita, ma sono disponibili opzioni di configurazione che consentono di utilizzare ATS. Per informazioni dettagliate su ATS, consultate App Transport Security.
  • Fornite le seguenti funzionalità nel lettore multimediale:
    • Un'API per iscriversi agli eventi
      del lettore - L'SDK di Media richiede che venga chiamato un set di API semplici quando si verificano eventi nel lettore.
    • API che fornisce informazioni
      sul lettore - Queste informazioni includono dettagli quali il nome del supporto e la posizione della testina di riproduzione.

Implementazione SDK

  1. Aggiungi l’SDK per file multimediali scaricato al progetto.
    1. Verificate che nella
      libs
      directory siano presenti i seguenti componenti software:
      • ADBMediaHeartbeat.h
        : Il file di intestazione Objective-C utilizzato per le API di tracciamento heartbeat iOS.
      • ADBMediaHeartbeatConfig.h
        : Il file di intestazione Objective-C per la configurazione SDK.
      • MediaSDK.a
        : fat binary abilitato per bitcode contenente le build della libreria per dispositivi (armv7, armv7s, arm64) e simulatori (i386 e x86_64) iOS.
        Se la destinazione sarà un'app iOS, il binary deve essere collegato.
      • MediaSDK_TV.a
        : Un fat binary abilitato per bitcode contenente le build della libreria per dispositivi (arm64) e simulatori (x86_64) Apple TV.
        Il binario deve essere collegato quando la destinazione è destinata a un'app Apple TV (tvOS).
    2. Aggiungi la libreria al progetto:
      1. Avvia l'IDE di Xcode e apri la tua app.
      2. In
        Project Navigator
        , trascinate la
        libs
        directory e rilasciatela sotto il progetto.
      3. Assicurarsi che la
        Copy Items if Needed
        casella di controllo sia selezionata, che
        Create Groups
        sia selezionata e che nessuna delle caselle di controllo in
        Add to Target
        sia selezionata.
      4. Fai clic su
        Finish
        .
      5. In
        Project Navigator
        , selezionate l'app e le destinazioni.
      6. Link the required frameworks and libraries in the
        Linked Frameworks
        and
        Libraries
        section on the
        General
        tab.
        Destinazioni di app iOS:
        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd
          Destinazioni Apple TV (tvOS):
        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      7. Verificate che l'app venga generata senza errori.
  2. Importa la libreria.
    #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
  3. Create un'
    ADBMediaHeartbeatConfig
    istanza.
    Questa sezione spiega come comprendere i parametri di
    MediaHeartbeat
    configurazione e impostare i valori di configurazione corretti nell’istanza per un
    MediaHeartbeat
    monitoraggio accurato.
    Esempio
    ADBMediaHeartbeatConfig
    di inizializzazione:
    // 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. Implementa il
    ADBMediaHeartbeatDelegate
    protocollo.
    @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. Utilizzate l'icona
    ADBMediaHeartBeatConfig
    e
    ADBMediaHeartBeatDelegate
    per creare l'
    ADBMediaHeartbeat
    istanza.
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
    Accertatevi che l’
    ADBMediaHeartbeat
    istanza sia accessibile e che
    non venga deallocata fino alla fine della sessione
    . Questa istanza verrà utilizzata per tutti i seguenti eventi di tracciamento.

Migrazione dalla versione 1.x alla 2.x in iOS

Nella versione 2.x, tutti i metodi pubblici sono consolidati nella
ADBMediaHeartbeat
classe per semplificare gli sviluppatori. Tutte le configurazioni sono state consolidate nella
ADBMediaHeartbeatConfig
classe.
Per ulteriori informazioni sulla migrazione da 1.x a 2.x, consulta Migrazione VHL 1.x a 2.x.

Configurare un'app nativa per tvOS

Con il rilascio della nuova Apple TV, ora è possibile creare applicazioni da eseguire nell'ambiente tvOS nativo. Potete creare un'app puramente nativa, utilizzando diversi framework disponibili in iOS, oppure potete creare l'app utilizzando modelli XML e JavaScript. A partire da MediaSDK versione 2.0, è disponibile il supporto per tvOS. Per ulteriori informazioni su tvOS, vedi tvOS Developer site.
Effettuare le seguenti operazioni nel progetto Xcode. Questa guida viene scritta partendo dal presupposto che il progetto abbia una destinazione che sia un'app Apple TV per tvOS:
  1. Trascinate il file della
    VideoHeartbeat_TV.a
    libreria nella
    lib
    cartella del progetto.
  2. In the
    Build Phases
    tab of your tvOS app’s target, expand the
    Link Binary with Libraries
    section and add the following libraries:
    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework