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

Conceitos de mensagens

Para usar as mensagens do SDK do Amazon Chime de forma eficaz, você deve entender os seguintes termos e conceitos.

AppInstance

Para usar o sistema de mensagens do Amazon Chime SDK, você deve primeiro criar um. AppInstance AppInstanceUsers E AppInstance contém três canais. Normalmente, você cria um único AppInstance para seu aplicativo. Uma AWS conta pode ter várias AppInstances. Você faz configurações no nível do aplicativo, como retenção de mensagens e configuração de streaming, no AppInstance nível. AppInstances são identificados por um ARN exclusivo neste formato:. arn:aws:chime:region:aws_account_id:app-instance/app_instance_id

AppInstanceUser

AppInstanceUsers são as entidades que enviam mensagens, criam canais, ingressam em canais e assim por diante. Normalmente, você cria um one-to-one mapeamento de um AppInstanceUser para um usuário do seu aplicativo. Você também pode criar um AppInstanceUser para se conectar aos serviços de back-end, o que permite que os usuários identifiquem as mensagens como provenientes de um serviço de back-end. AppInstanceUsersidentificado por um ARN, como. arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id Controle o app_instance_user_id, como prática recomendada, reutilize as IDs que seu aplicativo já tem.

Channel (Canal)

Quando você adiciona um AppInstanceUser a um canal, esse usuário se torna membro e pode enviar e receber mensagens. Os canais podem ser públicos, que permitem que qualquer usuário se adicione como membro, ou privados, que permitem que somente os moderadores do canal adicionem membros. Você também pode ocultar membros do canal. Membros ocultos podem observar conversas, mas não enviar mensagens, e não são adicionados à associação ao canal.

SubChannel

Os membros de um canal elástico são divididos em um contêiner lógico chamado SubChannels. Quando você adiciona um AppInstanceUser a um canal elástico, o usuário se torna membro de um SubChannel e pode enviar e receber mensagens para esse canal específico SubChannel. As assinaturas e mensagens do canal estão em um SubChannel nível que significa que uma mensagem enviada por um membro em um não SubChannel será recebida por um membro em outro SubChannel. Os membros são transferidos para diferentes SubChannels para apoiar a natureza elástica de um canal e promover o engajamento.

UserMessage

Um AppInstanceUser que pertence a um canal pode enviar e receber mensagens do usuário. O AppInstanceUser pode enviar mensagens STANDARD ou CONTROL. As mensagens STANDARD podem conter 4 KB de dados e 1 KB de metadados. As mensagens CONTROL podem conter somente 30 bytes de dados. As mensagens podem ser PERSISTENT ou NON_PERSISTENT. Pode-se recuperar mensagens PERSISTENT do histórico do canal. As mensagens NON_PERSISTENT são vistas somente pelos membros do canal atualmente conectados às Mensagens do SDK do Amazon Chime.

Mensagem do sistema

O SDK do Amazon Chime gera mensagens do sistema em resposta a eventos, como membros entrando ou saindo de um canal.