스트리밍 메시징 데이터

메시지 및 채널 이벤트와 같은 데이터를 스트림 형태로 AppInstance 수신하도록 구성할 수 있습니다. 그러면 해당 데이터에 실시간으로 반응할 수 있습니다. 현재 Amazon Chime SDK 메시징은 Kinesis 스트림만 스트림 대상으로 허용합니다. 이 기능과 함께 Kinesis 스트림을 사용하려면 다음과 같은 사전 요구 사항이 있어야 합니다.

• Kinesis 스트림은 과 동일한 AWS 계정에 있어야 합니다. AppInstance

• 스트림은 과 동일한 지역에 있어야 합니다AppInstance.

• 스트림 이름에는 로 chime-messaging- 시작하는 접두사가 있습니다.

• 최소 두 개의 샤드를 구성해야 합니다. 각 샤드는 초당 최대 1MB의 데이터를 수신할 수 있으므로 그에 따라 스트림을 확장하세요.

• 서버측 암호화 (SSE) 를 활성화해야 합니다.

Kinesis 스트림을 구성하려면

1. 이전 섹션의 사전 요구 사항을 사용하여 하나 이상의 Kinesis 스트림을 생성한 다음 ARN을 가져옵니다. 발신자에게 Amazon Chime 권한 외에도 Kinesis 권한이 있는지 확인하십시오.

   다음 예제는 AWS CLI를 사용하여 샤드 2개가 포함된 Kinesis 스트림을 만드는 방법과 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. PutMessagingStreamingConfigurationsAPI를 호출하여 스트리밍을 구성합니다.

   두 가지 데이터 유형 중 하나 또는 둘 다를 구성할 수 있으며, 이에 대해 동일한 스트림 또는 별도의 스트림을 선택할 수 있습니다.

   다음 예제는 AWS CLI를 사용하여 ChannelMessage 및 Channel 데이터 유형을 appinstance 스트리밍하도록 구성하는 방법을 보여줍니다.

   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

   데이터 유형에는 다음과 같은 범위가 있습니다.

   DataType	생성된 이벤트 유형
   ChannelMessage	CREATE_CHANNEL_MESSAGE
   	REDACT_CHANNEL_MESSAGE
   	UPDATE_CHANNEL_MESSAGE
   	DELETE_CHANNEL_MESSAGE
   채널	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. 구성된 Kinesis 스트림에서 데이터 읽기를 시작합니다.

   참고

   스트리밍을 구성하기 전에 전송된 이벤트는 Kinesis 스트림으로 전송되지 않습니다.

Data format(데이터 형식)

Kinesis는 다음 EventType 필드와 함께 JSON 형식으로 레코드를 출력합니다. Payload 페이로드 형식은 에 따라 EventType 달라집니다. 다음 표에는 이벤트 유형과 해당 페이로드 형식이 나와 있습니다.

EventType	페이로드 포맷
CREATE_CHANNEL_MESSAGE	채널 메시지
REDACT_CHANNEL_MESSAGE
UPDATE_CHANNEL_MESSAGE
DELETE_CHANNEL_MESSAGE
CREATE_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	채널 런 SubChannelId
DELETE_SUB_CHANNEL