Como usar replicação de mídia - SDK do Amazon Chime
Participantes interativosParticipantes globaisCiclo de vida da sessão

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como usar replicação de mídia

Você pode usar a replicação de mídia para vincular uma sessão WebRTC principal a várias sessões de réplica para alcançar públicos maiores. Cada sessão de mídia WebRTC suporta 250 conexões, e você pode replicar uma sessão principal em várias sessões de réplica. Os participantes conectados a uma sessão de réplica recebem somente o áudio e o vídeo dos apresentadores conectados à sessão principal. Eles não têm conhecimento dos participantes conectados à sessão replicada, o que torna a replicação de mídia ideal para webinars e outros casos de uso em que a privacidade é desejada.

A imagem a seguir mostra a replicação de mídia entre uma sessão principal, com apresentadores compartilhando áudio e vídeo, e uma sessão de réplica, com participantes consumindo a mídia.

Apresentadores compartilhando em uma sessão principal.
nota

A service quota Chime SDK Meetings - reuniões de réplica por reunião principal tem um valor-padrão de 4, e você pode aumentar esse limite mediante solicitação. Para obter mais informações sobre as cotas, consulte Service quotas da AWS na Referência geral da AWS .

Participantes interativos

Os participantes conectados a uma sessão de réplica podem ter acesso para participar da sessão principal. Como todos usam uma conexão WebRTC, apresentadores e participantes não sofrem atrasos na transcodificação. Quando os participantes alternam entre sessões principais e replicadas, eles reutilizam suas conexões WebRTC, então a troca é extremamente rápida. Isso permite que os participantes contribuam com a conversa ao vivo sem perder nenhum conteúdo.

A imagem a seguir mostra um participante em uma sessão de réplica usando sua conexão WebRTC para alternar para a sessão principal.

Diagrama mostrando dois participantes passando de uma reunião de réplica para a reunião principal.

Participantes globais

Você pode escolher a AWS região para cada sessão de mídia do WebRTC. Isso permite que você crie sessões de réplica em regiões mais próximas de seus participantes do que na região da sessão principal. Quando você faz isso, a mídia flui da sessão principal para as sessões de réplica na rede da AWS e, em seguida, da sessão de réplica para o participante pela Internet. Ao apresentar para um público global, ter sessões de réplica perto dos participantes pode ajudar a garantir que a mídia viaje pelo mundo na rede da AWS, em vez da Internet, para uma melhor experiência de reunião.

A imagem a seguir mostra uma sessão principal e sessões replicadas em diferentes regiões.

Diagrama mostrando participantes em 3 regiões assistindo a uma apresentação.

Ciclo de vida da sessão

Como criar uma sessão

Você usa as CreateMeetingWithAttendeesAPIs CreateMeetingou para criar sessões de mídia WebRTC. Por padrão, as APIs criam uma sessão principal, a menos que você crie especificamente uma sessão de réplica.

Você cria uma sessão de réplica especificando o MeetingId da sessão principal como o PrimaryMeetingId na CreateMeeting ou na chamada de API de CreateMeetingWithAttendees.

nota

Se você especificar o MeetingId de uma sessão de réplica como o PrimaryMeetingId, a chamada de API falhará.

Como criar participantes

Para criar as credenciais de participantes necessárias para participar de uma sessão de mídia do WebRTC, você pode usar as APIs, ou. CreateMeetingWithAttendeesBatchCreateAttendeeCreateAttendee

nota

Ao criar sessões para um grande número de participantes, use CreateMeetingWithAttendees ou BatchCreateAttendee para minimizar o número de chamadas de API necessárias.

Como excluir participantes

Você usa a DeleteAttendeeAPI para revogar as credenciais de um participante para uma sessão de mídia do WebRTC. Se o participante estiver conectado à sessão, ele será desconectado e não poderá voltar.

Quando você usa a DeleteMeetingAPI para excluir uma sessão de mídia do WebRTC, a API exclui automaticamente todos os participantes e você não precisa ligar. DeleteAttendee

Como alternar entre sessões

Para permitir que um participante mude de uma sessão de réplica para uma sessão principal, você deve criar credenciais para ele na reunião principal. Consulte Criação de participantes no início desta lista. Use as credenciais com o método promoteToPrimaryMeeting na biblioteca cliente do SDK do Amazon Chime para mudar para a sessão principal.

Para transferir os participantes de volta para uma sessão de réplica, use o demoteFromPrimaryMeeting método na biblioteca cliente do Amazon Chime SDK ou use a API para invalidar suas DeleteAttendeecredenciais de sessão principal.

nota

Um apresentador que se conecta diretamente a uma sessão principal não pode mudar para uma sessão de réplica.

Para obter mais informações sobre alternar entre sessões, consulte a documentação da biblioteca cliente:

Como excluir uma sessão

Você usa a DeleteMeetingAPI para excluir sessões de mídia do WebRTC.

Se você excluir uma sessão principal, a API DeleteMeeting excluirá automaticamente todas as sessões de réplica anexadas. Então, para excluir todas as sessões, basta excluir a principal.

O serviço exclui automaticamente uma sessão principal se nenhum participante se conectar por 5 minutos contínuos. O serviço só exclui sessões de réplica automaticamente quando exclui uma sessão principal. Isso significa que você pode criar sessões de réplica ao criar uma sessão principal, e as réplicas estarão disponíveis durante a sessão principal.