Pular para o conteúdo principal

Player

O Player do Elastic Encoder habilita a visualização dos conteúdos processados. O Player é um aplicativo HTML5 que pode ser incorporado em uma aplicação web ou nativa.

Interface de Programação (APIs)​

Solicitação do JWT de acesso​

Faça um comando autenticado de requisição POST em /api/auth

POST https://api.elasticencoder.videolib.live/dev/auth

Cabeçalhos para GET para /api/asset.

Header                          Valor
Ocp-Apim-Subscription-Key       chave de autorização do microserviço.
Content-Type                    application/json.

No corpo da requisição envie o JSON abaixo:

{
    "app":"aplicação", // código da aplicação (enviado para ativação)
    "key":"chave",// chave de autenticação (enviado para ativação)
    "userName":"id Usuario", // id do usuário do sistema de origem - identificação de audiência
    "name":"Nome Usuario", // nome do usuário do sistema de origem - identificação de audiência
    "group":"100", // (ocional) código do grupo do sistema de origem - identificação de audiência
    "email":"usuario@email.com.br", // (opcional) email do usuário do sistema de origem - identificação de audiência
    "documentId":"num documento - ex: cpf", // (opcional) documento do usuário do sistema de origem 
    "department":"nome departamento", // (opcional) departamento do usuário do sistema de origem 
    "timeoutMinutes":"20" // tempo de duração do token 
}

Como retorno do comando será gerado o JSON abaixo:

{
    "token":"eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImlkVXN1YXJvIiwibmFtZSI6Ik5vbWUgVXN1YXJpbyIsImRhdGFUb2tlbiI6IjIwMjQtMDEtMjdUMjI6MjI6MjcuOTI0NzU1LTAzOjAwIiwiZ3JvdXAiOiIxMDAiLCJlbWFpbCI6InV1c3VhcmlvQGVtYWlsLmNvbS5iciIsImRvY3VtZW50SWQiOiJudW0gZG9jdW1lbnRvIC0gZXg6IGNwZiIsImRlcGFydG1lbnQiOiJub21lIGRlcGFydGFtZW50byIsIm1hdGNoIjoiODAyYmVjOGZkNTMxODE5MmIwYTc1IiwiaWRVc2VyUXVldWUiOiIwRTQ5RDM2ODMxNEM0NUJBMjJBQzYxRDY3MzA0MDYwREU1RDhFODE1OENBRjlFRDM4RDIyMjY1NzMwOTBDRDA4Iiwicm9sZXMiOiJHZXN0b3IifQ.yChC56edU1zmCua7sodHGVCD-rrMp5SCeIerkeK2llI",
    "dataToken":"2024-01-27T22:22:27.924755-03:00",
    "userName":"id Usuario",
    "name":"Nome Usuario"
    ,"tokenType":"jwt",
    "idUserQueue":"0E49D368314C45BA22AC61D67304060DE5D8E8158CAF9ED38D2226573090CD08",
    "group":"100",
    "roles":"",
    "email":"usuario@email.com.br",
    "documentId":"num documento - ex: cpf",
    "department":"nome departamento",
    "status_ret":null,
    "erro":null
}

onde o campo token corresponde a chave de autenticação que será usada no campo jwt na rota de abertura do player.

Para assistir um vídeo​

Para assistir um conteúdo deve ser usada a URL abaixo, passando dois parâmteros, a chave jwt e o nome do asset original armazenado. 

