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
<a name="streaming-export"></a>

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**

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"`

1. Configurez le streaming en appelant l'[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_PutMessagingStreamingConfigurations.html)API.

   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 `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 :    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/chime-sdk/latest/dg/streaming-export.html)

1. 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 du`EventType`. Le tableau suivant répertorie les types d'événements et les formats de charge utile correspondants.


<table>
<thead>
  <tr><th>EventType</th><th>Format de données utiles</th><th></th></tr>
</thead>
<tbody>
  <tr><td>`CREATE_CHANNEL_MESSAGE`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMessage.html) </td><td></td></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL`</td><td rowspan="4"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_Channel.html) </td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL`</td><td></td></tr>
  <tr><td>`DELETE_CHANNEL`</td><td></td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MEMBERSHIP`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelMembership.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_BAN`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelBan.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td><td></td></tr>
  <tr><td></td><td></td><td></td></tr>
  <tr><td>`CREATE_CHANNEL_MODERATOR`</td><td rowspan="2"> [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ChannelModerator.html) </td><td></td></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</td><td></td></tr>
  <tr><td>`CREATE_SUB_CHANNEL`</td><td rowspan="2">[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_ListSubChannels.html#API_messaging-chime_ListSubChannels_RequestSyntax)<br />[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_messaging-chime_SubChannelSummary.html#chimesdk-Type-messaging-chime_SubChannelSummary-SubChannelId)</td><td></td></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td><td></td></tr>
</tbody>
</table>