IVS 챗 클라이언트 메시징 SDK - Amazon IVS
플랫폼 요구 사항지원Amazon IVS Chat API

IVS 챗 클라이언트 메시징 SDK

Amazon Interactive Video Service(IVS) Chat Client Messaging SDK는 Amazon IVS로 애플리케이션을 구축하는 개발자를 위한 것입니다. 이 SDK는 Amazon IVS 아키텍처를 활용하도록 설계되었으며 Amazon IVS Chat과 함께 업데이트가 제공되고 있습니다. 이 기본 SDK는 애플리케이션 및 사용자가 애플리케이션에 액세스하는 데 사용하는 디바이스에 미치는 성능 영향을 최소화하도록 설계되었습니다.

플랫폼 요구 사항

데스크톱 브라우저

브라우저 지원되는 버전
Chrome 두 가지 주요 버전(현재 및 최신 이전 버전)
Edge 두 가지 주요 버전(현재 및 최신 이전 버전)
Firefox 두 가지 주요 버전(현재 및 최신 이전 버전)
Opera 두 가지 주요 버전(현재 및 최신 이전 버전)
Safari 두 가지 주요 버전(현재 및 최신 이전 버전)

모바일 브라우저

브라우저 지원되는 버전
Android용 Chrome 두 가지 주요 버전(현재 및 최신 이전 버전)
Android용 Firefox 두 가지 주요 버전(현재 및 최신 이전 버전)
Android용 Opera 두 가지 주요 버전(현재 및 최신 이전 버전)
WebView Android 두 가지 주요 버전(현재 및 최신 이전 버전)
삼성 인터넷 두 가지 주요 버전(현재 및 최신 이전 버전)
iOS용 Safari 두 가지 주요 버전(현재 및 최신 이전 버전)

기본 플랫폼

플랫폼 지원되는 버전
Android 5.0 이상
iOS

13.0 이상

지원

채팅 룸에서 오류나 기타 문제가 발생하면 IVS 챗 API를 통해 고유한 채팅 룸 식별자를 확인합니다(ListRooms 참조).

이 채팅룸 식별자를 AWS Support와 공유합니다. 이를 통해 문제를 해결하는 데 도움이 되는 정보를 얻을 수 있습니다.

참고: Amazon IVS Chat 릴리스 정보를 참조하여 사용 가능한 버전 및 해결된 문제를 확인하세요. 해당하는 경우 Support에 문의하기 전에 SDK 버전을 업데이트하고 문제가 해결되는지 확인합니다.

버저닝

Amazon IVS Chat Client Messaging SDK는 유의적 버전 관리를 사용합니다.

이를 설명하기 위해 다음을 가정합니다.

  • 최신 릴리스는 버전 4.1.3입니다.

  • 이전 주요 버전의 최신 릴리스는 3.2.4입니다.

  • 버전 1.x의 최신 릴리스는 1.5.6입니다.

이전 버전과 호환되는 새 기능은 최신 버전의 마이너 릴리스로 추가됩니다. 이 경우 새 기능의 다음 집합이 버전 4.2.0으로 추가됩니다.

이전 버전과 호환되는 마이너 버그 수정은 최신 버전의 패치 릴리스로 추가됩니다. 여기서 마이너 버그의 다음 수정 집합은 버전 4.1.4로 추가됩니다.

이전 버전과 호환되는 메이저 버그 수정은 다르게 처리됩니다. 이러한 버그 수정은 다음과 같이 여러 버전에 추가됩니다.

  • 최신 버전의 패치 릴리스에 추가되는 경우. 이 경우 버전 4.1.4입니다.

  • 이전 마이너 버전의 패치 릴리스에 추가되는 경우. 이 경우 버전 3.2.5입니다.

  • 최신 버전 1.x 릴리스의 패치 릴리스에 추가되는 경우. 이 경우 버전 1.5.7입니다.

메이저 버그 수정은 Amazon IVS 제품 팀에서 정의합니다. 일반적인 예로는 중요한 보안 업데이트와 고객에게 필요한 기타 수정이 있습니다.

참고: 위의 예에서 릴리스된 버전은 숫자가 차례대로 높아집니다(예: 4.1.3에서 4.1.4). 실제로는 하나 이상의 패치 번호가 내부에 남고 릴리스되지 않을 수 있으므로, 예를 들어 릴리스된 버전은 4.1.3에서 4.1.6으로 증가할 수 있습니다.

또한, 버전 1.x는 2023년 말까지 또는 3.x가 릴리스될 때까지 중 더 나중에 도래하는 시점에 지원됩니다.

Amazon IVS Chat API

서버 측(SDK에서 관리하지 않음)에는 각각 고유한 책임이 있는 두 가지 API가 있습니다.

  • 데이터 영역 - IVS 챗 메시징 API는 토큰 기반 인증 체계를 통해 구동되는 프런트엔드 애플리케이션(iOS, Android, macOS 등)에서 사용하도록 설계된 WebSocket API입니다. 이전에 생성된 채팅 토큰을 사용하여 이 API를 사용하는 기존 채팅 룸에 연결할 수 있습니다.

    Amazon IVS Chat Client Messaging SDK는 데이터 영역에만 관련됩니다. SDK에서는 사용자가 이미 백엔드를 통해 채팅 토큰을 생성하고 있다고 가정합니다. 이러한 토큰의 검색은 SDK가 아닌 프런트엔드 애플리케이션에서 관리하는 것으로 간주됩니다.

  • 컨트롤 플레인 - IVS 챗 Control Plane API는 고유한 백엔드 애플리케이션에 대한 인터페이스를 제공하여 채팅 룸과 채팅 룸에 참여하는 사용자를 관리하고 만들 수 있습니다. 자체 백엔드에서 관리하는 앱의 채팅 환경에 대한 관리자 패널로 생각하면 됩니다. 데이터 영역이 채팅 룸을 인증하는 데 필요로 하는 채팅 토큰 생성을 담당하는 컨트롤 플레인 작업이 있습니다.

    중요: IVS 챗 Client Messaging SDK는 컨트롤 플레인 작업을 호출하지 않습니다. 채팅 토큰을 만들려면 백엔드를 설정해야 합니다. 이 채팅 토큰을 검색하려면 프런트엔드 애플리케이션이 백엔드와 통신해야 합니다.