Konfigurera iOS set-up-ios
Lär dig hur du konfigurerar tillägget Streaming Media Collection för iOS-enheter.
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
-
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.
-
Lägg till din hämtade Media SDK i ditt projekt.
-
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).
-
-
Lägg till biblioteket i ditt projekt:
-
Starta Xcode IDE och öppna appen.
-
I Project Navigator drar du katalogen
libs
och släpper den under projektet. -
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.
-
Klicka på Finish.
-
I Project Navigator väljer du din app och dina mål.
-
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
-
Verifiera att appen byggs utan fel.
-
-
-
Importera biblioteket.
code language-none #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
-
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 instansenMediaHeartbeat
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>;
-
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
-
Använd
ADBMediaHeartBeatConfig
ochADBMediaHeartBeatDelegate
för att skapaADBMediaHeartbeat
-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:
-
Dra biblioteksfilen
VideoHeartbeat_TV.a
till projektetslib
-mapp. -
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