DokumentationAnalyticsGuide för strömningstjänster för media

Översikt overview

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare
  • Administratör
  • Utvecklare

Följande anvisningar ger vägledning för implementering i alla 2.x SDK:er.

IMPORTANT
Om du implementerar en 1.x-version av SDK kan du hämta 1.x-utvecklarhandboken här: Hämta SDK.

Kvalitetsspårning innefattar QoS (Quality of Service) och felspårning, båda är valfria element och krävs inte för viktiga implementeringar av mediespårning. Du kan använda mediespelarens API för att identifiera variabler som är relaterade till QoS och felspårning. Här är de viktigaste elementen för att hålla koll på upplevelsekvaliteten:

Spelarhändelser player-events

Om QoS-mätvärden ändras:

Skapa eller uppdatera QoS-objektinstansen för uppspelningen. QoS API-referens

Alla bithastighetsändringshändelser

Ring trackEvent(Media.Heartbeat.Event.BitrateChange);

Implementera QOS

  1. Identifiera när något av QOS-måtten ändras under medieuppspelning, skapa MediaObject med QoS-informationen och uppdatera den nya QoS-informationen.

    QoSObject-variabler:

    note tip
    TIP
    Dessa variabler är bara obligatoriska om du tänker spåra QoS.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Variabel Beskrivning Obligatoriskt
    bitrate Aktuell bithastighet Ja
    startupTime Starttid Ja
    fps FPS-värde Ja
    droppedFrames Antal uteslutna bildrutor Ja

  2. Kontrollera att metoden getQoSObject() returnerar den senaste QoS-informationen.

  3. När uppspelningen växlar bithastigheter anropar du händelsen BitrateChange i instansen Mediepulsslag.

    note important
    IMPORTANT
    Uppdatera QoS-objektet och anropa bithastighetsändringshändelsen för varje bithastighetsändring. Detta ger de mest exakta QoS-data.

I följande exempelkod används JavaScript 2.x SDK för en HTML5-mediespelare. Du bör använda den här koden med den viktigaste mediespelningskoden.

var mediaDelegate = new MediaHeartbeatDelegate();
...

// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
    return this.qosInfo;
};

if (e.type == "qos_update") {
    var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
    mediaDelegate.qosInfo = qosInfo;
};

if (e.type == "bitrate_change") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb