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.
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. À l'heure actuelle, la messagerie du SDK Amazon Chime n'accepte que les flux Kinesis comme destinations de diffusion. 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 le
AppInstance. -
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
-
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-namechime-messaging-unique-name--shard-count2aws kinesis start-stream-encryption --stream-namechime-messaging-unique-name--encryption-type KMS --key-id "alias/aws/kinesis" -
Configurez le streaming en appelant le 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 ces deux types de données.
Les exemples suivants montrent comment utiliser la AWS CLI pour configurer et
appinstancediffuser les types deChanneldonnéesChannelMessageet.aws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arnapp_instance_arn\ --streaming-configurations DataType=ChannelMessage,ResourceArn=kinesis_data_stream_arnaws chime-sdk-messaging put-messaging-streaming-configurations --app-instance-arnapp_instance_arn\ --streaming-configurations DataType=Channel,ResourceArn=kinesis_data_stream_arnLes types de données ont les champs d'application suivants :
DataTypeTypes d'événements générés CREATE_CHANNEL_MESSAGEREDACT_CHANNEL_MESSAGEUPDATE_CHANNEL_MESSAGEDELETE_CHANNEL_MESSAGECREATE_CHANNELCREATE_SUB_CHANNELUPDATE_CHANNELDELETE_CHANNELUPDATE_CHANNEL_EXPIRATION_SETTINGSDELETE_SUB_CHANNELCREATE_CHANNEL_MEMBERSHIPDELETE_CHANNEL_MEMBERSHIPCREATE_CHANNEL_BANDELETE_CHANNEL_BANCREATE_CHANNEL_MODERATORDELETE_CHANNEL_MODERATOR -
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 charge utile |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
