createMediaSession

El createMediaSession forma parte del SDK web streamingMedia componente. Puede utilizar este componente para recopilar datos relacionados con las sesiones de contenido en el sitio web. Consulte la streamingMedia documentación para obtener información sobre cómo configurar este componente.

Los datos recopilados pueden incluir información sobre reproducciones de contenido, pausas, finalizaciones y otros eventos relacionados. Una vez recopilados, puede enviar estos datos a Adobe Analytics para mídia de streaming, para agregar métricas. Esta función proporciona una solución completa para realizar el seguimiento y comprender el comportamiento del consumo de medios en el sitio web.

Puede crear sesiones de contenido en el SDK web de dos formas:

Crear una sesión multimedia rastreada automáticamente automatic

Para iniciar el seguimiento de una sesión multimedia automáticamente, llame al método createMediaSession con las opciones descritas a continuación:

    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: {
                    ...
                }
            }
        }
    });
Propiedad
Tipo
Requerido
Descripción
playerId
Cadena
El ID del reproductor, un identificador único que representa la sesión de contenido.
getPlayerDetails
Función
Una función que devuelve los detalles del reproductor. El SDK web llamará a esta función de llamada de retorno antes de cada evento multimedia para playerId siempre.
xdm.eventType
Objeto
No
El tipo de evento de medios. Si no se proporciona, se establece automáticamente como media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
El objeto de detalles de sesión. El sessionDetails debe contener las propiedades de detalles de la sesión. Consulte la Esquema de recopilación de medios para obtener más información.

Creación de una sesión multimedia rastreada manualmente manual

Para iniciar el seguimiento de una sesión de contenido manualmente, llame al método createMediaSession con las opciones descritas a continuación:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Propiedad
Tipo
Obligatorio
Descripción
xdm.eventType
Objeto
No
El tipo de evento de medios. Si no se proporciona, se establece automáticamente como media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
El objeto de detalles de sesión. El sessionDetails debe contener las propiedades de detalles de la sesión. Consulte la Esquema de recopilación de medios para obtener más información.
xdm.mediaCollection.playhead
Entero
El cabezal de reproducción actual.
xdm.mediaCollection.qoeDataDetails
Objeto
No
La calidad de los detalles de los datos de experiencia. Consulte la Esquema de recopilación de medios para obtener más información.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636