

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Grundlegendes zu den Messaging-Konzepten des Amazon Chime SDK
<a name="messaging-concepts"></a>

Um Amazon Chime SDK-Messaging effektiv nutzen zu können, müssen Sie die folgenden Begriffe und Konzepte verstehen.

**AppInstance**  
Um Amazon Chime SDK-Messaging verwenden zu können, müssen Sie zuerst eine AppInstance erstellen. Ein AppInstance enthält AppInstanceUsers und Kanäle. In der Regel erstellen Sie eine Single AppInstance für Ihre Anwendung. Ein AWS Konto kann mehrere haben AppInstances. Sie nehmen Einstellungen auf App-Ebene vor, z. B. die Aufbewahrung von Nachrichten und die Streaming-Konfiguration, auf der AppInstance Ebene. AppInstances werden durch einen eindeutigen ARN in diesem Format identifiziert:`arn:aws:chime:region:aws_account_id:app-instance/app_instance_id`.

**AppInstanceUser**  
AppInstanceUsers sind die Entitäten, die Nachrichten senden, Kanäle erstellen, Kanälen beitreten usw. In der Regel erstellen Sie eine one-to-one Zuordnung von einem `AppInstanceUser` zu einem Benutzer Ihrer App. Sie können auch eine Verbindung `AppInstanceUser` zu Back-End-Diensten herstellen, sodass Benutzer Nachrichten als von einem Back-End-Dienst stammend identifizieren können. AppInstanceUsers identifiziert durch einen ARN, z. `arn:aws:chime:region:aws_account_id:app-instance/app_instance_id/user/app_instance_user_id` B. Sie kontrollieren das`app_instance_user_id`, was in Ihrer Anwendung bereits vorhanden ist, und verwenden IDs es als bewährte Methode erneut.

**Kanal**  
Wenn Sie einem Kanal einen `AppInstanceUser` hinzufügen, wird dieser Benutzer Mitglied und kann Nachrichten senden und empfangen. Kanäle können öffentlich sein, sodass sich jeder Benutzer selbst als Mitglied hinzufügen kann, oder privat, sodass nur Kanalmoderatoren Mitglieder hinzufügen können. Du kannst Kanalmitglieder auch ausblenden. Versteckte Mitglieder können Konversationen beobachten, aber keine Nachrichten senden, und sie werden nicht zur Kanalmitgliedschaft hinzugefügt.

**SubChannel**  
Mitglieder eines elastischen Kanals werden in einen logischen Container namens unterteilt SubChannels. Wenn Sie einem Elastic Channel einen AppInstanceUser hinzufügen, wird der Benutzer Mitglied eines Kanals SubChannel und kann Nachrichten für diesen bestimmten Kanal senden und empfangen SubChannel. Kanalmitgliedschaften und Nachrichten sind auf einer bestimmten SubChannel Ebene angeordnet, was bedeutet, dass eine Nachricht, die von einem Mitglied in einem Kanal gesendet wurde, nicht von einem Mitglied in einem anderen SubChannel Kanal empfangen SubChannel wird. Mitglieder werden in andere Kanäle versetzt SubChannels , um die Flexibilität eines Kanals zu unterstützen und das Engagement zu fördern.

**UserMessage**  
Jeder`AppInstanceUser`, der einem Kanal angehört, kann Benutzernachrichten senden und empfangen. Sie `AppInstanceUser` können `CONTROL` Nachrichten `STANDARD` oder Nachrichten senden. `STANDARD`Nachrichten können 4 KB an Daten und 1 KB an Metadaten enthalten. `CONTROL`Nachrichten können nur 30 Byte an Daten enthalten. Nachrichten können `PERSISTENT` oder sein`NON_PERSISTENT`. Sie können `PERSISTENT` Nachrichten aus dem Kanalverlauf abrufen. `NON_PERSISTENT`Nachrichten werden nur von Kanalmitgliedern gesehen, die derzeit mit Amazon Chime SDK-Nachrichten verbunden sind.

**Systemnachricht**  
Das Amazon Chime SDK generiert Systemnachrichten als Reaktion auf Ereignisse wie Mitglieder, die einem Kanal beitreten oder ihn verlassen.