createMediaSession

Die createMediaSession -Befehl ist Teil des Web SDK streamingMedia -Komponente. Sie können diese Komponente verwenden, um Daten zu Mediensitzungen auf Ihrer Website zu erfassen. Siehe streamingMedia Dokumentation , um zu erfahren, wie Sie diese Komponente konfigurieren.

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 senden Adobe Analytics für Streaming-Medien, 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 createMediaSession -Methode mit den unten beschriebenen Optionen verwenden:

    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 playerId bereitgestellt.
xdm.eventType
Objekt
Nein
Der Medien-Ereignistyp. Wenn dies nicht angegeben wird, wird dies automatisch auf media.sessionStart.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Das Sitzungsdetailobjekt. Die sessionDetails -Objekt sollte die Eigenschaften der Sitzungsdetails enthalten. Siehe Mediensammlungsschema Dokumentation finden Sie weitere Informationen.

Erstellen einer manuell verfolgten Mediensitzung manual

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

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 automatisch auf media.sessionStart.
xdm.mediaCollection.sessionDetails
Objekt
Ja
Das Sitzungsdetailobjekt. Die sessionDetails -Objekt sollte die Eigenschaften der Sitzungsdetails enthalten. Siehe Mediensammlungsschema Dokumentation finden Sie weitere Informationen.
xdm.mediaCollection.playhead
Ganzzahl
Ja
Die aktuelle Abspielleiste.
xdm.mediaCollection.qoeDataDetails
Objekt
Nein
Die Qualität der Erlebnisdatendetails. Siehe Mediensammlungsschema Dokumentation finden Sie weitere Informationen.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636