Transmisión de datos de mensajerí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 del SDK de Amazon Chime 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"

2. Configure la transmisión llamando a la PutMessagingStreamingConfigurationsAPI.

   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:

   DataType	Tipos de eventos generados
   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. 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.

EventType	Formato de cargas
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