Core playback van het spoor op Chromecast track-core-playback-on-chromecast
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.MediaObjectAPI-referentie:code language-none mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);StreamTypeconstanten:MediaTypeconstanten: -
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
Standaardmetadata implementeren in Chromecast
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-js /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };
-
-
Spoor de intentie om playback te beginnen
Beginnen het volgen van een media zitting, vraag trackSessionStart op het
mediavoorwerp.code language-none ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);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 De tweede waarde is de aangepaste objectnaam voor videometagegevens die u in stap 2 hebt gemaakt. 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 vraag trackPlay:
code language-none ADBMobile.media.trackPlay(); -
de waarde van de Update playhead
Wijzig de positiewaarde van
mediaUpdatePlayheadmeerdere keren wanneer de afspeelkop verandert.
Voor video-op-verzoek (VOD) wordt de waarde opgegeven in seconden vanaf het begin van het media-item.
Als de speler voor live streaming geen informatie geeft over de duur van de inhoud, kan de waarde worden opgegeven als het aantal seconden sinds middernacht UTC van die dag.code language-none ADBMobile().media.updatePlayhead(position)note note NOTE Houd rekening met het volgende wanneer u de API media.updatePlayheadaanroept:- Wanneer u voortgangsmarkeringen gebruikt, is de duur van de inhoud vereist en moet de afspeelkop worden bijgewerkt als het aantal seconden vanaf het begin van het media-item, te beginnen met 0.
- Wanneer u media-SDK's gebruikt, moet u de
media.updatePlayheadAPI minstens één keer per seconde aanroepen.
-
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 vraag trackComplete:
code language-none ADBMobile.media.trackComplete(); -
Spoor het eind van de zitting
Identificeer de gebeurtenis van de videospeler voor het ontladen/sluiten van de videoplayback, waar de gebruiker de video sluit en/of de video wordt voltooid en is gedownload, en vraag trackSessionEnd:
code language-none ADBMobile.media.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 ADBMobile.media.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 videohervat van pauze en vraag trackPlay:
code language-none ADBMobile.media.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.
- Het volgen scenario's: de playback van VOD zonder advertenties
- Voorbeeldspeler die bij de Chromecast SDK wordt geleverd voor een volledig voorbeeld van 'tracking'.