Konfigurera iOS set-up-ios

Lär dig hur du konfigurerar tillägget Streaming Media Collection för iOS-enheter.

IMPORTANT
När stödet för version 4 Mobile SDK upphör den 31 augusti 2021 upphör även stödet för Media Analytics SDK för iOS och Android. Mer information finns i Vanliga frågor om supporten för Media Analytics SDK.

Förutsättningar

  • Hämta giltiga konfigurationsparametrar för Media SDK
    Dessa parametrar kan hämtas från en Adobe-representant när du har konfigurerat ditt analyskonto.

  • Implementera ADBMobil för iOS i ditt program
    Mer information om Adobe Mobile SDK-dokumentationen finns i iOS SDK 4.x for Experience Cloud Solutions.

    note important
    IMPORTANT
    Från och med iOS 9 introducerade Apple en funktion som kallas ATS (App Transport Security). Den här funktionen syftar till att förbättra nätverkssäkerheten genom att säkerställa att dina appar endast använder protokoll och ciphers som följer branschstandard. Den här funktionen är aktiverad som standard, men du har konfigurationsalternativ som ger dig möjlighet att arbeta med ATS. Mer information om ATS finns i App Transport Security.
  • Tillhandahåll följande funktioner i din mediespelare:

    • Ett API för att prenumerera på spelarhändelser - Media SDK kräver att du anropar en uppsättning enkla API:er när händelser inträffar i spelaren.
    • Ett API som tillhandahåller spelarinformation - Den här informationen innehåller information som medienamnet och spelhuvudets position.

SDK-implementering

IMPORTANT
Från och med version 2.3.0 distribueras SDK via XCFrameworks.
Version 2.3.0 av SDK kräver Xcode 12.0 eller senare och, om tillämpligt, Cocoapods 1.10.0 eller senare.
  • När en binär biblioteksfil nämns bör XCFramwork-ersättaren användas i stället:

    • MediaSDK.a > MediaSDK.xcframework
    • MediaSDK_TV.a > MediaSDKTV.xcframework
  • Om du lägger till Adobe XCFrameworks manuellt i ditt projekt måste du se till att de inte är inbäddade.

  1. Lägg till din hämtade Media SDK i ditt projekt.

    1. Kontrollera att följande programvarukomponenter finns i katalogen libs:

      • ADBMediaHeartbeat.h: Mål-C-huvudfilen som används för iOS API:er för pulsslagsspårning.

      • ADBMediaHeartbeatConfig.h: Mål-C-huvudfilen för SDK-konfigurationen.

      • MediaSDK.a: En bitkodsaktiverad binär fetthalt som innehåller biblioteksbyggen för iOS-enheter (armv7, armv7s, arm64) och simulatorer (i386 och x86_64).

        Den här binärfilen bör länkas när målet är avsett för en iOS-app.

      • MediaSDK_TV.a: En streckkodsaktiverad binärfil som innehåller biblioteket för nya Apple TV-enheter (arm64) och simulator (x86_64).

        Den här binärfilen bör länkas när målet är avsett för en Apple TV-app (tvOS).

    2. Lägg till biblioteket i ditt projekt:

      1. Starta Xcode IDE och öppna appen.

      2. I Project Navigator drar du katalogen libs och släpper den under projektet.

      3. Kontrollera att kryssrutan Copy Items if Needed är markerad, att Create Groups är markerad och att ingen av kryssrutorna i Add to Target är markerad.

      Välj alternativ

      1. Klicka på Finish.

      2. I Project Navigator väljer du din app och dina mål.

      3. Länka de nödvändiga strukturerna och biblioteken i avsnittet Linked Frameworks och Libraries på fliken General.

        iOS-appmål:

        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd

        Apple TV-mål (tvOS):

        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      4. Verifiera att appen byggs utan fel.

  2. Importera biblioteket.

    code language-none
    #import "ADBMediaHeartbeat.h"
    #import "ADBMediaHeartbeatConfig.h"
    
  3. Skapa en ADBMediaHeartbeatConfig-instans.

    I det här avsnittet får du hjälp med att förstå konfigurationsparametrarna MediaHeartbeat och att ange korrekta konfigurationsvärden för instansen MediaHeartbeat för korrekt spårning.

    Här följer ett exempel på ADBMediaHeartbeatConfig-initiering:

    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>;
    
  4. Implementera protokollet 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
    
  5. Använd ADBMediaHeartBeatConfig och ADBMediaHeartBeatDelegate för att skapa ADBMediaHeartbeat-instansen.

    code language-none
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance
    _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
      <ADBMediaHeartBeatDelegate> config:config];
    
    note important
    IMPORTANT
    Kontrollera att din ADBMediaHeartbeat-instans är tillgänglig och att inte frigörs förrän i slutet av sessionen. Den här instansen kommer att användas för alla följande spårningshändelser.

Migrera från version 1.x till 2.x i iOS migrate-to-two-x

I version 2.x konsolideras alla publika metoder i klassen ADBMediaHeartbeat så att det blir enklare för utvecklare. Alla konfigurationer har konsoliderats till klassen ADBMediaHeartbeatConfig.

Mer information om hur du migrerar från 1.x till 2.x finns i dokumentationen för den äldre implementeringen.)

Konfigurera en intern app för tvOS

I och med den nya Apple TV-funktionen kan du nu skapa program som kan köras i den inbyggda tvOS-miljön. Du kan antingen skapa ett helt inbyggt program med hjälp av ett eller flera ramverk i iOS, eller så kan du skapa programmet med hjälp av XML-mallar och JavaScript. Från och med MediaSDK version 2.0 finns stöd för tvOS. Mer information om tvOS finns på webbplatsen tvOS Developer.

Utför följande steg i Xcode-projektet. Den här guiden är skriven under förutsättning att ditt projekt har ett mål som är en Apple TV-app som riktar sig till tvOS:

  1. Dra biblioteksfilen VideoHeartbeat_TV.a till projektets lib-mapp.

  2. Utöka avsnittet Link Binary with Libraries på fliken Build Phases i målet för din tvOS-app och lägg till följande bibliotek:

    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb