Descripción de los conceptos de mensajería de Amazon Chime SDK

Para utilizar la mensajería de Amazon Chime SDK de forma eficaz, debe comprender los siguientes términos y conceptos.

AppInstance

Para usar la mensajería del SDK de Amazon Chime, primero debe crear un. AppInstance AppInstanceUsers Y AppInstance contiene y 4 canales. Por lo general, se crea una versión única AppInstance para la aplicación. Una AWS cuenta puede tener varias AppInstances. Los ajustes a nivel de aplicación, como la retención de mensajes y la configuración de streaming, se establecen a AppInstance nivel. AppInstances se identifican mediante un ARN único en este formato:. arn:aws:chime:region:aws_account_id:app-instance/app_instance_id

AppInstanceUser

AppInstanceUsers son las entidades que envían mensajes, crean canales, se unen a los canales, etc. Por lo general, se crea un one-to-one mapeo de una AppInstanceUser a un usuario de la aplicación. También puedes crear una AppInstanceUser para conectarte a los servicios back-end, lo que permite a los usuarios identificar los mensajes que provienen de un servicio back-end. AppInstanceUsers identificado por un ARN, como. arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id Usted controla el app_instance_user_id contenido que ya tiene su aplicación y, como práctica recomendada, IDs lo reutiliza.

Canal

Cuando añade un canal AppInstanceUser, ese usuario se convierte en miembro y puede enviar y recibir mensajes. Los canales pueden ser públicos, lo que permite a cualquier usuario añadirse como miembro, o privados, lo que permite que solo los moderadores del canal añadan miembros. También puede ocultar a los miembros del canal. Los miembros ocultos pueden observar las conversaciones, pero no enviar mensajes, y no se añaden a la membresía del canal.

SubChannel

Los miembros de un canal elástico se dividen en un contenedor lógico llamado SubChannels. Al añadir un canal elástico, el usuario pasa AppInstanceUser a ser miembro de un SubChannel y puede enviar y recibir mensajes para ese canal en concreto SubChannel. Las membresías y los mensajes del canal están en un mismo SubChannel nivel, lo que significa que un mensaje enviado por un miembro de uno de ellos no SubChannel lo recibirá un miembro de otro SubChannel. Los miembros se transfieren SubChannels a diferentes canales para respaldar la naturaleza elástica de un canal y fomentar la interacción.

UserMessage

Un AppInstanceUser que pertenezca a un canal puede enviar y recibir mensajes de usuario. El AppInstanceUser puede enviar STANDARD o enviar mensajes de CONTROL. Los mensajes de STANDARD pueden contener 4 KB de datos y 1 KB de metadatos. Los mensajes de CONTROL solo pueden contener 30 bytes de datos. Los mensajes pueden ser PERSISTENT o NON_PERSISTENT. Puede recuperar PERSISTENT mensajes del historial del canal. Los mensajes NON_PERSISTENT solo los ven los miembros del canal que estén conectados actualmente a la mensajería de Amazon Chime SDK.

Mensaje del sistema

Amazon Chime SDK genera mensajes del sistema en respuesta a eventos como la entrada o salida de miembros de un canal.