DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Nachverfolgen der Erlebnisqualität auf Roku track-quality-of-experience-on-roku

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

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit den folgenden Anweisungen können Sie die Implementierung der 2.x-SDKs vornehmen.

IMPORTANT
Wenn Sie Version 1.x des SDK implementieren möchten, können Sie hier die 1.x-Entwicklerhandbücher herunterladen: SDKs herunterladen.

Implementieren von QoS

  1. Ermitteln Sie, wann sich die Bitrate während der Medienwiedergabe ändert, und verwenden Sie die mediaUpdateQoS-API, um die QoS-Informationen im Media SDK zu aktualisieren.

    QoSObject-Variablen:

    note tip
    TIP
    Diese Variablen sind nur erforderlich, wenn Sie die Erlebnisqualität (QoS) verfolgen.
    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
    Variable Beschreibung erforderlich
    bitrate Aktuelle Bitrate Ja
    startupTime Startzeit Ja
    fps FPS-Wert Ja
    droppedFrames Anzahl der Dropped Frames Ja

    Beispiel:

    code language-none 
    bitrate = 200000
fps = 0
droppedFrames = 1
startupTime = 2
qosinfo = adb_media_init_qosinfo(bitrate, startupTime, fps, droppedFrames)

ADBMobile().mediaUpdateQoS(qosinfo)

  2. Wenn sich die Bitrate der Wiedergabe ändert, rufen Sie trackEvent(BitrateChange) auf, um dem Media SDK mitzuteilen, dass die Bitrate geändert wurde.

    code language-none 
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
    note note
    NOTE
    Sie müssen updateQoSObject mit dem aktualisierten Bitratenwert aufrufen.

  3. Wenn im Medienplayer ein Fehler auftritt und das Fehlerereignis der Player-API zur Verfügung steht, verwenden Sie trackError(), um die Fehlerinformationen zu erfassen. (Siehe Übersicht.)

    note tip
    TIP
    Das Tracking von Fehlern im Medienplayer stoppt die Medien-Tracking-Sitzung nicht. Wenn der Medienplayer-Fehler verhindert, dass die Wiedergabe fortgesetzt wird, müssen Sie sicherstellen, dass die Medien-Tracking-Sitzung geschlossen wird. Rufen Sie dazu trackSessionEnd() nach trackError() auf.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb