Experiência com o Composer

Visão geral

Iniciar uma sessão do Experience Composer.

O Experience Composer é um serviço baseado na nuvem que permite capturar qualquer site disponível ao público e publicá-lo como um stream em uma sessão existente da Video API da Vonage. Isso fluxo composto pode ser usado para gravação de arquivo, transmissão e streaming para outras sessões interativas do Vonage Video, mantendo intactas as experiências ricas de UI/UX do site.

Casos de uso

Arquivo do Experience Composer

Você pode usar o Vonage Video arquivo recurso para gravar áudio e vídeo de uma sessão do Vonage Video. No entanto, o formato do vídeo do arquivo gerado está limitado aos formatos compatíveis opções de layout de vídeo.

Você pode usar o Experience Composer para utilizar o seu site efetivo layout para o layout do arquivo:

Crie um Experience Composer, com a URL apontando para uma página da web que assine os fluxos em uma sessão, aplicando o layout adequado.
Faça com que o Experience Composer publique a página em um stream em uma nova sessão do Vonage Video.
Use o API REST do Vonage Video API ou o método do SDK do servidor de vídeo da Vonage para arquivar a transmissão do Experience Composer.

Defina a resolução do arquivo para que corresponda à resolução do Experience Composer (que é definida ao iniciar o Experience Composer).

Experimente o Composer Broadcast

Com o Vonage Video recurso de transmissão ao vivo, é possível transmitir uma sessão do Vonage Video para um stream HLS ou RTMP. No entanto, o layout do vídeo para uma transmissão ao vivo está limitado aos formatos compatíveis opções de layout de vídeo.

Você pode usar o Experience Composer para utilizar o seu site efetivo layout para a transmissão:

Crie um Experience Composer, com a URL apontando para uma página da web que assine os fluxos em uma sessão, aplicando o layout adequado.
Faça com que o Experience Composer publique a página em um stream em uma nova sessão do Vonage Video.
Use o API REST do Vonage Video API ou o método do SDK do servidor de vídeo da Vonage para transmitir o fluxo do Experience Composer para um fluxo HLS ou RTMP.

Defina a resolução do arquivo para que corresponda à resolução do Experience Composer (que é definida ao iniciar o Experience Composer).

Ampliar as transmissões interativas ao vivo para incluir mais participantes (até milhões)

