IOS instellen set-up-ios
Leer de streaming-mediaservices voor iOS-apparaten in te stellen.
Vereisten
-
verkrijg geldige configuratieparameters voor de Media SDK
Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw analyseaccount hebt ingesteld. -
voert ADBMobile voor iOS in uw toepassing uit
Voor meer informatie over de documentatie van Adobe Mobile SDK, zie iOS SDK 4.x voor de Oplossingen van Experience Cloud.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. Voor details op ATS, zie de Veiligheid van het Vervoer van de Toepassing. -
verstrek de volgende mogelijkheden in uw media speler:
- API om aan spelergebeurtenissen in te tekenen - de Media SDK vereist dat u een reeks eenvoudige APIs roept wanneer de gebeurtenissen in uw speler voorkomen.
- API die spelerinformatie verstrekt - Deze informatie omvat details zoals de media naam en de positie van het spelhoofd.
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 u de Adobe XCFrameworks handmatig aan uw project toevoegt, moet u ervoor zorgen dat deze niet zijn ingesloten.
-
Voeg uw gedownloadeMedia SDK aan uw project toe.
-
Controleer of de volgende softwarecomponenten in de map
libs
staan:-
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 voor 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 binair vet met bitcode dat de bibliotheek bevat voor 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.
-
Sleep de map Project Navigator in
libs
naar de map onder het project. -
Zorg ervoor dat het selectievakje Copy Items if Needed is ingeschakeld, dat Create Groups is geselecteerd en dat geen van de selectievakjes in Add to Target is geselecteerd.
-
Klik op Finish.
-
Selecteer in Project Navigator uw app en selecteer 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"
-
Maak een
ADBMediaHeartbeatConfig
-instantie.Deze sectie helpt u om de
MediaHeartbeat
config parameters te begrijpen, en correcte config waarden op uwMediaHeartbeat
instantie voor nauwkeurige het volgen te plaatsen.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 het protocol
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
-
Gebruik
ADBMediaHeartBeatConfig
enADBMediaHeartBeatDelegate
om de instantieADBMediaHeartbeat
te maken.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 niet gedealloceerd tot het eind van de zitting. 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 klasse ADBMediaHeartbeat
, zodat ontwikkelaars deze eenvoudiger kunnen gebruiken. Alle configuraties zijn geconsolideerd in de klasse ADBMediaHeartbeatConfig
.
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. Voor meer informatie over tvOS, zie {de plaats van de Ontwikkelaar 0} tvOS.🔗
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 het bibliotheekbestand van
VideoHeartbeat_TV.a
naar de maplib
van uw project. -
Vouw op het tabblad Build Phases van het doel van uw tvOS-app de sectie Link Binary with Libraries uit en voeg de volgende bibliotheken toe:
MediaSDK_TV.a
AdobeMobileLibrary_TV.a
libsqlite3.0.tbd
SystemConfiguration.framework