Dati di messaggistica in streaming - SDK Amazon Chime

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Dati di messaggistica in streaming

Puoi configurare e AppInstance ricevere dati, come messaggi ed eventi del canale, sotto forma di stream. È quindi possibile reagire a tali dati in tempo reale. Attualmente, la messaggistica Amazon Chime SDK accetta solo stream Kinesis come destinazioni di streaming. È necessario disporre dei seguenti prerequisiti per utilizzare gli stream Kinesis con questa funzionalità:

  • Gli stream Kinesis devono trovarsi nello stesso AWS account di. AppInstance

  • Uno stream deve trovarsi nella stessa regione di. AppInstance

  • I nomi degli stream hanno un prefisso che inizia conchime-messaging-.

  • È necessario configurare almeno due shard. Ogni shard può ricevere dati fino a 1 MB al secondo, quindi ridimensiona lo streaming di conseguenza.

  • È necessario abilitare la crittografia lato server (SSE).

Per configurare uno stream Kinesis

  1. Crea uno o più stream Kinesis utilizzando i prerequisiti nella sezione precedente, quindi ottieni l'ARN. Assicurati che il chiamante disponga delle autorizzazioni Kinesis oltre alle autorizzazioni Amazon Chime.

    Gli esempi seguenti mostrano come utilizzare la AWS CLI per creare uno stream Kinesis con due shard e come abilitare 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. Configura lo streaming chiamando l'API. PutMessagingStreamingConfigurations

    Puoi configurare uno o entrambi i due tipi di dati e puoi scegliere lo stesso flusso o flussi separati per essi.

    Gli esempi seguenti mostrano come utilizzare la AWS CLI per configurare e trasmettere in streaming appinstance i tipi di Channel dati ChannelMessage e.

    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

    I tipi di dati hanno i seguenti ambiti:

    DataType Tipi di eventi generati

    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. Inizia a leggere i dati dallo stream Kinesis configurato.

    Nota

    Gli eventi inviati prima della configurazione dello streaming non vengono inviati allo stream Kinesis.

Formato dei dati

Kinesis genera i record in formato JSON con i seguenti campi: e. EventType Payload Il formato del payload dipende da. EventType La tabella seguente elenca i tipi di eventi e i formati di payload corrispondenti.

EventType Formato del payload

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