Noções básicas sobre eventos do ciclo de vida de reuniões do SDK do Amazon Chime - SDK do Amazon Chime

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á.

Noções básicas sobre eventos do ciclo de vida de reuniões do SDK do Amazon Chime

O SDK do Amazon Chime envia eventos do ciclo de vida da reunião, que você pode usar para acionar notificações e iniciar fluxos de trabalho posteriores. Alguns exemplos de uso dos eventos de reunião incluem:

  • Como atualizar metadados quando um participante ingressa ou sai de uma reunião do SDK do Amazon Chime.

  • Como implementar notificações por push ou listas para uma reunião do SDK do Amazon Chime.

  • Como medir o uso do compartilhamento de vídeo e conteúdo em reuniões do SDK do Amazon Chime.

Você pode enviar eventos para a Amazon EventBridge, Amazon Simple Notification Service (SNS) e Amazon Simple Queue Service (SQS). Para obter mais informações, consulte Eventos de AWS serviços no Guia do EventBridge usuário da Amazon.

O SDK do Amazon Chime envia este evento quando uma nova reunião é iniciada.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:MeetingStarted", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando uma reunião ativa termina.

nota

Para maior eficiência, o serviço também envia esse evento quando você liga para o DeleteMeetingAPI.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:MeetingEnded", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um novo participante é adicionado a uma reunião ativa.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeAdded", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O Amazon Chime SDK envia esse evento quando você usa o DeleteAttendeeAPI para remover um participante de uma reunião ativa.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeDeleted", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um usuário, que já esteja participando da reunião, usa o mesmo token de participação para entrar na reunião novamente. Por exemplo, um usuário pode mudar de uma máquina desktop para um dispositivo móvel. Essa ação efetivamente “transfere” a reunião para o novo dispositivo.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeAuthorized", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um participante existente entra em uma reunião do SDK do Amazon Chime usando o transporte de rede especificado.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeJoined", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um participante existente sai de uma reunião do SDK do Amazon Chime usando o transporte de rede especificado.

nota

O serviço nunca envia eventos chime:AttendeeLeft e chime:AttendeeDropped para a mesma ação de “sair”. Desconectar e sair são ações diferentes, e o sistema envia o evento correspondente a cada ação.

Por exemplo, digamos que um participante com uma conexão ruim participe de uma reunião às 11h. É possível esperar as seguintes ações:

11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee 11:00 Event – chime:AttendeeAdded 11:01 Action – user joins meeting 11:01 Event – chime:AttendeeJoined 11:02 Action – user's connection drops 11:02 Event – chime:AttendeeDropped 11:03 Action – user's connection restored 11:03 Event – chime:AttendeeJoined 11:30 Action – user leaves meeting 11:30 Event – chime:AttendeeLeft
exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeLeft", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um participante atual é desconectado de uma reunião do SDK do Amazon Chime, geralmente devido a uma conexão ruim. Quando o serviço não recebe pacotes por 10 a 15 segundos, ele considera que o cliente foi desconectado e emite o evento.

O serviço geralmente aciona ações de desconexão, mas os clientes também podem acioná-las. Por exemplo, digamos que um usuário troque seu laptop de Wi-Fi para Ethernet. Essa ação constitui uma alteração de adaptador de rede e a conexão é reiniciada. Por sua vez, essa ação redefine o websocket e aciona uma ação combinada de drop-join.

nota

O serviço nunca envia eventos chime:AttendeeLeft e chime:AttendeeDropped para a mesma ação de “sair”. Desconectar e sair são ações diferentes, e o sistema envia o evento correspondente a cada ação.

Por exemplo, digamos que um participante com uma conexão ruim participe de uma reunião às 11h. É possível esperar as seguintes ações:

11:00 API – CreateAttendee, CreateMeetingWithAttendee, or BatchCreateAttendee 11:00 Event – chime:AttendeeAdded 11:01 Action – user joins meeting 11:01 Event – chime:AttendeeJoined 11:02 Action – user's connection drops 11:02 Event – chime:AttendeeDropped 11:03 Action – user's connection restored 11:03 Event – chime:AttendeeJoined 11:30 Action – user leaves meeting 11:30 Event – chime:AttendeeLeft
exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeDropped", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um participante existente inicia o streaming de vídeo.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeVideoStarted", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um participante existente encerra o streaming de vídeo.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeVideoStopped", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um participante existente inicia o compartilhamento de tela.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentJoined", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um participante existente para o compartilhamento de tela.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentLeft", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando os recursos de um participante existente são atualizados.

exemplo Dados de eventos
{ "version": "0", "source": "aws.chime", "account": "111122223333", "id": "12345678-1234-1234-1234-111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [], "detail": { "version": "0", "eventType": "chime:AttendeeCapabilitiesUpdated", "success": "1", // value can be 1 or 0. 1 means success, 0 means failure "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "mymeeting", "attendeeId": "attendeeId", "externalUserId": "externalUserId" "mediaRegion": "us-east-1" "attendeeCapabilities": { "audio": "SendReceive", "video": "SendReceive", "content": "SendReceive" } } }

O SDK do Amazon Chime envia esse evento quando um compartilhamento de conteúdo entra em uma reunião do SDK do Amazon Chime usando o transporte de rede especificado.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentJoined", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um compartilhamento de conteúdo sai de uma reunião do SDK do Amazon Chime usando o transporte de rede especificado.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentLeft", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia esse evento quando um compartilhamento de conteúdo é descartado de uma reunião do SDK do Amazon Chime, normalmente devido à baixa largura de banda.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentDropped", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "networkType": "Voip", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um compartilhamento de conteúdo inicia o streaming de vídeo.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentVideoStarted", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }

O SDK do Amazon Chime envia este evento quando um compartilhamento de conteúdo para o streaming de vídeo.

exemplo Dados de eventos

Veja a seguir um exemplo que mostra os dados desse evento.

{ "version": "0", "source": "aws.chime", "account": "111122223333", "region": "us-east-1", "detail-type": "Chime Meeting State Change", "time": "yyyy-mm-ddThh:mm:ssZ", "resources": [] "detail": { "version": "0", "eventType": "chime:AttendeeContentVideoStopped", "timestamp": 12344566754, "meetingId": "87654321-4321-4321-1234-111122223333", "attendeeId": "87654321-4321-4321-1234-111122223333", "externalUserId": "87654321-4321-4321-1234-111122223333", "externalMeetingId": "87654321-4321-4321-1234-111122223333", "mediaRegion": "us-east-1" } }