Exemplo:
https://player.elasticencoder.videolib.live/player?token=mezanino-1&jwt=eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyTmFtZSI6ImlkVXN1YXJvIiwibmFtZSI6Ik5vbWUgVXN1YXJpbyIsImRhdGFUb2tlbiI6IjIwMjQtMDEtMjdUMjI6MjI6MjcuOTI0NzU1LTAzOjAwIiwiZ3JvdXAiOiIxMDAiLCJlbWFpbCI6InV1c3VhcmlvQGVtYWlsLmNvbS5iciIsImRvY3VtZW50SWQiOiJudW0gZG9jdW1lbnRvIC0gZXg6IGNwZiIsImRlcGFydG1lbnQiOiJub21lIGRlcGFydGFtZW50byIsIm1hdGNoIjoiODAyYmVjOGZkNTMxODE5MmIwYTc1IiwiaWRVc2VyUXVldWUiOiIwRTQ5RDM2ODMxNEM0NUJBMjJBQzYxRDY3MzA0MDYwREU1RDhFODE1OENBRjlFRDM4RDIyMjY1NzMwOTBDRDA4Iiwicm9sZXMiOiJHZXN0b3IifQ.yChC56edU1zmCua7sodHGVCD-rrMp5SCeIerkeK2llI

onde:

Url do player: 
https://player.elasticencoder.videolib.live/player

Parâmetros:
token: nome dado ao asset do arquivo original
jwt: chave gerada na chamada da API auth (explicada no início da sessão)

Player Videolib

Eventos do Player​

São os indicadores gerados que podem ser capturados pela página que implementa o player ou, caso esteja configurado, serão automaticamente enviados para o Application Insights.

Carregamento do Player​

Indicador: AberturaPlayer

Descrição: Este evento dispara uma vez que o vídeo seja carregado. 

{
    event: 'AberturaPlayer'
    codVideo: string,
    nomeVideo: string,
    urlVideo: string,
}

Play​

Indicador: Play

Descrição: Este evento é disparado toda vez que a reprodução do vídeo é iniciada. 

{
    event: 'Play'
    codVideo: string,
    nomeVideo: string,
    urlVideo: string,
    secundagem: number,
}

Pause​

Indicador: Pause

Descrição: Evento disparado toda vez que a reprodução do vídeo for interrompida pelo usuário. 

{
    event: 'Pause'
    codVideo: string,
    nomeVideo: string,
    urlVideo: string,
    secundagem: number,
}

Audiência​

Indicador: AssistiuVideo

Descrição: Este evento ocorre quando o usuário assiste o conteúdo do vídeo.

Este possui cinco marcos:

0 - começou a assistir;

25 - passou pelo marco de 25% do vídeo;

50 - passou pelo marco de 50% do vídeo;

75 - passou pelo marco de 75% do vídeo;

100 - finalizou o vídeo. 

{
    event: 'AssistiuVideo'
    codVideo: string,
    Progresso: number,
    secundagem: number,
    nomeVideo: string,
    urlVideo: string,
}

Finalização do Video​

Indicador: FimVideo

Descrição: Este evento ocorre quando o vídeo finaliza (chega na sua minutagem final). 

{
    event: 'FimVideo'
    codVideo: string,
    Progresso: number,
    secundagem: number,
    nomeVideo: string,
    urlVideo: string,
}

Avaliação do Video​

Indicador: AvaliouVideo

Descrição: Este evento dispara toda vez que o usuário avaliar o vídeo, podendo ser “positiva” ou “negativa” 

{
    event: 'AvaliouVideo'
    codVideo: string,
    Avaliacao: string,
    nomeVideo: string,
    urlVideo: string,
}

Download​

Indicador: download

Descrição: Este evento ocorre toda vez que o usuário iniciar o download do vídeo. 

{
    event: 'download'
    codVideo: string,
    nomeVideo: string,
    urlVideo: string,
}

Saltar Minutagem​

Indicador: SaltouVideo

Descrição: Este evento ocorre sempre que o usuário alterar a minutagem do vídeo, seja para frente ou para trás. 

{
    event: 'SaltouVideo'
    codVideo: string,
    AvancouVideoDe: number,
    AvancouVideoAte: number,
    nomeVideo: string,
    urlVideo: string,
}

Velocidade​

Indicador: AlterouVelocidade

Descrição: Este evento dispara toda vez que a velocidade de reprodução do vídeo é alterada. 

{
    event: 'AlterouVelocidade'
    codVideo: string,
    Velocidade: number,
    nomeVideo: string,
    urlVideo: string,
}