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á.
# Usar canais elásticos para hospedar eventos ao vivo em reuniões do SDK do Amazon Chime
Os canais elásticos oferecem suporte a experiências de chat em grande escala com até 1 milhão de membros. Os usos típicos incluem cobertura de eventos esportivos ou políticos. Você pode usar canais elásticos apenas na região Leste dos EUA: Norte da Virgínia.
Um canal elástico consiste em um único canal com uma configuração comum, além de um número variável ou *elástico* de subcanais. A configuração também inclui limites mínimos e máximos para os membros nos subcanais.
Por exemplo, digamos que você crie um canal elástico com 100 subcanais e, para os subcanais, defina um limite baixo de 500 membros e um limite alto de 10.000 membros. Quando os usuários ingressam nesse canal de exemplo, o sistema os atribui automaticamente a um único subcanal até que a contagem de membros exceda 10.000. Nesse ponto, o sistema cria um novo subcanal e adiciona novos membros a ele. À medida que os usuários saem, o sistema exclui os subcanais e distribui os membros pelos demais subcanais.
Dividir o público em subcanais facilita o acompanhamento das conversas pelos participantes. Os moderadores também reduziram workloads, porque só precisam assistir a alguns dos subcanais. Além disso, os moderadores podem usar as ferramentas integradas fornecidas pelos canais elásticos. Por exemplo, os moderadores podem [banir usuários](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) de um canal, [criar moderadores](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html) e usar [fluxos de canais](https://docs.aws.amazon.com/chime-sdk/latest/dg/using-channel-flows.html) para moderar automaticamente todas as mensagens no canal.
Para obter mais informações sobre as cotas de Mensagens do SDK do Amazon Chime, consulte [Cotas de mensagens](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) na *Referência geral do SDK do Amazon Chime*.
**Topics**
+ [
## Pré-requisitos
](#elastic-prereqs)
+ [
## Conceitos do canal elástico
](#elastic-concepts)
+ [
## Atributos adicionais compatíveis
](#additional-features)
+ [
# Criar canais elásticos para reuniões do SDK do Amazon Chime
](create-elastic-channel.md)
+ [
# Gerenciar membros do canal elástico para reuniões do SDK do Amazon Chime
](manage-elastic-members.md)
+ [
# Enviar mensagens do canal elástico em reuniões do SDK do Amazon Chime
](send-messages-elastic.md)
+ [
# Entendendo as mensagens WebSocket do sistema em canais elásticos para reuniões do Amazon Chime SDK
](websocket-messages-elastic.md)
+ [
# Usar fluxos do Kinesis para receber mensagens do sistema para reuniões do SDK do Amazon Chime
](elastic-onboard-streams.md)
+ [
# Testar canais elásticos para reuniões do SDK do Amazon Chime em nosso aplicativo de demonstração
](elastic-testing.md)
## Pré-requisitos
Você deve ter o seguinte para usar canais elásticos.
+ Conhecimento da funcionalidade de Mensagens do SDK do Amazon Chime, como gerenciamento de canais e envio e recebimento de mensagens.
+ A capacidade de invocar o Amazon Chime SDK Messaging. APIs
## Conceitos do canal elástico
Para usar canais elásticos de forma eficaz, você deve entender esses conceitos.
**Subcanais**
Os canais elásticos dividem seus membros em contêineres lógicos chamados subcanais. Quando você adiciona um `AppInstanceUser` a um canal elástico, o usuário se torna membro de um subcanal. Esse usuário pode enviar e receber mensagens, mas somente com outros membros desse subcanal. O sistema nunca permite que mensagens de um subcanal apareçam em outros subcanais.
**Escalabilidade**
Para apoiar o engajamento do usuário, cada subcanal deve atender a um requisito mínimo de associação. Você fornece esse valor ao criar um canal elástico. Conforme os usuários entram ou saem de um evento, o sistema transfere membros para diferentes subcanais, o que torna o canal geral "elástico". Os subcanais executam as seguintes ações de escalabilidade.
+ **SCALE\$1OUT**: quando uma nova solicitação de associação ao canal elástico chega e todos os subcanais estão cheios, o sistema se expande criando um novo subcanal e, em seguida, transferindo as associações dos subcanais existentes para o novo subcanal.
+ **SCALE\$1IN**: quando a contagem de membros de um subcanal fica abaixo do requisito mínimo e outro subcanal tem a capacidade de acomodar todos os membros do primeiro subcanal, um evento `SCALE_IN` transfere essas associações e, em seguida, exclui o subcanal e todas as mensagens.
Se você precisar acessar mensagens de canais que foram excluídos, primeiro ative o streaming de mensagens. Para obter mais informações, consulte [Fazer streaming de dados do sistema de mensagens no SDK do Amazon Chime](streaming-export.md).
**Transferência de membro**
Isso ocorre quando o balanceamento de membros passa um `AppInstanceUser` de um subcanal para outro. O `AppInstanceUser` ainda pertence ao canal elástico após a transferência. No entanto, o novo subcanal contém associações e mensagens diferentes, portanto, as mensagens enviadas pelo `AppInstanceUser` após a transferência vão para esses membros diferentes. O equilíbrio de membros não afeta as associações de moderadores.
**nota**
Os canais elásticos não oferecem suporte a associações ocultas, preferências de associação e registros de data e hora de leitura de mensagens.
## Atributos adicionais compatíveis
Os canais elásticos também oferecem suporte a esses atributos de mensagens.
+ [Pré-busca](websockets.md#prefetch)
+ [Fluxos de canais](using-channel-flows.md)
# Criar canais elásticos para reuniões do SDK do Amazon Chime
Use o campo `ElasticChannelConfiguration` na API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html) para criar um canal elástico. Depois de criar um canal elástico, você cria associações de canal.
**nota**
Para canais não elásticos, o `AppInstanceUser` que cria o canal é automaticamente adicionado a esse canal como membro e moderador. Para canais elásticos, o criador do canal só é adicionado como moderador.
Não é possível atualizar um conjunto único de `ElasticChannelConfiguration`.
Você não pode atualizar um canal de elástico para não elástico e vice-versa.
Você não pode incluir uma lista de membros ARNs em uma solicitação de [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannel.html)API. No entanto, você pode incluir uma lista de moderadores ARNs.
Você não pode criar um tipo de canal elástico `UNRESTRICTED`.
# Gerenciar membros do canal elástico para reuniões do SDK do Amazon Chime
Para gerenciar os membros em um canal elástico [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelMembership.html), use o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelModerator.html), [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_CreateChannelBan.html) APIse. A tabela a seguir explica como usá-los.
**Associações ao canal**
A API `CreateChannelMembership` cria associações no nível do subcanal. Os subcanais podem incluir moderadores e membros regulares.
+ **Moderadores**: você pode adicionar moderadores a vários subcanais. Isso permite que os moderadores enviem mensagens em cada um dos subcanais aos quais pertencem. Ao adicionar um moderador a um subcanal, você deve fornecer o `SubChannelId`.
Se quiser atribuir moderadores a novos subcanais automaticamente, você pode [habilitar o streaming de mensagens](streaming-export.md), ouvir os eventos de criação de subcanais e, em seguida, criar uma associação de moderador em resposta a esses eventos.
Por fim, você pode excluir moderadores de subcanais específicos ou de todos os subcanais. Use a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_DeleteChannelMembership.html) nos dois casos. Para excluir um moderador de um subcanal específico, forneça o `SubChannelId`. Se você não fornecer uma ID para um subcanal, o sistema removerá o moderador de todos os subcanais. Por fim, é possível usar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels) para listar os subcanais e o número de membros em cada um.
+ **Membros regulares**: eles compõem a maioria das assinaturas do canal. Você só pode adicionar um membro regular a um subcanal. Além disso, você não pode aprovar um `SubChannelId` ao criar ou excluir associações de canais, porque o sistema controla em qual subcanal uma associação é criada.
**Moderadores do canal**
A API `CreateChannelModerator` cria moderadores no nível do canal elástico. Os moderadores podem ver todas as mensagens em todos os subcanais. Quando você promove um membro regular a moderador do canal, o sistema remove todas as associações existentes desse membro ao canal. O mesmo acontece quando você rebaixa um moderador.
**Proibições de canal**
A API `CreateChannelBan` cria proibições no nível do canal elástico. Um banido não `AppInstanceUser` pode pertencer a nenhum subcanal. Quando você proíbe um membro, o sistema remove todas as assinaturas do canal desse membro.
# Enviar mensagens do canal elástico em reuniões do SDK do Amazon Chime
A API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SendChannelMessage.html) cria mensagens em nível de subcanal. Para enviar mensagens, você deve ter um `subChannelId`. Você também pode usar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_UpdateChannelMessage.html), e [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_RedactChannelMessage.html) APIs para editar e excluir mensagens, mas em todos os casos, você deve ter um`subChannelId`.
**nota**
Os remetentes de mensagens só podem editar ou redigir mensagens se elas pertencerem ao subcanal para o qual enviam mensagens. Se o balanceamento de assinaturas transferir um membro para outro subcanal, esse membro só poderá editar ou redigir as mensagens enviadas nesse novo subcanal.
# Entendendo as mensagens WebSocket do sistema em canais elásticos para reuniões do Amazon Chime SDK
O SDK do Amazon Chime envia mensagens do sistema para todos os clientes conectados para eventos que ocorrem nos canais. A lista a seguir descreve as mensagens do sistema para canais elásticos.
**Evento de mensagem**
As cargas úteis de eventos para canais elásticos contêm o campo `subChannelId`. As cargas úteis para canais não elásticos permanecem as mesmas.
**Eventos de associação**
Os eventos `CREATE_CHANNEL_MEMBERSHIP` e `DELETE_CHANNEL_MEMBERSHIP` agora têm o campo `subChannelId` em suas cargas úteis.
Os canais elásticos não oferecem suporte ao evento `BATCH_CREATE_CHANNEL_MEMBERHSIP`. Quando você chama a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_BatchCreateChannelMembership.html), o sistema envia eventos `CREATE_CHANNEL_MEMBERSHIP` individuais.
Agora você pode usar o tipo de evento `UPDATE_CHANNEL_MEMBERSHIP` para sinalizar mudanças nas informações de associação. Por exemplo, durante a transferência de um membro de um subcanal para outro, o sistema envia um evento `UPDATE_CHANNEL_MEMBERSHIP` com o novo `SubChannelId` na carga para indicar que o membro foi transferido.
O sistema envia o evento `UPDATE_CHANNEL_MEMBERSHIP` somente para o membro que foi transferido, e não para outros membros do subcanal. Por esse motivo, recomendamos que você use a [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListChannelMemberships.html)API em vez de WebSockets preencher suas listas de membros do canal. Para obter mais informações, consulte [Usando WebSockets para receber mensagens no Amazon Chime SDK](websockets.md).
# Usar fluxos do Kinesis para receber mensagens do sistema para reuniões do SDK do Amazon Chime
Pode-se configurar um `AppInstance` para receber dados na forma de um fluxo. Por exemplo, um fluxo pode incluir mensagens, eventos de subcanais e eventos de canais.
Como parte disso, oferecemos suporte aos eventos `CREATE_SUB_CHANNEL` e `DELETE_SUB_CHANNEL`. Eles indicam quando um subcanal foi criado ou excluído como parte do balanceamento de assinaturas. Para obter mais informações sobre o recebimento de fluxos de dados, consulte [Fazer streaming de dados do sistema de mensagens no SDK do Amazon Chime](streaming-export.md).
# Testar canais elásticos para reuniões do SDK do Amazon Chime em nosso aplicativo de demonstração
[Você pode testar todos os recursos do Amazon Chime SDK Messaging em GitHub /. https://github.com/aws-samples/ amazon-chime-sdk tree/main/apps/chat](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/chat)