쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

Amazon Chime SDK 메시징에서 메시징 데이터 스트리밍

포커스 모드
Amazon Chime SDK 메시징에서 메시징 데이터 스트리밍 - Amazon Chime SDK

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

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

  • 스트림은 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. PutMessagingStreamingConfigurations API를 직접 호출하여 스트리밍을 구성합니다.

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

    다음 예는 AWS CLI를 사용하여 ChannelMessageChannel 데이터 유형을 스트리밍하도록 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

    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. 구성된 Kinesis 스트림에서 데이터 읽기를 시작합니다.

    참고

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

데이터 형식

키네시스는 EventTypePayload 필드가 포함된 JSON 형식의 레코드를 출력합니다. 페이로드 형식은 EventType에 따라 달라집니다. 다음 표에는 이벤트 유형과 해당 페이로드 형식이 나열되어 있습니다.

EventType 페이로드 형식

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

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.