Muziek afspelen bijhouden op iOS track-core-playback-on-ios
Deze documentatie behandelt het volgen in versie 2.x van de SDK.
-
Aanvankelijke het volgen opstelling
Bepaal wanneer de gebruiker de afspeelintentie activeert (de gebruiker klikt op Afspelen en/of Automatisch afspelen is ingeschakeld) en maak een
MediaObject-instantie. createMediaObjectWithName API
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Naam variabele Beschrijving Vereist nameVideonaam Ja mediaidUnieke video-id Ja lengthVideolengte Ja streamTypeHet type van stroom (zie constanten StreamType hieronder) Ja mediaTypeHet type van media (zie constanten MediaType hieronder) Ja StreamTypeconstanten:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Naam van constante Beschrijving ADBMediaHeartbeatStreamTypeVODStroomtype voor Video op aanvraag ADBMediaHeartbeatStreamTypeLIVEStroomtype voor Live-inhoud ADBMediaHeartbeatStreamTypeLINEARStroomtype voor lineaire inhoud ADBMediaHeartbeatStreamTypeAODStroomtype voor audio op aanvraag ADBMediaHeartbeatStreamTypeAUDIOBOOKStreaming type voor audioboek ADBMediaHeartbeatStreamTypePODCASTStroomtype voor Podcast MediaTypeconstanten:table 0-row-2 1-row-2 2-row-2 Naam van constante Beschrijving ADBMediaTypeAudioMediatype voor audiostreams. ADBMediaTypeVideoMediatype voor videostreams. De algemene indeling voor het maken van de
MediaObject:code language-none ADBMediaObject *mediaObject = [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME> mediaId:<MEDIA_ID> length:<MEDIA_LENGTH> streamType:<STREAM_TYPE> mediaType: <MEDIA_TYPE>]; -
Band videometagegevens
U kunt standaard- en/of aangepaste metagegevensobjecten voor video's optioneel aan de volgende sessie koppelen via variabelen voor contextgegevens.
-
Standaard videometa-gegevens
-
Video meta-gegevenssleutels
-
Zie de uitvoerige lijst van videometagegevens hier: Audio en videoparameters
note note NOTE Het is optioneel om het standaardobject voor videometagegevens aan het mediaobject te koppelen. -
de meta-gegevens van de Douane
Maak een veranderlijk object voor de douanevariabelen en bevolk met de gegevens voor deze video. Bijvoorbeeld:
code language-none NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];
-
-
Spoor de intentie om playback te beginnen
Als u een mediasessie wilt bijhouden, roept u
trackSessionStartaan op de Media Heartbeat-instantie.note tip TIP De tweede waarde is de aangepaste objectnaam voor videometagegevens die u in stap 2 hebt gemaakt. code language-none - (void)onMainVideoLoaded:(NSNotification *)notification { // [_mediaHeartbeat trackSessionStart:mediaObject data:nil]; [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata]; }note important IMPORTANT In trackSessionStartwordt bijgehouden wat de gebruiker wil afspelen, niet het begin van het afspelen. Deze API wordt gebruikt om de videogegevens/meta-gegevens te laden en tijd-aan-begin metrische QoS (de tijdduur tussentrackSessionStartentrackPlay) te schatten.note note NOTE Als u geen aangepaste videometagegevens gebruikt, verzendt u gewoon een leeg object voor het argument dataintrackSessionStart, zoals getoond in de regel met opmerkingen in het bovenstaande iOS-voorbeeld. -
spoor het daadwerkelijke begin van playback
Identificeer de gebeurtenis van de videospeler voor het begin van de videoplayback, waar het eerste kader van de video op het scherm wordt teruggegeven, en roep
trackPlay:code language-none - (void)onVideoPlay:(NSNotification *)notification { [_mediaHeartbeat trackPlay]; } -
Spoor de voltooiing van playback
Identificeer de gebeurtenis van de videospeler voor de voltooiing van de videoplayback, waar de gebruiker de inhoud tot het eind heeft bekeken, en roep
trackComplete:code language-none - (void)onVideoComplete:(NSNotification *)notification { [_mediaHeartbeat trackComplete]; } -
Spoor het eind van de zitting
Identificeer de gebeurtenis van de videospeler voor het leegmaken/sluiten van de videoplayback, waar de gebruiker de video en/of de video voltooit en is verwijderd, en roep
trackSessionEnd:code language-none - void)onMainVideoUnloaded:(NSNotification *)notification { [_mediaHeartbeat trackSessionEnd]; }note important IMPORTANT trackSessionEndmarkeert het einde van een videovervolgsessie. Als de sessie succesvol is gecontroleerd op voltooiing, waarbij de gebruiker de inhoud tot het einde heeft gecontroleerd, controleert u oftrackCompletevóórtrackSessionEndis aangeroepen. Eventuele anderetrack*API-aanroepen worden natrackSessionEndgenegeerd, behalve voortrackSessionStartvoor een nieuwe sessie voor het bijhouden van video. -
spoor alle mogelijke pauzescenario's
Identificeer de gebeurtenis van de videospeler voor videopauze en vraag
trackPause:code language-none - (void)onVideoPause:(NSNotification *)notification { [_mediaHeartbeat trackPause]; }Scenario's van de Pauze
Identificeer om het even welk scenario waarin VideoPlayer zal pauzeren en zorg ervoor dat
trackPausebehoorlijk wordt geroepen. De volgende scenario's vereisen allemaal dat uw apptrackPause()aanroept:- De gebruiker raakt expliciet de pauze in de app.
- De speler plaatst zichzelf in de pauzestatus.
- (Mobiele Apps) - de gebruiker zet de toepassing in de achtergrond, maar u wilt dat app de zitting open houdt.
- (Mobiele Apps) - om het even welk type van systeem onderbreekt komt voor dat een toepassing veroorzaakt om worden gesteund. Bijvoorbeeld, ontvangt de gebruiker een vraag, of een pop-up van een andere toepassing komt voor, maar u wilt de toepassing de zitting levend houden om de gebruiker de kans te geven om de video van het punt van onderbreking te hervatten.
-
Identificeer de gebeurtenis van de speler voor videospel en/of video hervat van pauze en vraag
trackPlay:code language-none - (void)onVideoPlay:(NSNotification *)notification { [_mediaHeartbeat trackPlay]; }note tip TIP Dit kan de zelfde gebeurtenisbron zijn die in Stap 4 werd gebruikt. Zorg ervoor dat elke API-aanroep van trackPause()wordt gekoppeld aan een volgende API-aanroep vantrackPlay()wanneer het afspelen van de video wordt hervat.
Raadpleeg de volgende secties voor meer informatie over het bijhouden van het afspelen van core:
- Het volgen scenario's: de playback van VOD zonder advertenties
- Voorbeeld van een voorbeeldspeler die bij de iOS SDK wordt geleverd voor een volledig voorbeeld van 'tracking'.