Streaming-Messaging-Daten in Amazon Chime SDK-Messaging - Amazon Chime SDK

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.

Streaming-Messaging-Daten in Amazon Chime SDK-Messaging

Sie können ein so konfigurieren, AppInstance dass es Daten wie Nachrichten und Kanalereignisse in Form eines Streams empfängt. Sie können dann in Echtzeit auf diese Daten reagieren. Derzeit akzeptiert Amazon Chime SDK-Messaging nur Kinesis-Streams als Stream-Ziele. Sie müssen die folgenden Voraussetzungen erfüllen, um Kinesis-Streams mit dieser Funktion verwenden zu können:

  • Kinesis-Streams müssen sich im selben AWS Konto befinden wie dieAppInstance.

  • Ein Stream muss sich in derselben Region befinden wie derAppInstance.

  • Stream-Namen haben ein Präfix, das mit beginntchime-messaging-.

  • Sie müssen mindestens zwei Shards konfigurieren. Jeder Shard kann Daten bis zu 1 MB pro Sekunde empfangen. Skalieren Sie Ihren Stream also entsprechend.

  • Sie müssen die serverseitige Verschlüsselung (SSE) aktivieren.

So konfigurieren Sie einen Kinesis-Stream

  1. Erstellen Sie einen oder mehrere Kinesis-Streams unter Verwendung der Voraussetzungen im vorherigen Abschnitt und rufen Sie dann den ARN ab. Stellen Sie sicher, dass der Anrufer zusätzlich zu den Amazon Chime Chime-Berechtigungen auch über Kinesis-Berechtigungen verfügt.

    Die folgenden Beispiele zeigen, wie Sie mit der AWS CLI einen Kinesis-Stream mit zwei Shards erstellen und SSE aktivieren.

    aws kinesis create-stream --stream-name chime-messaging-unique-name --shard-count 2

    aws kinesis start-stream-encryption --stream-name chime-messaging-unique-name --encryption-type KMS --key-id "alias/aws/kinesis"

  2. Konfigurieren Sie das Streaming, indem Sie die PutMessagingStreamingConfigurationsAPI aufrufen.

    Sie können einen oder beide von zwei Datentypen konfigurieren und für sie denselben Stream oder separate Streams auswählen.

    Die folgenden Beispiele zeigen, wie Sie die AWS CLI verwenden, um die Channel Datentypen appinstance zu konfigurieren ChannelMessage und zu streamen.

    aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
--streaming-configurations DataType=ChannelMessage,ResourceArn=kinesis_data_stream_arn
    aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arn app_instance_arn \
--streaming-configurations DataType=Channel,ResourceArn=kinesis_data_stream_arn

    Die Datentypen haben die folgenden Bereiche:

    DataType Generierte Ereignistypen

    ChannelMessage

    CREATE_CHANNEL_MESSAGE

    REDACT_CHANNEL_MESSAGE

    UPDATE_CHANNEL_MESSAGE

    DELETE_CHANNEL_MESSAGE

    Channel

    CREATE_CHANNEL

    CREATE_SUB_CHANNEL

    UPDATE_CHANNEL

    DELETE_CHANNEL

    UPDATE_CHANNEL_EXPIRATION_SETTINGS

    DELETE_SUB_CHANNEL

    CREATE_CHANNEL_MEMBERSHIP

    DELETE_CHANNEL_MEMBERSHIP

    CREATE_CHANNEL_BAN

    DELETE_CHANNEL_BAN

    CREATE_CHANNEL_MODERATOR

    DELETE_CHANNEL_MODERATOR

  3. Beginnen Sie mit dem Lesen der Daten aus Ihrem konfigurierten Kinesis-Stream.

    Anmerkung

    Ereignisse, die vor der Streaming-Konfiguration gesendet wurden, werden nicht an Ihren Kinesis-Stream gesendet.

Data format (Datenformat)

Kinesis gibt Datensätze im JSON-Format mit den folgenden Feldern aus: EventType undPayload. Das Payload-Format hängt von der ab. EventType In der folgenden Tabelle sind die Ereignistypen und ihre entsprechenden Payload-Formate aufgeführt.

EventType Nutzdatenformat

CREATE_CHANNEL_MESSAGE

Channel message

REDACT_CHANNEL_MESSAGE

UPDATE_CHANNEL_MESSAGE

DELETE_CHANNEL_MESSAGE

CREATE_CHANNEL

Channel

UPDATE_CHANNEL

DELETE_CHANNEL

UPDATE_CHANNEL_EXPIRATION_SETTINGS

CREATE_CHANNEL_MEMBERSHIP

ChannelMembership

DELETE_CHANNEL_MEMBERSHIP

CREATE_CHANNEL_BAN

ChannelBan

DELETE_CHANNEL_BAN

CREATE_CHANNEL_MODERATOR

ChannelModerator

DELETE_CHANNEL_MODERATOR

CREATE_SUB_CHANNEL

channelARN

SubChannelId

DELETE_SUB_CHANNEL