Configurazione iOS set-up-ios
Scopri come configurare Streaming Media Analytics per dispositivi iOS.
Prerequisiti
-
Ottenere parametri di configurazione validi per Media SDK
Questi parametri possono essere ottenuti da un rappresentante di Adobe dopo la configurazione dell’account di analisi. -
Implementare ADBMobile per iOS nella tua applicazione
Per ulteriori informazioni sulla documentazione dell’SDK di Adobe Mobile, consulta SDK 4.x per iOS per le soluzioni Experience Cloud.note important IMPORTANT A partire da iOS 9, Apple ha introdotto una funzione denominata App Transport Security (ATS). Questa funzione mira a migliorare la sicurezza della rete assicurando che le app utilizzino solo protocolli e cifrature standard del settore. Questa funzione è abilitata per impostazione predefinita, ma disponi di opzioni di configurazione per scegliere come lavorare con ATS. Per maggiori dettagli su ATS, consulta App Transport Security. -
Fornisci le seguenti funzionalità nel lettore multimediale:
- API per abbonarsi agli eventi del lettore: Media SDK richiede di chiamare un set di API semplici quando si verificano eventi nel lettore.
- API che fornisce informazioni sul lettore: queste informazioni includono dettagli quali il nome dell’elemento multimediale 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.
-
Aggiungi il Media SDK scaricato al progetto.
-
Verifica che siano presenti i seguenti componenti software nella directory
libs
:-
ADBMediaHeartbeat.h
: file di intestazione Objective-C usato per le API di tracciamento heartbeat in iOS. -
ADBMediaHeartbeatConfig.h
: 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 è 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 (arm64) e simulatori (x86_64) Apple TV.Se la destinazione è un’app per Apple TV (tvOS), il binary deve essere collegato.
-
-
Aggiungi la libreria al progetto:
-
Avvia l’IDE di Xcode e apri la tua app.
-
In Project Navigator, trascina la directory
libs
e rilasciala sotto al progetto. -
Assicurati che la casella di controllo Copy Items if Needed sia selezionata, Create Groups sia selezionato e nessuna delle caselle di controllo in Add to Target sia selezionata.
-
Fai clic su Finish.
-
In Project Navigator, seleziona l’app e le destinazioni.
-
Collega i framework e le librerie richiesti nelle sezioni Linked Frameworks e Libraries nella 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
-
Verifica che l’app possa essere generata senza errori.
-
-
-
Importa la libreria.
code language-none #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
-
Crea un’istanza di
ADBMediaHeartbeatConfig
.Questa sezione descrive i parametri di configurazione di
MediaHeartbeat
e spiega come impostare i valori di configurazione corretti sull’istanza diMediaHeartbeat
per un tracciamento accurato.Esempio di inizializzazione di
ADBMediaHeartbeatConfig
:code language-none // 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>;
-
Implementa il protocollo
ADBMediaHeartbeatDelegate
.code language-none @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
-
Utilizza
ADBMediaHeartBeatConfig
eADBMediaHeartBeatDelegate
per creare l’istanza diADBMediaHeartbeat
.code language-none //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
note important IMPORTANT Assicurati che l’istanza di ADBMediaHeartbeat
sia accessibile e che non venga deallocata fino alla fine della sessione. Questa istanza verrà utilizzata per tutti gli eventi di tracciamento seguenti.
Migrazione dalla versione 1.x alla versione 2.x in iOS migrate-to-two-x
Nella versione 2.x, tutti i metodi pubblici sono consolidati nella classe ADBMediaHeartbeat
per semplificare il lavoro degli sviluppatori. Tutte le configurazioni sono state consolidate nella classe ADBMediaHeartbeatConfig
.
Per informazioni sulla migrazione dalla versione 1.x alla versione 2.x, consulta la documentazione sull’implementazione legacy.
Configurare un’app nativa per tvOS
Con il rilascio della nuova Apple TV, potrai creare applicazioni da eseguire nell’ambiente nativo tvOS. Puoi creare un’app esclusivamente nativa utilizzando uno dei numerosi framework disponibili in iOS, oppure puoi creare l’app utilizzando modelli XML e JavaScript. Il supporto per tvOS è disponibile a partire da MediaSDK versione 2.0. Per ulteriori informazioni su tvOS, consulta il sito per sviluppatori tvOS.
Completa i seguenti passaggi nel progetto Xcode. Questa guida è stata scritta per un progetto il cui target è un’app Apple TV destinata a tvOS:
-
Trascina il file di libreria
VideoHeartbeat_TV.a
nella cartellalib
del progetto. -
Nella scheda Build Phases di 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