Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Transmisión de datos de mensajería en la mensajería de Amazon Chime SDK
<a name="streaming-export"></a>

Puede configurar una `AppInstance` para recibir datos, como mensajes y eventos del canal, en forma de transmisión. A continuación, puede reaccionar a esos datos en tiempo real. Actualmente, la mensajería de Amazon Chime SDK solo acepta transmisiones de Kinesis como destinos de transmisión. Debe cumplir estos requisitos previos para utilizar las transmisiones de Kinesis con esta característica:
+ Las transmisiones de Kinesis deben estar en la misma AWS cuenta que. `AppInstance`
+ La transmisión debe estar en la misma región que `AppInstance`.
+ Los nombres de las transmisiones tienen un prefijo que comienza por `chime-messaging-`.
+ Debe configurar al menos dos particiones. Cada partición puede recibir datos de hasta 1 MB por segundo, así que escale la transmisión en consecuencia.
+ Debe habilitar el cifrado del servidor (SSE).

**Para configurar una transmisión de Kinesis**

1. Cree una o más transmisiones de Kinesis con los requisitos previos de la sección anterior y, a continuación, obtenga el ARN. Asegúrese de que la persona que llama tenga permisos de Kinesis además de los permisos de Amazon Chime.

   Los siguientes ejemplos muestran cómo usar la AWS CLI para crear una transmisión de Kinesis con dos fragmentos y cómo habilitar 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. Configure la transmisión llamando a la API [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).

   Puede configurar uno o ambos tipos de datos, y puede elegir el mismo flujo o flujos separados para ellos.

   Los siguientes ejemplos muestran cómo usar la AWS CLI para configurar y `appinstance` transmitir los tipos de `Channel` datos `ChannelMessage` y.

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

   Los tipos de datos tienen los siguientes ámbitos:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/streaming-export.html)

1. Comience a leer los datos de la transmisión de Kinesis configurada.
**nota**  
Los eventos enviados antes de configurar la transmisión no se envían a su transmisión de Kinesis.

**Formato de los datos**  
Kinesis genera registros en formato JSON con los siguientes campos: `EventType` y `Payload`. El formato de carga útil depende de `EventType`. En la siguiente tabla se enumeran los tipos de eventos y sus correspondientes formatos de carga.


<table>
<thead>
  <tr><th>EventType</th><th>Formato de cargas</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></tr>
  <tr><td>`REDACT_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`UPDATE_CHANNEL_MESSAGE`</td></tr>
  <tr><td>`DELETE_CHANNEL_MESSAGE`</td></tr>
  <tr><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></tr>
  <tr><td>`UPDATE_CHANNEL`</td></tr>
  <tr><td>`DELETE_CHANNEL`</td></tr>
  <tr><td>`UPDATE_CHANNEL_EXPIRATION_SETTINGS`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_MEMBERSHIP`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_BAN`</td></tr>
  <tr><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></tr>
  <tr><td>`DELETE_CHANNEL_MODERATOR`</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></tr>
  <tr><td>`DELETE_SUB_CHANNEL`</td></tr>
</tbody>
</table>