업그레이드 가이드¶

이 페이지에서는 SDK 버전별로 채팅 기능 모든 변경 사항과 더 이상 지원하지 않는 항목을 안내합니다. 내용을 참고하여 채팅 연동을 최신 버전에 맞게 원활하게 업그레이드할 수 있습니다.

SDK 26.4.0¶

신규 이벤트 onConnectStarted, onConnectCompleted를 추가합니다. onConnectStarted, onConnectCompleted 이벤트는 기존 Chat.reconnect 이벤트 onReconnectStarted, onReconnected를 대체합니다. 이제 채팅 연결을 자동 재시도할 때에는 onConnectStarted, onConnectCompleted 이벤트를 전달합니다.
- onConnectStarted 이벤트는 채팅 연결을 시도할 때 발생합니다.
- onConnectCompleted 이벤트는 채팅 연결 결과를 전달하는 이벤트입니다. 채팅 연결 상태가 성공이든 실패이든 연결 결과를 그대로 전달합니다. onConnectCompleted 이벤트는 onReconnected 이벤트를 대체하므로, onConnectCompleted 이벤트 결과를 바탕으로 채팅 연결 성공 또는 실패 시 작업을 수행하도록 구현해야합니다.

(지원 종료 예정) Chat 클래스의 reconnect 메서드를 지원하지 않습니다.
- 기존 수동 재연결 요청 기능은 Chat.connect 메서드로 대체합니다.
(지원 종료 예정) onReconnectStarted, onReconnected 이벤트를 지원하지 않습니다. onReconnected 이벤트가 전달하던 입장 성공한 채널 목록과 입장 실패한 채널 목록은 빈 배열로 제공됩니다.
(지원 종료 예정) onConnected 이벤트를 지원하지 않습니다. 이 이벤트 대신 onConnectCompleted 이벤트를 사용해 연결 성공 또는 실패 시 작업을 수행하도록 구현해야합니다.

Warning

지원 종료 예정 기능은 차기 버전부터 지원을 완전히 제거할 예정입니다. 따라서 사용을 권장하지 않으며 다른 기능으로 대체하세요.

SDK 25.8.0 Windows 버전부터 채팅 기능을 지원합니다.
- Steam Deck 환경에서는 현재 채팅 기능을 지원하지 않습니다(추후 지원 예정).

채널 메시지 조회 방식이 최신 메시지 기준에서 특정 메시지 ID 전후 범위로 변경되었습니다.
- 모든 메시지 객체 내 메시지 고유 식별자를 나타내는 메시지 아이디가 추가되었습니다.
- ChannelMessageListQueryParams 클래스가 변경되었습니다. 기존 동작을 유지하려면 messageId를 null로 설정하고, size와 동일한 값을 prevSize에 지정하세요.

Chat 클래스의 addConnectionListener 메서드로 등록된 리스너 이벤트에 다음과 같은 변경 사항이 적용되었습니다.
- onReconnectStarted 이벤트를 새롭게 추가했습니다. Chat 클래스의 reconnect API 호출 또는 내부적으로 상태 변화를 감지해 채팅 연결을 자동 재시도할 때 호출됩니다.
- onReconnected 이벤트에 결과 정보를 담은 ResultAPI 객체가 추가되었습니다.

Chat 클래스의 addDirectMessageListener 및 removeDirectMessageListener 메서드는 더 이상 지원되지 않습니다. 기존 1:1 메시지 수신 기능은 Chat 클래스의 addUserListener 및 removeUserListener 메서드를 통해 처리할 수 있습니다.