Diffusion de données de messagerie dans la messagerie du SDK Amazon Chime - Kit SDK Amazon Chime

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.

Diffusion de données de messagerie dans la messagerie du SDK Amazon Chime

Vous pouvez configurer un AppInstance pour recevoir des données, telles que des messages et des événements de canal, sous la forme d'un flux. Vous pouvez ensuite réagir à ces données en temps réel. Actuellement, la messagerie du SDK Amazon Chime accepte uniquement les flux Kinesis comme destinations de flux. Pour utiliser les flux Kinesis avec cette fonctionnalité, vous devez remplir les conditions suivantes :

  • Les flux Kinesis doivent être enregistrés sur le même AWS compte que le. AppInstance

  • Un flux doit se trouver dans la même région que leAppInstance.

  • Les noms de flux ont un préfixe qui commence chime-messaging- par.

  • Vous devez configurer au moins deux partitions. Chaque partition peut recevoir des données jusqu'à 1 Mo par seconde, alors adaptez votre flux en conséquence.

  • Vous devez activer le chiffrement côté serveur (SSE).

Pour configurer un flux Kinesis

  1. Créez un ou plusieurs flux Kinesis à l'aide des prérequis décrits dans la section précédente, puis obtenez l'ARN. Assurez-vous que l'appelant dispose des autorisations Kinesis en plus des autorisations Amazon Chime.

    Les exemples suivants montrent comment utiliser la AWS CLI pour créer un flux Kinesis avec deux partitions et comment activer SSE.

    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. Configurez le streaming en appelant l'PutMessagingStreamingConfigurationsAPI.

    Vous pouvez configurer l'un des deux types de données ou les deux, et vous pouvez choisir le même flux ou des flux distincts pour eux.

    Les exemples suivants montrent comment utiliser la AWS CLI pour configurer et appinstance diffuser les types de Channel données ChannelMessage et.

    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

    Les types de données ont les champs d'application suivants :

    DataType Types d'événements générés

    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. Commencez à lire les données de votre flux Kinesis configuré.

    Note

    Les événements envoyés avant de configurer le streaming ne sont pas envoyés vers votre flux Kinesis.

Format de données

Kinesis génère des enregistrements au format JSON avec les champs suivants : EventType et. Payload Le format de charge utile dépend duEventType. Le tableau suivant répertorie les types d'événements et les formats de charge utile correspondants.

EventType Format de données utiles

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