IOS instellen set-up-ios
Leer hoe u de invoegtoepassing voor het streamen van media voor iOS-apparaten instelt.
Vereisten
-
Geldige configuratieparameters verkrijgen voor de Media SDK
Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw analyseaccount hebt ingesteld. -
ADBMobile for iOS in uw toepassing implementeren
Voor meer informatie over de documentatie van de Adobe Mobiele SDK, zie iOS SDK 4.x voor Experience Cloud Solutions.note important IMPORTANT Vanaf iOS 9 introduceerde Apple de functie App Transport Security (ATS). Deze functie is bedoeld om de netwerkbeveiliging te verbeteren door ervoor te zorgen dat uw apps alleen industriestandaard protocollen en ciphers gebruiken. Deze functie is standaard ingeschakeld, maar u hebt configuratieopties die u opties bieden voor het werken met ATS. Zie voor meer informatie over ATS Toepassingstransportbeveiliging. -
Biedt de volgende mogelijkheden in uw mediaspeler:
- Een API die zich moet abonneren op spelergebeurtenissen - De SDK van Media vereist dat u een set eenvoudige API's oproept wanneer gebeurtenissen in de speler plaatsvinden.
- Een API die spelerinformatie biedt - Deze informatie bevat details zoals de medianaam en de positie van de afspeelkop.
SDK-implementatie
-
Telkens wanneer een binair bibliotheekdossier wordt vermeld, zou zijn vervanging XCFraframework in plaats daarvan moeten worden gebruikt:
- MediaSDK.a > MediaSDK.xcframework
- MediaSDK_TV.a > MediaSDKTV.xframework
-
Als manueel het toevoegen van de Adobe XCFrameworks aan uw project, zorg ervoor dat zij niet ingebed zijn.
-
Voeg uw gedownload Media SDK voor uw project.
-
Controleer of de volgende softwarecomponenten voorkomen in het dialoogvenster
libs
map:-
ADBMediaHeartbeat.h
: Het objectc-headerbestand dat wordt gebruikt voor API's voor het bijhouden van hartslagen van iOS. -
ADBMediaHeartbeatConfig.h
: Het objectc-headerbestand voor de SDK-configuratie. -
MediaSDK.a
: Een binaire bitcode met vet die de bibliotheekbuilds bevat voor iOS-apparaten (armv7, armv7s, arm64) en -simulatoren (i386 en x86_64).Dit binaire bestand moet worden gekoppeld wanneer het doel is bedoeld voor een iOS-app.
-
MediaSDK_TV.a
: Een binaire bitcode met vet die de bibliotheek bevat, maakt gebruik van nieuwe Apple TV-apparaten (arm64) en simulator (x86_64).Dit binaire bestand moet worden gekoppeld wanneer het doel is bedoeld voor een Apple TV-app (tvOS).
-
-
Voeg de bibliotheek aan uw project toe:
-
Start de Xcode-IDE en open uw app.
-
In Project Navigator, sleept u de
libs
en zet deze onder uw project neer. -
Zorg ervoor dat de Copy Items if Needed Selectievakje is geselecteerd. Create Groups is geselecteerd en zijn er geen selectievakjes ingeschakeld Add to Target zijn geselecteerd.
-
Klik op Finish.
-
In Project Navigator selecteert u uw app en selecteert u uw doelen.
-
Koppel de vereiste frameworks en bibliotheken in de secties Linked Frameworks en Libraries op het tabblad General.
iOS App-doelen:
- AdobeMobileLibrary.a
- MediaSDK.a
- libsqlite3.0.tbd
Apple TV (tvOS)-doelen:
- AdobeMobileLibrary_TV.a
- MediaSDK_TV.a
- libsqlite3.0.tbd
- SystemConfiguration.framework
-
Controleer of uw app zonder fouten is opgebouwd.
-
-
-
Importeer de bibliotheek.
code language-none #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
-
Een
ADBMediaHeartbeatConfig
-instantie.Deze sectie helpt u begrijpen
MediaHeartbeat
config parameters, en om correcte config waarden op uw te plaatsenMediaHeartbeat
-instantie voor nauwkeurige tracering.Hier volgt een voorbeeld van initialisatie van
ADBMediaHeartbeatConfig
: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>;
-
Implementeer de
ADBMediaHeartbeatDelegate
protocol.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
-
Gebruik de
ADBMediaHeartBeatConfig
enADBMediaHeartBeatDelegate
om deADBMediaHeartbeat
-instantie.code language-none //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
note important IMPORTANT Zorg ervoor dat uw ADBMediaHeartbeat
-instantie toegankelijk is en wordt pas aan het einde van de sessie detoegewezen. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen tracking.
Migreren van versie 1.x naar 2.x in iOS migrate-to-two-x
In versie 2.x worden alle methoden van het type public geconsolideerd in de ADBMediaHeartbeat
om het voor ontwikkelaars gemakkelijker te maken. Alle configuraties zijn geconsolideerd in de ADBMediaHeartbeatConfig
klasse.
Raadpleeg de documentatie bij Oudere implementatie voor informatie over het migreren van 1.x naar 2.x.)
Een native app voor tvOS configureren
Met de release van de nieuwe Apple TV kunt u nu toepassingen maken die in de native tvOS-omgeving kunnen worden uitgevoerd. U kunt een puur eigen app maken met behulp van een van de verschillende frameworks die beschikbaar zijn in iOS, of u kunt uw app maken met XML-sjablonen en JavaScript. Vanaf MediaSDK versie 2.0 is ondersteuning voor tvOS beschikbaar. Zie voor meer informatie over tvOS tvOS Developer-site.
Voer de volgende stappen in uw project Xcode uit. In deze handleiding wordt ervan uitgegaan dat uw project een doel heeft dat een Apple TV-app voor tvOS is:
-
Sleep de
VideoHeartbeat_TV.a
bibliotheekbestand in het projectlib
map. -
In de Build Phases tabblad van het doel van uw tvOS-app Link Binary with Libraries en voegt u de volgende bibliotheken toe:
MediaSDK_TV.a
AdobeMobileLibrary_TV.a
libsqlite3.0.tbd
SystemConfiguration.framework