메시지 구조에 대한 이해

받는 모든 WebSocket 메시지는 다음 형식을 준수합니다.

{
   "Headers": {"key": "value"},
   "Payload": "{\"key\": \"value\"}"
}

헤더

Amazon Chime SDK 메시징은 다음 헤더 키를 사용합니다.

• x-amz-chime-event-type

• x-amz-chime-message-type

• x-amz-chime-event-reason

다음 섹션에서는 헤더의 가능한 값과 페이로드를 나열하고 설명합니다.

Payload

웹소켓 메시지는 JSON 문자열을 반환합니다. JSON 문자열의 구조는 x-amz-event-type 헤더에 따라 달라집니다. 다음 표에는 가능한 x-amz-chime-event-type 값과 페이로드가 나와 있습니다.

EventType	페이로드 포맷
SESSION_ESTABLISHED	해당 없음. 이 메시지는 사용자가 에 연결한 후 한 번 전송됩니다. WebSocket 이는 사용자가 메시지를 받은 후 도착하는 채널의 모든 SESSION_ESTABLISHED 메시지 또는 이벤트가 WebSocket 열려 있는 한 사용자에게 확실히 전달된다는 것을 나타냅니다.
CREATE_CHANNEL_MESSAGE	ChannelMessage
REDACT_CHANNEL_MESSAGE
UPDATE_CHANNEL_MESSAGE
DELETE_CHANNEL_MESSAGE
PENDING_CREATE_CHANNEL_MESSAGE
PENDING_UPDATE_CHANNEL_MESSAGE
FAILED_CREATE_CHANNEL_MESSAGE
FAILED_UPDATE_CHANNEL_MESSAGE
DENIED_CREATE_CHANNEL_MESSAGE
DENIED_UPDATE_CHANNEL_MESSAGE
CHANNEL_DETAILS	Channel ChannelSummary 객체입니다. ChannelMessages ChannelMessageSummary객체 목록 (내림차순 정렬 CreatedTimestamp 기준) 최신 메시지 20개가 포함되지만 AWS 계정 수준에서 해당 한도를 조정할 수 있습니다. ChannelMemberships ChannelMembershipSummary 객체의 목록입니다. 최대 30명의 채널 회원을 반환하지만 AWS 계정 수준에서 해당 한도를 조정할 수 있습니다. ReadMarkerTimestamp AppInstanceUser마지막으로 채널을 읽은 상태로 표시한 시간입니다.
UPDATE_CHANNEL	채널
DELETE_CHANNEL
BATCH_CREATE_CHANNEL_MEMBERSHIP	BatchChannelMembership
CREATE_CHANNEL_MEMBERSHIP	ChannelMembership
DELETE_CHANNEL_MEMBERSHIP
UPDATE_CHANNEL_MEMBERSHIP

x-amz-chime-message-타입

다음 표에는 x-amz-chime-message-type 메시지 유형이 나와 있습니다.

메시지 유형	설명
STANDARD	웹 소켓이 STANDARD 채널 메시지를 수신할 때 전송됩니다.
CONTROL	CONTROL 채널 메시지를 WebSocket 받을 때 전송됩니다.
SYSTEM	아마존 차임 SDK 메시징에서 전송한 기타 모든 웹소켓 메시지.

x-amz-chime-event-이유

특정 사용 사례에 지원되는 선택적 헤더입니다. 헤더는 특정 이벤트가 수신된 이유에 대한 정보를 제공합니다.

이벤트 사유	설명
서브채널_삭제됨	DELETE_CHANNEL_MEMBERSHIP엘라스틱 채널 운영자가 수신한 이벤트. 멤버십 밸런싱으로 인해 자신이 속했던 하위 채널이 삭제된 후에만 운영자가 볼 수 있습니다.