As transmissões ao vivo do Vonage Video permitem que até 15.000 clientes assistam a uma sessão interativa do Vonage Video. O número suportado depende do número de clientes que estão transmitindo na sessão (consulte o Transmissões interativas ao vivo (guia).

Você pode usar o Experience Composer para aumentar o número de espectadores:

Crie um Experience Composer, com a URL apontando para uma página da web que assine os fluxos da sessão principal do Vonage Video a ser transmitida.
Faça com que o Experience Composer publique a página em uma nova sessão do Vonage Video.
Repita esse procedimento com várias outras instâncias do Experience Composer — cada uma delas assinando os fluxos da primeira sessão e publicando-os em uma nova sessão.
Seu servidor de aplicativos enviará os IDs de sessão para o Experimente as sessões do Composer para cada um dos clientes de visualização (clientes que não estão publicando na primeira sessão). O servidor de aplicativos precisará acompanhar quantos clientes são adicionados a cada sessão do Experience Composer, de modo que não haja mais do que 15.000 conectados a qualquer uma delas.

A matriz resultante de sessões do Experience Composer suportará até 15.000 * (15.000 - 2) espectadores (224.970.000 espectadores) quando houver dois editores. Para outros números de editores, consulte a tabela de clientes compatíveis no Transmissões interativas ao vivo guia, e essa técnica servirá de apoio 15,000 * ([number supported from that table] - [number of publishers]) clientes.

Outros casos de uso

Você pode usar o Experience Composer para capturar qualquer página da web e enviá-la como um fluxo de áudio e vídeo para uma sessão do Vonage Video, para que outras pessoas possam visualizá-la. A página pode incluir áudio e vídeo de fontes diferentes dos fluxos do Vonage Video. Ou pode incluir conteúdo dinâmico com um layout de interface do usuário complexo, que os clientes conectados à sessão do Vonage Video possam visualizar.

Limitações

Sem suporte para GPU

Os servidores de renderização do Experience Composer não possuem GPU support. Elas não são capazes de executar aplicativos web que normalmente utilizariam mais de 10% do GPU em execução no Chrome em um computador. Se o aplicativo web que você enviar para o Experience Composer usar OpenGL (ou outro código que se beneficiaria de um GPU), o desempenho e a renderização no Experience Composer podem ser prejudicados.

São necessárias sessões roteadas

O Experience Composer é compatível apenas com sessões roteadas (sessões que utilizam o Roteador de mídia de vídeo da Vonage).

Rotação de servidores

Um Experience Composer é encerrado durante a rotação de servidores da sessão que ele utiliza. É possível reiniciar um Experience Composer em resposta a eventos de notificação de rotação de servidores. Consulte Rotação de servidores e migração de sessões.

Apenas API REST

No momento da redação deste artigo, o Experience Composer só pode ser acessado por meio de uma interface de API REST. Consulte o Documentação REST para mais informações.

Configurando callbacks

Para configurar callbacks seguros para os webhooks do Experience Composer, consulte este guia.

Quando o status de um Experience Composer for alterado, uma solicitação HTTP POST será enviada para a URL configurada. Se nenhuma URL de retorno for configurada, nenhuma atualização de status será enviada. Os dados brutos da solicitação HTTP consistem em uma mensagem codificada em JSON com o seguinte formato:

{
  "id": "<experience-composer-id>",
  "sessionId": "<session-id>",
  "streamId": "<output-stream-id>",
  "status": "stopped",
  "reason": "Max duration exceeded."
}

O objeto JSON inclui as seguintes propriedades:

id: O ID exclusivo do Experience Composer.
sessionId: O ID da sessão do Vonage Video.
streamId: O ID do fluxo composto que está sendo publicado. O streamId pode não estar disponível quando o status for "failed".
status: O status do Experience Composer. Essa propriedade pode assumir um dos seguintes valores:
- "started": A plataforma da Video API do Vonage se conectou com sucesso ao servidor de aplicativos remoto e está publicando a visualização da web em um stream do Vonage Video.
- "stopped": O Experience Composer foi encerrado.
- "failed": Ocorreu um erro e o Experience Composer não pôde continuar. Isso pode ocorrer na inicialização se o servidor do Vonage Video não conseguir se conectar ao servidor de aplicativos remoto ou republicar o stream. Também pode ocorrer a qualquer momento durante o processo devido a um erro na plataforma da Video API do Vonage Video.
reason: Este campo só está disponível quando o status for "stopped" ou "failed". Se o status for "stopped", o campo “motivo” conterá ou "Max Duration Exceeded" ou "Stop Requested." Se o status for "failed", o campo “motivo” conterá "Internal server failure".

Visualização de dados

Visualizar dados no Painel de Análise de Vídeos

A seção “Análise de Vídeo” no Painel da Vonage fornece dados no nível da chave de API e do ID do aplicativo. Você pode acessá-la fazendo login na sua Account da Video API da Vonage, acesse o Analytics e, em seguida, a seção “Análise de vídeos”.

Visualizar dados na API do Video Insights

Você pode usar o API do Insights para visualizar os dados de uso do Experience Composer.

O experienceComposer Os dados de uso mostram os minutos publicados pelo Experience Composer.

O experienceComposerArchive e experienceComposerBroadcast As propriedades de uso estão obsoletas. Anteriormente, o experienceComposer Os dados de uso não incluíam os minutos correspondentes aos períodos em que um Experience Composer estava conectado a um arquivo ou a uma transmissão. No entanto, isso não acontece mais. (Os pacotes “Experience Composer Archive” e “Experience Composer Broadcast” não estão mais disponíveis.)