createMediaSession

Il comando createMediaSession fa parte del componente Web SDK streamingMedia. Puoi utilizzare questo componente per raccogliere i dati relativi alle sessioni multimediali sul tuo sito web. Per informazioni su come configurare questo componente, consulta la streamingMedia documentazione.

I dati raccolti possono includere informazioni su riproduzioni multimediali, pause, completamenti e altri eventi correlati. Una volta raccolti, puoi inviare questi dati a 适用于流媒体的 Adobe Analytics per aggregare le metriche. Questa funzione fornisce una soluzione completa per il tracciamento e la comprensione del comportamento di consumo dei contenuti multimediali sul sito web.

Puoi creare sessioni multimediali in Web SDK in due modi:

Creare una sessione multimediale con tracciamento automatico automatic

Per avviare automaticamente il tracciamento di una sessione multimediale, chiamare il metodo createMediaSession con le opzioni descritte di seguito:

    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: {
                    ...
                }
            }
        }
    });
Proprietà
Tipo
Obbligatorio
Descrizione
playerId
Stringa
L’ID del lettore, un identificatore univoco che rappresenta la sessione multimediale.
getPlayerDetails
Funzione
Funzione che restituisce i dettagli del lettore. Questa funzione di callback verrà chiamata dall'SDK Web prima di ogni evento multimediale per playerId fornito.
xdm.eventType
Oggetto
No
Il tipo di evento multimediale. Se non specificato, viene impostato automaticamente su media.sessionStart.
xdm.mediaCollection.sessionDetails
Oggetto
L’oggetto dei dettagli della sessione. L'oggetto sessionDetails deve contenere le proprietà dei dettagli della sessione. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.

Creare una sessione multimediale tracciata manualmente manual

Per avviare manualmente il tracciamento di una sessione multimediale, chiamare il metodo createMediaSession con le opzioni descritte di seguito:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Proprietà
Tipo
Obbligatorio
Descrizione
xdm.eventType
Oggetto
No
Il tipo di evento multimediale. Se non specificato, viene automaticamente impostato su media.sessionStart.
xdm.mediaCollection.sessionDetails
Oggetto
L’oggetto dei dettagli della sessione. L'oggetto sessionDetails deve contenere le proprietà dei dettagli della sessione. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.
xdm.mediaCollection.playhead
Intero
La testina di riproduzione corrente.
xdm.mediaCollection.qoeDataDetails
Oggetto
No
La qualità dei dettagli dei dati sull’esperienza. Per ulteriori informazioni, consulta la documentazione dello schema Media Collection.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636