Show Menu
TOPICS×

iOS einrichten

Voraussetzungen

  • Gültige Konfigurationsparameter für Media SDK festlegen:
    Diese Parameter erhalten Sie nach der Einrichtung Ihres Analytics-Kontos von einem Adobe-Support-Mitarbeiter.
  • ADBMobile für iOS in Ihre Anwendung implementieren:
    Weitere Informationen zur Adobe Mobile-SDK-Dokumentation finden Sie unter iOS-SDK 4.x für Experience Cloud-Lösungen.
    Mit iOS 9 hat Apple eine Funktion namens App Transport Security (ATS) eingeführt. Diese Funktion soll die Netzwerksicherheit steigern, indem sie gewährleistet, dass Ihre Anwendungen nur branchenübliche Protokolle und Chiffren verwenden. Die Funktion ist standardmäßig aktiviert, Ihnen stehen jedoch einige Konfigurationsoptionen für die Arbeit mit ATS zur Verfügung. Weitere Informationen zu ATS finden Sie unter App Transport Security.
  • Stellen Sie in Ihrem Medienplayer folgende Funktionen bereit:
    • Eine API, um Player-Ereignisse zu abonnieren:
      Die Medien-SDK erfordert, dass Sie einige einfache APIs aufrufen, wenn Ereignisse in Ihrem Player auftreten.
    • Eine API, die Playerinformationen bereitstellt:
      Diese Informationen enthalten Details wie z. B. Medienname und Abspielposition.

SDK-Implementierung

  1. Fügen Sie Ihr heruntergeladenes Medien-SDK zu Ihrem Projekt hinzu.
    1. Stellen Sie sicher, dass die folgenden Softwarekomponenten im Verzeichnis
      libs
      vorhanden sind:
      • ADBMediaHeartbeat.h
        : Die Objective-C-Header-Datei, die für iOS Heartbeat-Tracking-APIs verwendet wird.
      • ADBMediaHeartbeatConfig.h
        : Die Objective-C-Header-Datei für die SDK-Konfiguration.
      • MediaSDK.a
        : Eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für iOS-Geräte (armv7, armv7s, arm64) und Simulatoren (i386 und x86_64) enthält.
        Diese Binärdatei sollte verknüpft werden, wenn das Ziel für eine iOS-App vorgesehen ist.
      • MediaSDK_TV.a
        : Eine Bitcode-fähige Fat Binary, die die Bibliotheks-Builds für neue Apple TV-Geräte (arm64) und Simulatoren (x86_64) enthält.
        Diese Binärdatei sollte verknüpft werden, wenn das Ziel eine Apple TV-(tvOS-)App ist.
    2. Bibliothek zu Ihrem Projekt hinzufügen:
      1. Starten Sie die XCode IDE und öffnen Sie die App.
      2. Ziehen Sie im
        Project Navigator
        (Projektnavigator) das Verzeichnis
        libs
        per Drag-and-drop in das Projekt.
      3. Stellen Sie sicher, dass das Kontrollkästchen
        Copy Items if Needed
        (Elemente bei Bedarf kopieren) aktiviert ist, die Option
        Create Groups
        (Gruppen erstellen) ausgewählt wurde und keines der Kontrollkästchen in
        Add to Target
        (Zu Ziel hinzufügen) aktiviert ist.
      4. Klicken Sie auf
        Fertigstellen
        .
      5. Wählen Sie im
        Project Navigator
        Ihre App und Ziele aus.
      6. Verknüpfen Sie im Bereich
        Verknüpfte Frameworks
        und
        Bibliotheken
        im Tab
        Allgemein
        die erforderlichen Frameworks und Bibliotheken.
        iOS-App-Ziele:
        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd
          Apple TV (tvOS)-Targets:
        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      7. Überprüfen Sie, ob die App fehlerfrei erstellt wird.
  2. Importieren Sie die Bibliothek.
    #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
  3. Erstellen Sie eine
    ADBMediaHeartbeatConfig
    -Instanz.
    In diesem Abschnitt erhalten Sie Informationen zu den
    MediaHeartbeat
    -Konfigurationsparametern und zum Festlegen der richtigen Konfigurationswerte für die
    MediaHeartbeat
    -Instanz, um Ereignisse genau zu verfolgen.
    Hier finden Sie eine Beispielinitialisierung für
    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. Implementieren Sie das
    ADBMediaHeartbeatDelegate
    -Protokoll.
    @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. Verwenden Sie
    ADBMediaHeartBeatConfig
    und
    ADBMediaHeartBeatDelegate
    , um die
    ADBMediaHeartbeat
    -Instanz zu erstellen.
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
    Stellen Sie sicher, dass die
    ADBMediaHeartbeat
    -Instanz zugänglich ist und ihre Zuweisung
    nicht vor Ende der Sitzung aufgehoben wird
    . Diese Instanz wird für alle der folgenden-Tracking-Ereignisse verwendet.

Migration von Version 1.x auf 2.x in iOS

In Version 2.x sind alle öffentlichen Methoden in der Klasse
ADBMediaHeartbeat
konsolidiert, um die Arbeit der Entwickler zu erleichtern. Alle Konfigurationen wurden in der Klasse
ADBMediaHeartbeatConfig
zusammengefasst.
Weitere Informationen zur Migration von 1.x zu 2.x finden Sie unter Migration von VHL 1.x zu 2.x.

Native App für tvOS konfigurieren

Mit der neuen Apple TV-Version können Sie Anwendungen erstellen, die in der nativen tvOS-Umgebung ausgeführt werden. Sie können entweder eine rein native App mit verschiedenen in iOS verfügbaren Frameworks erstellen oder eine App über XML-Vorlagen und JavaScript erstellen. Ab MediaSDK-Version 2.0 wird tvOS unterstützt. Weitere Informationen zu tvOS finden Sie auf der tvOS-Entwickler-Site.
Führen Sie die folgenden Schritte in Ihrem Xcode-Projekt aus. In dieser Anleitung wird davon ausgegangen, dass das Projekt eine Apple TV-App zum Ziel hat, die auf tvOS ausgerichtet ist:
  1. Ziehen Sie die Bibliotheksdatei
    VideoHeartbeat_TV.a
    in den
    lib
    -Ordner Ihres Projekts.
  2. Erweitern Sie im Tab
    Build-Phasen
    des Ziels Ihrer tvOS-App den Bereich
    Binär mit Bibliotheken verknüpfen
    und fügen Sie die folgenden Bibliotheken hinzu:
    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework