Configurazione iOS set-up-ios

Aggiungi il Media SDK scaricato al progetto.

1. 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.

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 al progetto.

   3. 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.

   

   1. Fai clic su Finish.

   2. In Project Navigator, seleziona l’app e le destinazioni.

   3. 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

   4. Verifica che l’app possa essere generata senza errori.

Importa la libreria.

#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 di MediaHeartbeat per un tracciamento accurato.

Esempio di inizializzazione di 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

Utilizza ADBMediaHeartBeatConfig e ADBMediaHeartBeatDelegate per creare l’istanza di ADBMediaHeartbeat.

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

Trascina il file di libreria VideoHeartbeat_TV.a nella cartella lib 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