Afspelen van inhoud bijhouden
Bij het bijhouden van de kern worden het laden, starten, pauzeren, hervatten, voltooien en beëindigen van de sessie bestreken. Hoewel dit niet verplicht is, vormen buffering en zoeken van tracering ook de kerncomponenten van een volledige implementatie van het afspelen.
Gebeurtenissen van Player
Implementatiestappen
- identificeer wanneer de gebruiker playback teweegbrengt (de gebruiker klikt spel of autoplay branden). Maak een mediaobject met de naam, de id, de lengte, het type stream en het mediatype van de inhoud. Zie {de naam van de Inhoud 1}, identiteitskaart van de Inhoud , lengte van de Inhoud , het type van de Stroom , en inhoudstype voor gebiedsdefinities.🔗
- verbindt naar keuze meta-gegevens — standaardmeta-gegevens (toon, seizoen, episode, enz.) en aangepaste contextgegevensvariabelen. Zie tonen , Seizoen , Aflevering , Genre , en Netwerk voor standaardmeta-gegevens belangrijkste verwijzingen.
- Begin van de Zitting 1} van de Vraag beginnen het volgen van de zitting. Hiermee worden de gegevens en metagegevens geladen en wordt de tijd-aan-start QoS-meting gestart. SessionStart volgt de intent om te spelen, niet het eerste kader.
- Vraag Spel wanneer het eerste kader van inhoud op het scherm teruggeeft.
- Begin van de Vraag van 0} wanneer de speler pauzeert. Roep opnieuw Spel wanneer de playback hervat. Er is geen afzonderlijke resume-gebeurtenis.
- Volledige Zitting van de vraag van 0} wanneer de kijker het eind van inhoud bereikt.
- Eind van de Vraag Zitting wanneer de speler wordt leeggemaakt of de kijker inhoud verlaat zonder het eind te bereiken. SessionEnd sluit onmiddellijk de zitting; er kunnen daarna geen andere gebeurtenissen worden bijgehouden .
SessionEnd markeert het einde van een volgende sessie. Roep SessionComplete vóór SessionEnd aan als de sessie naar voltooiing is gecontroleerd. Elke andere volgende aanroep wordt na SessionEnd genegeerd, behalve voor SessionStart voor een nieuwe sessie.Kernweergave
In de volgende voorbeelden wordt een volledige sessiestroom getoond — van het begin van de sessie tot het einde van de inhoud en het einde van de sessie.
Voor implementatiedetails door platform, zie 🔗 het begin van de Zitting, Spel , Begin van de Pauze , Volledige Zitting , en Eind van de Zitting .
Bufferen
Het starten van de buffer geeft aan dat de speler op gegevens wacht. Het buffereinde wordt afgeleid wanneer u een Play-gebeurtenis verzendt na BufferStart (op XDM gebaseerde API’s). Bij Mobile SDK roept u BufferComplete ook expliciet aan.
Voor implementatiedetails, zie Begin van de Buffer .
Zoeken
De beginsignalen van de zoekactie geven aan dat de viewer scrubt. Einde van zoekactie wordt gevolgd door Afspelen om het afspelen van inhoud te hervatten.
Voor implementatiedetails, zie Begin van de Pauze (zoek begin) en Spel (zoek eind).
Afhandeling van app-onderbrekingen
Het afspelen in een mediatoepassing kan op verschillende manieren worden onderbroken: de gebruiker drukt op pauzeren, de app gaat naar de achtergrond, er komt een telefoongesprek. Ongeacht de oorzaak zijn de volgende instructies hetzelfde:
- Vraag PauseStart wanneer de toepassing wordt onderbroken (gaat naar achtergrond, media pauzeren, enz.).
- Vraag Spel wanneer de toepassing aan de voorgrond terugkeert en/of de media hervat het spelen.
wanneer zou een gepauzeerde zitting beëindigen? Als de toepassing het afspelen op de achtergrond niet toestaat, roept u PauseStart onmiddellijk aan en vervolgens SessionEnd na ongeveer één minuut op de achtergrond. De toepassing kan niet doorgaan met het verzenden van pauzepunten vanaf de achtergrond. Als u de sessie voor onbepaalde tijd open houdt, krijgt u een slechte ervaring. Als de toepassing ondersteuning biedt voor achtergrondafspelen (audio-apps, video-podcast-apps), blijft u pings verzenden terwijl u zich op de achtergrond bevindt.
die na een lange achtergrondperiode opnieuw beginnen: als de app lang genoeg achtergrond was dat de zitting verliep (inactiviteit van 30 minuten), vraag SessionEnd om het even welke het lopen zitting schoon te sluiten, dan vraag SessionStart om met nieuwe te beginnen wanneer de kijker terugkeert.
Niet-actieve sessies hervatten
Een sessie verloopt automatisch als er gedurende 10 minuten geen gebeurtenissen zijn ontvangen of als er gedurende 30 minuten geen beweging van de afspeelkop is. Als de gebruiker na een zitting terugkeert is verlopen, vraag SessionStart opnieuw om een nieuwe zitting te openen.
die over apparaten hervat (cross-device handoff): wanneer een kijker playback tussen apparaten overbrengt (bijvoorbeeld, die van een telefoon aan TV gieten), gebruik de hervattingsvlag om de zittingen samen in Analytics te stikken die melden:
- Op het bronapparaat, vraag SessionEnd wanneer de kijker de gietvorm in werking stelt. Roep SessionComplete niet aan — de inhoud is niet voltooid.
- Op het bestemmingsapparaat, vraag SessionStart met de hervattingsvlag die aan
truewordt geplaatst en ga de zelfde inhoudsmeta-gegevens en de playhead positie van het bronapparaat over.
Het plaatsen van de hervattingsvlag veroorzaakt Analytics om Inhoud te verhogen hervat eerder dan het begin van Media voor het tweede been van het handoff.
manueel herstellend een eerder gesloten zitting: als de toepassing gebruikersgegevens opslaat en een eerder gesloten zitting kan hervatten, plaats de hervattingsvlag bij zittingsbegin. Zie Begin van de Zitting voor implementatiedetails over alle platforms.