createMediaSession

O comando createMediaSession faz parte do componente streamingMedia do SDK da Web. Você pode usar esse componente para coletar dados relacionados a sessões de mídia no seu site. Consulte a streamingMedia documentação para saber como configurar este componente.

Os dados coletados podem incluir informações sobre reprodução de mídia, pausas, conclusões e outros eventos relacionados. Depois de coletados, você pode enviar esses dados para o Adobe Analytics para mídia de streaming, para agregar métricas. Esse recurso fornece uma solução abrangente para rastrear e entender o comportamento de consumo de mídia no site.

Você pode criar sessões de mídia no SDK da Web de duas maneiras:

Criar uma sessão de mídia rastreada automaticamente automatic

Para começar a rastrear uma sessão de mídia automaticamente, chame o método createMediaSession com as opções descritas abaixo:

    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: {
                    ...
                }
            }
        }
    });
Propriedade
Tipo
Obrigatório
Descrição
playerId
String
Sim
A ID do reprodutor, um identificador exclusivo que representa a sessão de mídia.
getPlayerDetails
Função
Sim
Uma função que retorna os detalhes do reprodutor. Essa função de retorno de chamada será chamada pelo SDK da Web antes de cada evento de mídia para o playerId fornecido.
xdm.eventType
Objeto
Não
O tipo de evento de mídia. Se não for fornecido, será automaticamente definido como media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
Sim
O objeto de detalhes da sessão. O objeto sessionDetails deve conter as propriedades de detalhes da sessão. Consulte a documentação do esquema da Coleção de mídia para obter mais informações.

Criar uma sessão de mídia rastreada manualmente manual

Para começar a rastrear uma sessão de mídia manualmente, chame o método createMediaSession com as opções descritas abaixo:

const sessionPromise = alloy("createMediaSession", {
    xdm: {
        eventType: "media.sessionStart",
        mediaCollection: {
            playhead: 0,
            sessionDetails: {
                ...
            },
            qoeDataDetails: {
                bitrate: 1000,
                startupTime: 1000,
                fps: 30,
                droppedFrames: 10
            }
        }
    }
});
Propriedade
Tipo
Obrigatório
Descrição
xdm.eventType
Objeto
Não
O tipo de evento de mídia. Se não for fornecido, será automaticamente definido como media.sessionStart.
xdm.mediaCollection.sessionDetails
Objeto
Sim
O objeto de detalhes da sessão. O objeto sessionDetails deve conter as propriedades de detalhes da sessão. Consulte a documentação do esquema da Coleção de mídia para obter mais informações.
xdm.mediaCollection.playhead
Número inteiro
Sim
O indicador de reprodução atual.
xdm.mediaCollection.qoeDataDetails
Objeto
Não
A qualidade dos dados da experiência. Consulte a documentação do esquema da Coleção de mídia para obter mais informações.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636