createMediaSession

El comando createMediaSession forma parte del componente streamingMedia del SDK web. 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 que se describen 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 devolución de llamada antes de cada evento multimedia para playerId proporcionado.
xdm.eventType
Objeto
No
El tipo de evento de medios. Si no se proporciona, se establece automáticamente en media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
El objeto de detalles de sesión. El objeto sessionDetails debe contener las propiedades de los detalles de la sesión. Consulte la documentación del 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 multimedia manualmente, llame al método createMediaSession con las opciones que se describen 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 en media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
El objeto de detalles de sesión. El objeto sessionDetails debe contener las propiedades de los detalles de la sesión. Consulte la documentación del 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 documentación del esquema de recopilación de medios para obtener más información.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636