# Erste Schritte mit Amazon IVS Chat Amazon Interactive Video Service (IVS) Chat ist ein verwaltetes Live-Chat-Feature, die neben Ihren Live-Videostreams ausgeführt werden kann. (IVS Chat kann auch ohne Videostream verwendet werden.) Sie können Chatrooms erstellen und Chat-Sitzungen zwischen Ihren Benutzern aktivieren. Mit Amazon IVS Chat können Sie sich neben Live-Videos darauf konzentrieren, maßgeschneiderte Chat-Erlebnisse zu erstellen. Sie müssen keine Infrastruktur verwalten oder Komponenten Ihrer Chat-Workflows entwickeln und konfigurieren. Amazon IVS Chat ist skalierbar, sicher, zuverlässig und kosteneffektiv. Amazon IVS Chat funktioniert am besten, um Nachrichten zwischen Teilnehmern eines Live-Videostreams mit einem Anfang und einem Ende zu erleichtern. Der Rest dieses Dokuments führt Sie durch die Schritte zum Erstellen Ihrer ersten Chat-Anwendung mit Amazon IVS Chat. **Beispiele:** Die folgenden Demo-Apps sind verfügbar (drei Beispiel-Client-Apps und eine Backend-Server-App zur Token-Erstellung): + [Amazon-IVS-Chat-Webdemo](https://github.com/aws-samples/amazon-ivs-chat-web-demo) + [Amazon-IVS-Chat für Android-Demo](https://github.com/aws-samples/amazon-ivs-chat-for-android-demo) + [Amazon-IVS-Chat für iOS-Demo](https://github.com/aws-samples/amazon-ivs-chat-for-ios-demo) + [Amazon-IVS-Chat-Demo-Backend](https://github.com/aws-samples/amazon-ivs-chat-web-demo/tree/main/serverless) **Wichtig:** Chatrooms, die 24 Monate lang keine neuen Verbindungen oder Updates haben, werden automatisch gelöscht. **Topics** + [Schritt 1: Durchführen der Ersteinrichtung](getting-started-chat-create-account.md) + [Schritt 2: Erstellen eines Chatrooms](getting-started-chat-create-room.md) + [Schritt 3: Erstellen eines Chat-Tokens](getting-started-chat-auth.md) + [Schritt 4: Senden und Empfangen Ihrer ersten Nachricht](getting-started-chat-send-and-receive.md) + [Schritt 5: Überprüfen Ihre Service-Quota-Limits (optional)](getting-started-chat-check-service-quota.md) # Schritt 1: Durchführen der Ersteinrichtung Bevor Sie fortfahren, müssen Sie folgende Aufgaben durchführen: 1. Erstellen Sie ein AWS-Konto. 1. Richten Sie Root-Benutzer und Administratoren ein. 1. Einrichten von AWS-IAM-Berechtigungen (Identity and Access Management). Verwenden Sie die unten angegebene Richtlinie. Spezifische Schritte für die oben aufgeführten Aufgaben finden Sie unter [Erste Schritte mit IVS Streaming mit niedriger Latenz](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/getting-started.html) im *Benutzerhandbuch zu Amazon IVS*. **Wichtig**: Verwenden Sie unter „Schritt 3: Einrichten von IAM-Berechtigungen“ diese Richtlinie für IVS Chat: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ivschat:CreateChatToken", "ivschat:CreateLoggingConfiguration", "ivschat:CreateRoom", "ivschat:DeleteLoggingConfiguration", "ivschat:DeleteMessage", "ivschat:DeleteRoom", "ivschat:DisconnectUser", "ivschat:GetLoggingConfiguration", "ivschat:GetRoom", "ivschat:ListLoggingConfigurations", "ivschat:ListRooms", "ivschat:ListTagsForResource", "ivschat:SendEvent", "ivschat:TagResource", "ivschat:UntagResource", "ivschat:UpdateLoggingConfiguration", "ivschat:UpdateRoom" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "servicequotas:ListServiceQuotas", "servicequotas:ListServices", "servicequotas:ListAWSDefaultServiceQuotas", "servicequotas:ListRequestedServiceQuotaChangeHistoryByQuota", "servicequotas:ListTagsForResource", "cloudwatch:GetMetricData", "cloudwatch:DescribeAlarms" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "logs:CreateLogDelivery", "logs:GetLogDelivery", "logs:UpdateLogDelivery", "logs:DeleteLogDelivery", "logs:ListLogDeliveries", "logs:PutResourcePolicy", "logs:DescribeResourcePolicies", "logs:DescribeLogGroups", "s3:PutBucketPolicy", "s3:GetBucketPolicy", "iam:CreateServiceLinkedRole", "firehose:TagDeliveryStream" ], "Resource": "*" } ] } ``` ------ # Schritt 2: Erstellen eines Chatrooms Ein Amazon-IVS-Chatroom enthält damit verknüpfte Konfigurationsinformationen (z. B. maximale Nachrichtenlänge). Die Anweisungen in diesem Abschnitt zeigen Ihnen, wie Sie die Konsole oder die AWS-CLI verwenden, um Chaträume einzurichten (einschließlich der optionalen Einrichtung für die Überprüfung von Nachrichten und/oder die Protokollierung von Nachrichten) und Räume zu erstellen. # Konsolenanweisungen zum Erstellen eines IVS-Chatrooms Diese Schritte sind in Phasen unterteilt, die mit der ersten Einrichtung des Raums beginnen und mit der endgültigen Raumerstellung enden. Optional können Sie einen Raum einrichten, damit Nachrichten überprüft werden. Sie können beispielsweise Nachrichteninhalt oder Metadaten aktualisieren, Nachrichten ablehnen, um zu verhindern, dass sie gesendet werden, oder die ursprüngliche Nachricht durchlassen. Weitere Informationen hierzu finden Sie unter [Einrichten, um Raumnachrichten zu überprüfen (optional)](#create-room-console-review-messages). Außerdem können Sie einen Chatroom optional so einrichten, dass Nachrichten protokolliert werden. Wenn Nachrichten beispielsweise an einen Chatroom gesendet werden, können Sie sie in einem Amazon-S3-Bucket, in Amazon CloudWatch oder in Amazon Kinesis Data Firehose protokollieren. Weitere Informationen hierzu finden Sie unter [Einrichtung für die Protokollierung von Nachrichten (optional)](#create-room-console-log-messages). ## Erstes Einrichten eines Raums 1. Öffnen Sie die [Amazon-IVS-Chat-Konsole](https://console.aws.amazon.com/ivs/chat). (Sie können auf die Amazon-IVS-Konsole auch über die [AWS-Managementkonsole](https://console.aws.amazon.com/) zugreifen.) 1. Verwenden Sie auf der Navigationsleiste im Dropdown-Menü **Auswählen einer Region**, um eine Region auszuwählen. Ihr neuer Raum wird in dieser Region erstellt. 1. Wählen Sie im Feld **Erste Schritte** (oben rechts) **Amazon-IVS-Chatroom** aus. Das Fenster **Raum erstellen** wird angezeigt. ![\[Erstellen eines Chatrooms\]](http://docs.aws.amazon.com/de_de/ivs/latest/ChatUserGuide/images/Chat_Create_Room.png) 1. Unter **Einrichtung** geben Sie optional einen **Raumnamen** an. Raumnamen sind nicht eindeutig, aber sie bieten Ihnen eine Möglichkeit, andere Räume als den Raum-ARN (Amazon Resource Name) zu unterscheiden. 1. Unter **Einrichten > Raumkonfiguration** akzeptieren Sie entweder die **Standardkonfiguration** oder wählen Sie **Benutzerdefinierte Konfiguration** und konfigurieren dann die **Maximale Nachrichtenlänge** und/oder die **Maximale Nachrichtenrate**. 1. Wenn Sie Nachrichten überprüfen möchten, fahren Sie mit [Einrichten, um Raum-Nachrichten zu überprüfen (optional)](#create-room-console-review-messages) unten fort. Andernfalls überspringen Sie diesen Schritt (d. h. Sie akzeptieren die Einstellung **Nachrichtenrezension-Handler > Deaktiviert**) und fahren direkt mit [Abschließende Raumerstellung](#create-room-console-final) fort. ## Einrichten, um Raumnachrichten zu überprüfen (optional) 1. Unter **Nachrichtenrezension-Handler** wählen Sie **Mit AWS Lambda umgehen** aus. Der Bereich **Message Review Handler** (Nachrichtenüberprüfungs-Handler) wird erweitert, um zusätzliche Optionen anzuzeigen. 1. Konfigurieren Sie das **Fallback-Ergebnis** so, dass die Nachricht **zugelassen** oder **abgelehnt** wird, wenn der Handler keine gültige Antwort zurückgibt, ein Fehler auftritt oder die Leerlaufzeitlimit überschritten wird. 1. Geben Sie Ihre bestehende **Lambda-Funktion** an oder verwenden Sie **Lambda-Funktion erstellen**, um eine neue Funktion zu erstellen. Die Lambda-Funktion muss sich in derselben AWS-Region und demselben AWS-Konto wie der Client-VPN-Endpunkt befinden. Sie sollten dem Amazon-Chat-SDK-Service die Berechtigung erteilen, Ihre Lambda-Ressource aufzurufen. Die ressourcenbasierte Richtlinie wird automatisch für die von Ihnen ausgewählte Lambda-Funktion erstellt. Weitere Informationen zu Berechtigungen finden Sie unter [Ressourcenbasierte Richtlinie für Amazon IVS Chat](security-iam.md#security-chat-policy-examples). ## Einrichtung für die Protokollierung von Nachrichten (optional) 1. Wählen Sie unter **Message logging** (Nachrichtenprotokollierung) die Option **Automatically log chat messages** (Chatnachrichten automatisch protokollieren) aus. Der Bereich **Message logging** (Nachrichtenprotokollierung) wird erweitert, um zusätzliche Optionen anzuzeigen. Sie können diesem Chatroom entweder eine vorhandene Protokollierungskonfiguration hinzufügen oder eine neue erstellen, indem Sie **Create logging configuration** (Protokollierungskonfiguration erstellen) auswählen. 1. Wenn Sie eine vorhandene Protokollierungskonfiguration auswählen, wird ein Dropdown-Menü mit allen bereits erstellten Protokollierungskonfigurationen angezeigt. Wählen Sie eine Konfiguration in der Liste aus. Ihre Chatnachrichten werden dann automatisch am betreffenden Ziel protokolliert. 1. Wenn Sie **Create logging configuration** (Protokollierungskonfiguration erstellen) auswählen, wird ein Dialogfenster gezeigt, in dem Sie eine neue Protokollierungskonfiguration erstellen und anpassen können. 1. Geben Sie optional einen **Logging configuration name** (Namen für die Protokollierungskonfiguration) an. Namen von Protokollierungskonfigurationen sind genau wie die Namen von Chatrooms nicht eindeutig, bieten Ihnen jedoch eine Möglichkeit, Protokollierungskonfigurationen von der Protokollierungskonfiguration mit dem ARN zu unterscheiden. 1. Wählen Sie unter **Destination** (Ziel) die Option **CloudWatch log group** (CloudWatch-Protokollgruppe), **Kinesis Firehose Delivery Stream** (Kinesis-Firehose-Bereitstellungs-Stream) oder **Amazon S3 bucket** (Amazon-S3-Bucket) aus, um das Ziel für die Protokolle auszuwählen. 1. Wählen Sie je nach Ziel die Option zum Erstellen einer neuen **CloudWatch log group** (CloudWatch-Protokollgruppe), eines neuen **Kinesis firehose delivery stream** (Kinesis-Firehose-Bereitstellungs-Stream) oder eines neuen **Amazon S3 bucket** (Amazon-S3-Bucket) bzw. zum Verwenden einer vorhandenen Gruppe, eines vorhandenen Streams oder eines vorhandenen Buckets aus. 1. Wählen Sie nach der Überprüfung die Option **Create** (Erstellen) aus, um eine neue Protokollierungskonfiguration mit einer eindeutigen ARN zu erstellen. Dadurch wird die neue Protokollierungskonfiguration automatisch an den Chatroom angefügt. ## Abschließende Raumerstellung 1. Wählen Sie nach der Überprüfung die Option **Create chat room** (Chatroom erstellen) aus, um einen neuen Chatroom mit einer eindeutigen ARN zu erstellen. # CLI-Anweisungen zum Erstellen eines IVS-Chatrooms Dieses Dokument führt Sie durch die Schritte zur Integration des Amazon-IVS-Chatrooms mit der AWS CLI. ## Erstellen eines Chatrooms Das Erstellen eines Chatrooms mit der AWS CLI ist eine erweiterte Option und erfordert, dass Sie zuerst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im [Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). 1. Führen Sie den Chat-`create-room`-Befehl aus und und übergeben Sie einen optionalen Namen: ``` aws ivschat create-room --name test-room ``` 1. Dies gibt einen neuen Chatroom zurück: ``` { "arn": "arn:aws:ivschat:us-west-2:123456789012:room/g1H2I3j4k5L6", "id": "string", "createTime": "2021-06-07T14:26:05-07:00", "maximumMessageLength": 200, "maximumMessageRatePerSecond": 10, "name": "test-room", "tags": {}, "updateTime": "2021-06-07T14:26:05-07:00" } ``` 1. Beachten Sie das Feld `arn`. Sie benötigen dies, um ein Client-Token zu erstellen und eine Verbindung mit einem Chatroom herzustellen. ## Einrichten einer Protokollierungskonfiguration (optional) Das Erstellen eines Chatrooms mit der AWS-CLI ist eine erweiterte Option. Dazu müssen Sie zunächst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im [Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). 1. Führen Sie den Chatbefehl `create-logging-configuration` aus und übergeben Sie einen optionalen Namen und eine Zielkonfiguration, die auf einen Amazon-S3-Bucket verweisen. Dieser Amazon-S3-Bucket muss vor Erstellung der Protokollierungskonfiguration vorhanden sein. (Einzelheiten zum Erstellen eines Amazon-S3-Buckets finden Sie in der [Dokumentation zu Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html).) ``` aws ivschat create-logging-configuration \ --destination-configuration s3={bucketName=demo-logging-bucket} \ --name "test-logging-config" ``` 1. Hierdurch wird eine neue Protokollierungskonfiguration zurückgegeben: ``` { "Arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ", "createTime": "2022-09-14T17:48:00.653000+00:00", "destinationConfiguration": { "s3": {"bucketName": "demo-logging-bucket"} }, "id": "ABcdef34ghIJ", "name": "test-logging-config", "state": "ACTIVE", "tags": {}, "updateTime": "2022-09-14T17:48:01.104000+00:00" } ``` 1. Beachten Sie das Feld `arn`. Dieses wird benötigt, um die Protokollierungskonfiguration an den Chatroom anzufügen. 1. Wenn Sie einen neuen Chatroom erstellen, führen Sie den Befehl `create-room` aus und übergeben Sie die Protokollierungskonfiguration `arn`: ``` aws ivschat create-room --name test-room \ --logging-configuration-identifiers \ "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" ``` 1. Wenn Sie einen vorhandenen Chatroom aktualisieren, führen Sie den Befehl `update-room` aus und übergeben Sie die Protokollierungskonfiguration `arn`: ``` aws ivschat update-room --identifier \ "arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \ --logging-configuration-identifiers \ "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ" ``` # Schritt 3: Erstellen eines Chat-Tokens Damit ein Chat-Teilnehmer eine Verbindung zu einem Raum herstellen und Nachrichten senden und empfangen kann, muss ein Chat-Token erstellt werden. Chat-Token werden verwendet, um Chat-Clients zu authentifizieren und zu autorisieren. Dieses Diagramm veranschaulicht den Arbeitsablauf für die Erstellung eines IVS-Chat-Tokens: ![\[Authentifizieren und autorisieren Sie Ihre Clients für Ihren neu erstellten Chatroom.\]](http://docs.aws.amazon.com/de_de/ivs/latest/ChatUserGuide/images/Chat_Getting_Started_Auth.png) Wie oben gezeigt, fragt eine Client-Anwendung Ihre serverseitige Anwendung nach einem Token, und die serverseitige Anwendung ruft CreateChatToken mithilfe eines AWS-SDK oder signierter [Sigv4-Anfragen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) auf. Da AWS-Anmeldeinformationen zum Aufrufen der API verwendet werden, sollte das Token in einer sicheren serverseitigen Anwendung generiert werden, nicht in der clientseitigen Anwendung. Eine Backend-Serveranwendung, die die Token-Generierung demonstriert, ist im [Amazon-IVS-Chat-Demo-Backend](https://github.com/aws-samples/amazon-ivs-chat-web-demo/tree/main/serverless) verfügbar. *Sitzungsdauer* bezieht sich darauf, wie lange eine etablierte Sitzung aktiv bleiben kann, bevor sie automatisch beendet wird. Das heißt, die Sitzungsdauer entspricht der Zeit, die der Client mit dem Chatroom verbunden bleiben kann, bevor ein neues Token generiert und eine neue Verbindung hergestellt werden muss. Während der Token-Erstellung können Sie wahlweise die Sitzungsdauer angeben. Jedes Token kann nur einmal zum Herstellen einer Verbindung für einen Endbenutzer verwendet werden. Wenn eine Verbindung geschlossen wird, muss ein neues Token erstellt werden, bevor eine Verbindung wiederhergestellt werden kann. Das Token selbst ist bis zu dem in der Antwort enthaltenen Zeitstempel für den Ablauf des Tokens gültig. Wenn ein Endbenutzer eine Verbindung zu einem Chatroom herstellen möchte, sollte der Client die Serveranwendung nach einem Token fragen. Die Serveranwendung erstellt ein Token und gibt es an den Client zurück. Tokens sollten auf Anfrage für Endbenutzer erstellt werden. Befolgen Sie die Anweisungen unten, um ein Chat-Authentifizierungstoken zu erstellen. Wenn Sie ein Chat-Token erstellen, verwenden Sie die Anforderungsfelder, um Daten über den Chat-Endbenutzer und die Messaging-Funktionen des Endbenutzers zu übergeben. Einzelheiten finden Sie unter [CreateChatToken](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_CreateChatToken.html) in der *Referenz für IVS-Chat-API*. ## AWS-SDK-Anweisungen Das Erstellen eines Chat-Tokens mit dem AWS SDK erfordert, dass Sie zuerst das SDK in Ihre Anwendung herunterladen und konfigurieren. Im Folgenden finden Sie Anweisungen für das AWS SDK, das JavaScript verwendet. **Wichtig:** Dieser Code muss serverseitig ausgeführt und seine Ausgabe an den Client übergeben werden. **Voraussetzung**: Um das folgende Codebeispiel verwenden zu können, müssen Sie das AWS JavaScript SDK in Ihre Anwendung laden. Weitere Informationen dazu finden Sie unter [Erste Schritte mit AWS SDK for JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/getting-started.html). ``` async function createChatToken(params) { const ivs = new AWS.Ivschat(); const result = await ivs.createChatToken(params).promise(); console.log("New token created", result.token); } /* Create a token with provided inputs. Values for user ID and display name are from your application and refer to the user connected to this chat session. */ const params = { "attributes": { "displayName": "DemoUser", }", "capabilities": ["SEND_MESSAGE"], "roomIdentifier": "arn:aws:ivschat:us-west-2:123456789012:room/g1H2I3j4k5L6", "userId": 11231234 }; createChatToken(params); ``` ## CLI-Anweisungen Das Erstellen eines Chat-Tokens mit der AWS CLI ist eine erweiterte Option und erfordert, dass Sie zuerst die CLI auf Ihrem Computer herunterladen und konfigurieren. Informationen zu den ersten Schritten finden Sie im [Benutzerhandbuch für die AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html). Hinweis: Das Generieren von Token mit der AWS CLI eignet sich für Testzwecke, aber für die Produktion empfehlen wir Ihnen, Token auf Serverseite mit dem AWS SDK zu generieren (siehe Anweisungen oben). 1. Führen Sie den `create-chat-token`-Befehl zusammen mit Raumkennung und Benutzer-ID für den Client aus. Fügen Sie eine der folgenden Funktionen ein: `"SEND_MESSAGE"`, `"DELETE_MESSAGE"`, `"DISCONNECT_USER"`. (Fügen Sie optional die Sitzungsdauer (in Minuten) und/oder benutzerdefinierte Attribute (Metadaten) zu dieser Chat-Sitzung ein. Diese Felder werden unten nicht angezeigt.) ``` aws ivschat create-chat-token --room-identifier "arn:aws:ivschat:us-west-2:123456789012:room/g1H2I3j4k5L6" --user-id "11231234" --capabilities "SEND_MESSAGE" ``` 1. Dies gibt ein Client-Token zurück: ``` { "token": "abcde12345FGHIJ67890_klmno1234PQRS567890uvwxyz1234.abcd12345EFGHI67890_jklmno123PQRS567890uvwxyz1234abcde12345FGHIJ67890_klmno1234PQRS567890uvwxyz1234abcde", "sessionExpirationTime": "2022-03-16T04:44:09+00:00", "tokenExpirationTime": "2022-03-16T03:45:09+00:00" } ``` 1. Speichern Sie dieses Token. Sie benötigen es, um eine Verbindung mit dem Chatroom herzustellen und Nachrichten zu senden oder zu empfangen. Sie müssen ein weiteres Chat-Token generieren, bevor Ihre Sitzung endet (wie durch `sessionExpirationTime` angegeben). # Schritt 4: Senden und Empfangen Ihrer ersten Nachricht Verwenden Sie Ihr Chat-Token, um eine Verbindung zu einem Chatroom herzustellen und Ihre erste Nachricht zu senden. Nachstehend finden Sie einen beispielhaften JavaScript-Code. IVS-Client-SDKs sind ebenfalls verfügbar: siehe [Chat-SDK: Handbuch für Android](chat-sdk-android.md), [Chat-SDK: Handbuch für iOS](chat-sdk-ios.md) und [Chat-SDK: Handbuch für JavaScript](chat-sdk-js.md). **Regionaler Service:** Der folgende Beispielcode bezieht sich auf Ihre „unterstützte Region Ihrer Wahl“. Amazon IVS Chat bietet regionale Endpunkte, über die Sie Ihre Anforderungen stellen können. Für die Amazon-IVS-Chat-Messaging-API lautet die allgemeine Syntax eines regionalen Endpunkts: + wss://edge.ivschat..amazonaws.com Zum Beispiel ist wss://edge.ivschat.us-west-2.amazonaws.com der Endpunkt in der Region USA West (Oregon). Eine Liste der unterstützten Regionen finden Sie in den Amazon-IVS-Chat-Informationen auf der [Amazon-IVS-Seite](https://docs.aws.amazon.com/general/latest/gr/ivs.html) in der *Allgemeinen AWS-Referenz*. ``` /* 1. To connect to a chat room, you need to create a Secure-WebSocket connection using the client token you created in the previous steps. Use one of the provided endpoints in the Chat Messaging API, depending on your AWS region. */ const chatClientToken = "GENERATED_CHAT_CLIENT_TOKEN_HERE"; const socket = "wss://edge.ivschat.us-west-2.amazonaws.com"; // Replace “us-west-2” with supported region of choice. const connection = new WebSocket(socket, chatClientToken); /* 2. You can send your first message by listening to user input in the UI and sending messages to the WebSocket connection. */ const payload = { "Action": "SEND_MESSAGE", "RequestId": "OPTIONAL_ID_YOU_CAN_SPECIFY_TO_TRACK_THE_REQUEST", "Content": "text message", "Attributes": { "CustomMetadata": "test metadata" } } connection.send(JSON.stringify(payload)); /* 3. To listen to incoming chat messages from this WebSocket connection and display them in your UI, you must add some event listeners. */ connection.onmessage = (event) => { const data = JSON.parse(event.data); displayMessages({ display_name: data.Sender.Attributes.DisplayName, message: data.Content, timestamp: data.SendTime }); } function displayMessages(message) { // Modify this function to display messages in your chat UI however you like. console.log(message); } /* 4. Delete a chat message by sending the DELETE_MESSAGE action to the WebSocket connection. The connected user must have the "DELETE_MESSAGE" permission to perform this action. */ function deleteMessage(messageId) { const deletePayload = { "Action": "DELETE_MESSAGE", "Reason": "Deleted by moderator", "Id": "${messageId}" } connection.send(deletePayload); } ``` Herzlichen Glückwunsch, Sie sind fertig\$1 Sie haben jetzt eine einfache Chat-Anwendung, die Nachrichten senden oder empfangen kann. # Schritt 5: Überprüfen Ihre Service-Quota-Limits (optional) Ihre Chatrooms werden zusammen mit Ihrem Amazon-IVS-Live-Stream skaliert, damit alle Ihre Zuschauer Chat-Gespräche führen können. Alle Amazon-IVS-Konten haben jedoch Beschränkungen für die Anzahl der gleichzeitigen Chat-Teilnehmer und die Rate der Nachrichtenzustellung. *Stellen Sie sicher, dass Ihre Limits angemessen sind und fordern Sie bei Bedarf eine Erhöhung an, insbesondere wenn Sie ein großes Streaming-Event planen*. Weitere Informationen finden Sie unter [Service Quotas (Streaming mit niedriger Latenz),](https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/service-quotas.html) [Service Quotas (Echtzeit-Streaming)](https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/service-quotas.html) und [Service Quotas (Chat)](service-quotas.md).