28. 카카오 길드 채팅

 

 

카카오톡 오픈채팅 기반에 동작하는 게임용 길드채팅입니다.




길드채팅이란? 

카카오톡 오픈채팅 API를 활용한 카카오게임 SDK의 소셜 그룹 채팅 기능입니다. 

 

게임 내 그룹 채팅방을 카카오톡에 개설하고, 해당 채팅방으로 게임 메시지를 보내서 길드전, 파티 플레이 참여 등 다양한 협력 플레이를 유도해 보세요.

  • 게임 내 편리한 채팅방 만들기 지원

  • 모바일/윈도우 플랫폼 지원

  • 게임 밖의 유저와도 편리한 소통 지원

 

 

구분

설명

구분

설명

접근 설정

오픈채팅 서비스 권한 설정

https://developers.kakao.com/  접속 후

제품 설정 > 카카오로그인 > 동의항목 > 접근권한관리 영역의

"카카오톡 오픈채팅 참여 및 관리" 항목 "선택 동의"로 설정

 

유저 동의창

오픈채팅 서비스 접근 동의창

카카오톡 오픈채팅 서비스에 접근하려면 사용자 동의를 받아야 합니다.

카카오에서 제공하는 오픈채팅 참여 및 관리 권한 동의창을 호출해 주세요.

 카카오 길드 채팅 SDK 예제

 

 

 

게임 닉네임 사용 동의

게임 닉네임을 오픈채팅 닉네임으로 사용하려면 사용자 동의를 받아야 합니다.

개인정보 정책에 의거해, 해당 동의창은 게임에서 직접 구현해야 하며, 닉네임 사용 동의가 완료된 유저만 채팅방 개설/입장 API를 호출하도록 구현해야 합니다.

우측 화면을 참고하여, 게임에서 동의창 화면을 설계해 주세요.

 

주요 API

채팅방 만들기

카카오톡에 오픈채팅방 형태로 길드 채팅방을 개설합니다.

유저는 최대 20개 채팅방을 만들 수 있습니다.

채팅방 입장

채팅방에 새로운 Player를 참여시킵니다.

게임 내 ‘길드 채팅방 입장’ 버튼을 두고,
생성된 길드 채팅방에 길드원을 입장시킬 수 있습니다.

 

프로필 업데이트

채팅방에서 사용할 이름, 프로필 이미지 등을 업데이트합니다.

길드채팅방에서 사용할 프로필에 변경사항이 있는 경우 사용합니다.

길드 채팅방으로 메시지 보내기

채팅방에 게임 메시지를 전송합니다.

길드 채팅방에 유저가 어떤 게임 메시지를 전송하게 할지 정합니다.

그룹방에는 앱/발신자별 일 10회 메시지 전송이 가능합니다.

 https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/413468185

방 나가기

길드 탈퇴, 게임 탈퇴 등 게임 정책 이슈로 채팅방에서 나가기가 필요한 경우 나가기 처리합니다.

길드 탈퇴, 게임 탈퇴 시, 길드 채팅방에서 나가기 처리할 수 있습니다.

길드 채팅방으로 시스템 피드 보내기

채팅방 개설자의 길드 탈퇴로 인한 채팅방 링크 삭제, 닉네임 변경, 길드 폐쇄 등 공지가 필요한 경우 시스템 피드 API를 통해서 유저에게 공지할 수 있습니다.

 

채팅방 링크 삭제

길드 폐쇄 시, 길드 채팅방 링크도 함께 삭제할 수 있습니다.

[방 나가기와 채팅방 링크 삭제에 대한 정책]

카카오톡 정책에 따라, 방 개설자가 오픈채팅방에서 나가면 오픈채팅방 링크도 삭제됩니다. 이 경우 채팅방에 남은 멤버끼리 대화는 가능하나 방을 나가면 다시 참여할 수 없습니다.

채팅방에 새로운 멤버 참여가 필요하다면, 방 개설자가 방을 나가서 채팅방 링크가 삭제되었을 때 시스템 피드를 전송하여 새로운 방 개설을 유도하기를 권장합니다.

 

[채팅방 링크 삭제 시 게임 내 팝업창 구현 안내]

채팅방 입장을 시도했을 때 채팅방 링크 삭제로 입장이 불가하다면, 게임 내 팝업창을 통해 알리고 새로운 방을 개설하도록 안내합니다.

 

카카오톡 채팅방 리스트 열기

카카오톡을 실행하여 채팅방 리스트를 오픈합니다.

보안 정책상 특정 채팅방 열기 기능은 제공하지 않으며, 카카오톡 미설치/미가입 상태에서는 실패 처리됩니다.