Transmisión de datos de mensajería en la mensajería de Amazon Chime SDK - Amazon Chime SDK

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

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"

  2. Configure la transmisión llamando a la API PutMessagingStreamingConfigurations.

    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