Configurazione iOS

Prerequisiti

• Ottenete parametri di configurazione validi per Media
  SDKT: questi parametri possono essere ottenuti da un rappresentante di Adobe una volta configurato l’account di analisi.

• Implementa ADBMobile per iOS nell’
  applicazionePer ulteriori informazioni sulla documentazione dell’SDK per dispositivi mobili Adobe, consulta SDK 4.x per iOS per le soluzioni Experienci Cloud.

  IMPORTANTE

  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, vedere App Transport Security (Protezione trasporto app).

• 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

• Ogni volta che si fa riferimento a un file di libreria binario, si deve usare la sua forma sostitutiva XCFramework:
  • MediaSDK.a > MediaSDK.xcframework
  • MediaSDK_TV.a > MediaSDKTV.xcframework
• Se nel progetto devi aggiungere manualmente codice in formato Adobe XCFrameworks, questo non deve essere incorporato.

1. Aggiungi l'SDK scaricato per file multimediali al tuo progetto.

   1. Verificare che nella directory libs 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 dell'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 i nuovi dispositivi Apple TV (arm64) e simulatori (x86_64).

        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, trascina la directory libs e rilasciala sotto il progetto.

      3. Assicurarsi che la casella di controllo Copy Items if Needed sia selezionata, che la casella di controllo 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, seleziona l'app e seleziona le destinazioni.

      6. Collegare i framework e le librerie richiesti nella sezione Linked Frameworks e Libraries della scheda General.

         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'istanza ADBMediaHeartbeatConfig.

   Questa sezione descrive i parametri di configurazione MediaHeartbeat e consente di impostare valori di configurazione corretti sull'istanza MediaHeartbeat per un monitoraggio accurato.

   Esempio di inizializzazione ADBMediaHeartbeatConfig:

   // 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 protocollo 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. Utilizzare ADBMediaHeartBeatConfig e ADBMediaHeartBeatDelegate per creare l'istanza ADBMediaHeartbeat.

   //Replace <ADBMediaHeartBeatDelegate> with your delegate instance
   _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
     <ADBMediaHeartBeatDelegate> config:config];
   

   IMPORTANTE

   Assicurarsi che l'istanza ADBMediaHeartbeat 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 classe ADBMediaHeartbeat per semplificare gli sviluppatori. Tutte le configurazioni sono state consolidate nella classe ADBMediaHeartbeatConfig.

Per ulteriori informazioni sulla migrazione da 1.x a 2.x, vedere 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, vedere 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 libreria VideoHeartbeat_TV.a nella cartella lib del progetto.

2. Nella scheda Build Phases della destinazione dell'app tvOS, espandi la sezione Link Binary with Libraries e aggiungi le seguenti librerie:

   • MediaSDK_TV.a
   • AdobeMobileLibrary_TV.a
   • libsqlite3.0.tbd
   • SystemConfiguration.framework