Con la fine del supporto per gli SDK della versione 4 per dispositivi mobili il 31 agosto 2021, Adobe interromperà anche il supporto per l’SDK di Media Analytics per iOS e Android. Per ulteriori informazioni, consultate Domande frequenti relative alla fine del supporto per l'SDK di Media Analytics.
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.
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:
A partire dalla versione 2.3.0, l’SDK viene distribuito tramite XCFrameworks.
La versione 2.3.0 dell’SDK richiede Xcode 12.0 o versione successiva e, se applicabile, Cocoapods 1.10.0 o versione successiva.
Aggiungi l'SDK scaricato per file multimediali al tuo progetto.
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).
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 il progetto.
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.
Fai clic su Finish.
In Project Navigator, seleziona l'app e seleziona le destinazioni.
Collegare i framework e le librerie richiesti nella sezione Linked Frameworks e Libraries della scheda General.
Destinazioni di app iOS:
Destinazioni Apple TV (tvOS):
Verificate che l'app venga generata senza errori.
Importa la libreria.
#import "ADBMediaHeartbeat.h"
#import "ADBMediaHeartbeatConfig.h"
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>;
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
Utilizzare ADBMediaHeartBeatConfig
e ADBMediaHeartBeatDelegate
per creare l'istanza ADBMediaHeartbeat
.
//Replace <ADBMediaHeartBeatDelegate> with your delegate instance
_mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
<ADBMediaHeartBeatDelegate> config:config];
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.
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.
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:
Trascinate il file libreria VideoHeartbeat_TV.a
nella cartella lib
del progetto.
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