Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Comprendre les concepts de messagerie du SDK Amazon Chime
<a name="messaging-concepts"></a>

Pour utiliser efficacement la messagerie du SDK Amazon Chime, vous devez comprendre les termes et concepts suivants.

**AppInstance**  
Pour utiliser la messagerie du SDK Amazon Chime, vous devez d'abord créer un. AppInstance AppInstanceUsers Et AppInstance contient et canaux. En général, vous créez un single AppInstance pour votre application. Un AWS compte peut en avoir plusieurs AppInstances. Vous définissez les paramètres au niveau de l'application, tels que la rétention des messages et la configuration du streaming, au AppInstance niveau. AppInstances sont identifiés par un ARN unique au format suivant :`arn:aws:chime:region:aws_account_id:app-instance/app_instance_id`.

**AppInstanceUser**  
AppInstanceUsers sont les entités qui envoient des messages, créent des chaînes, rejoignent des chaînes, etc. Généralement, vous créez un one-to-one mappage d'un `AppInstanceUser` vers un utilisateur de votre application. Vous pouvez également créer une connexion `AppInstanceUser` aux services principaux, ce qui permet aux utilisateurs d'identifier les messages comme provenant d'un service principal. AppInstanceUsers identifié par un ARN, tel que`arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id`. Vous contrôlez et`app_instance_user_id`, en tant que bonne pratique, vous réutilisez IDs ce que possède déjà votre application.

**Channel**  
Lorsque vous ajoutez un `AppInstanceUser` à une chaîne, cet utilisateur devient membre et peut envoyer et recevoir des messages. Les chaînes peuvent être publiques, ce qui permet à tout utilisateur de s'ajouter en tant que membre, ou privées, ce qui permet uniquement aux modérateurs de chaînes d'ajouter des membres. Vous pouvez également masquer les membres de la chaîne. Les membres masqués peuvent observer les conversations mais pas envoyer de messages, et ils ne sont pas ajoutés aux membres de la chaîne.

**SubChannel**  
Les membres d'un canal élastique sont divisés dans un conteneur logique appelé SubChannels. Lorsque vous ajoutez un AppInstanceUser à un canal élastique, l'utilisateur devient membre d'un canal SubChannel et peut envoyer et recevoir des messages pour ce canal en particulier SubChannel. Les adhésions aux chaînes et les messages sont d'un SubChannel certain niveau, ce qui signifie qu'un message envoyé par un membre d'une chaîne ne SubChannel sera pas reçu par un membre d'une autre SubChannel. Les membres sont transférés vers un autre canal SubChannels afin de renforcer la nature élastique d'un canal et de promouvoir l'engagement.

**UserMessage**  
Toute `AppInstanceUser` personne appartenant à une chaîne peut envoyer et recevoir des messages utilisateur. Ils `AppInstanceUser` peuvent envoyer `STANDARD` des `CONTROL` messages. `STANDARD`les messages peuvent contenir 4 Ko de données et 1 Ko de métadonnées. `CONTROL`les messages ne peuvent contenir que 30 octets de données. Les messages peuvent être `PERSISTENT` ou`NON_PERSISTENT`. Vous pouvez récupérer `PERSISTENT` des messages depuis l'historique des chaînes. `NON_PERSISTENT`les messages ne sont visibles que par les membres de la chaîne actuellement connectés à la messagerie du SDK Amazon Chime.

**Message du système**  
Le SDK Amazon Chime génère des messages système en réponse à des événements tels que l'adhésion ou le départ de membres d'une chaîne.