createMediaSession

Der Befehl createMediaSession ist Teil der Komponente Web SDK streamingMedia . Sie können diese Komponente verwenden, um Daten zu Mediensitzungen auf Ihrer Website zu erfassen. Informationen zum Konfigurieren dieser Komponente finden Sie in der Dokumentation zu streamingMedia Dokumentation .

Die erfassten Daten können Informationen zu Medienwiedergaben, Pausen, Beendigungen und anderen damit zusammenhängenden Ereignissen enthalten. Nach der Erfassung können Sie diese Daten an Adobe Analytics für Streaming-Medien senden, um Metriken zu aggregieren. Diese Funktion bietet eine umfassende Lösung zum Verfolgen und Verstehen des Verhaltens der Mediennutzung auf Ihrer Website.

Sie können Mediensitzungen im Web SDK auf zwei Arten erstellen:

Erstellen einer automatisch verfolgten Mediensitzung automatic

Um das automatische Tracking einer Mediensitzung zu starten, rufen Sie die Methode createMediaSession mit den unten beschriebenen Optionen auf:

    alloy("createMediaSession", {
        playerId: "movie-test",
        getPlayerDetails: () => {
            return {
                playhead: document.getElementById("movie-test").currentTime,
                qoeDataDetails: {
                    bitrate: 1000,
                    startupTime: 1000,
                    fps: 30,
                    droppedFrames: 10
                }
            };
        },
        xdm: {
            eventType: "media.sessionStart",
            mediaCollection: {
                sessionDetails: {
                    ...
                }
            }
        }
    });
Eigenschaft
Typ
Erforderlich
Beschreibung
playerId
Zeichenfolge
Ja
Die Player-ID, eine eindeutige ID, die die Mediensitzung darstellt.
getPlayerDetails
Funktion
Ja
Eine Funktion, die die Player-Details zurückgibt. Diese Rückruffunktion wird vom Web SDK vor jedem Medienereignis für die bereitgestellte playerId aufgerufen.
xdm.eventType
Objekt
Nein
Der Medien-Ereignistyp. Wenn dies nicht angegeben wird, wird dies automatisch auf media.sessionStart gesetzt.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Das Sitzungsdetailobjekt. Das Objekt sessionDetails sollte die Eigenschaften der Sitzungsdetails enthalten. Weitere Informationen finden Sie in der Dokumentation zum Mediensammlungsschema .

Erstellen einer manuell verfolgten Mediensitzung manual

Um das manuelle Tracking einer Mediensitzung zu starten, rufen Sie die Methode createMediaSession mit den unten beschriebenen Optionen auf:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Eigenschaft
Typ
Erfordert
Beschreibung
xdm.eventType
Objekt
Nein
Der Medien-Ereignistyp. Wenn nicht angegeben, wird er automatisch auf media.sessionStart gesetzt.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Das Sitzungsdetailobjekt. Das Objekt sessionDetails sollte die Eigenschaften der Sitzungsdetails enthalten. Weitere Informationen finden Sie in der Dokumentation zum Mediensammlungsschema .
xdm.mediaCollection.playhead
Ganzzahl
Ja
Die aktuelle Abspielleiste.
xdm.mediaCollection.qoeDataDetails
Objekt
Nein
Die Qualität der Erlebnisdatendetails. Weitere Informationen finden Sie in der Dokumentation zum Mediensammlungsschema .
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636