21.1 카카오톡 친구 초대 예제
21.1. 카카오톡 친구 초대 예제
주의
기존 3.9.0 미만 API들과 혼합하여 사용하지 마세요.
2022년 이후 신규 출시하는 게임에서는 아래 가이드 된 친구 목록 가져오기 및 메시지 보내기 API를 사용하실 수 없습니다.
친구 피커를 이용한 메시지 보내기 기능을 사용해주세요.
21.1.1. 진행중인 초대 이벤트 조회하기
진행중인 초대 이벤트 목록을 조회하는 예제입니다.
Unity 예제
using KakaoGame.SDK;
using KakaoGame.SDK.Kakao;
// 진행중인 초대 이벤트 목록 조회하기
KGKakaoInvitation.LoadEvents((result, events) => {
if (result.isSuccess)
{
// 호출 성공
// 진행중인 초대 이벤트 목록 가져오기
if (events != nil)
{
foreach (KGKakaoEvent invitationEvent in invitationEvents)
{
// 이벤트 아이디: 초대 메시지 전송, 초대장을 보낸 사람과 받은 사람 목록 가져오기 시 필요.
int eventId = invitationEvent.eventId;
// 이벤트 시작 시각
long startTime = invitationEvent.startTime;
// 이벤트 종료 시각
long finishTime = invitationEvent.finishTime;
// 설명
string eventDescription = invitationEvent.eventDescription;
}
}
}
else if (result.code == KGResultCode.NotKakaoTalkUser)
{
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다.
}
else
{
// 호출 실패
}
}); |
Android 예제
import com.kakaogame.KGKakaoInvitation;
import com.kakaogame.KGKakaoInvitation.KGKakaoEvent;
import com.kakaogame.KGResult;
// 진행중인 초대 이벤트 목록 조회하기
KGKakaoInvitation.loadEvents(new KGResultCallback<List<KGKakaoEvent>>() {
@Override
public void onResult(KGResult<List<KGKakaoEvent>> result) {
if (result.isSuccess()) {
// 호출 성공
// 진행중인 초대 이벤트 목록 가져오기
List<KGKakaoEvent> invitationEventList = result.getContent();
for (KGKakaoEvent invitationEvent : invitationEventList) {
// 이벤트 아이디: 초대 메시지 전송, 초대장을 보낸 사람과 받은 사람 목록 가져오기 시 필요.
int eventId = invitationEvent.getEventId();
// 이벤트 시작 시각
long startTime = invitationEvent.getStartTime();
// 이벤트 종료 시각
long finishTime = invitationEvent.getFinishTime();
// 설명
String description = invitationEvent.getEventDescription();
}
} else if (result.getCode() == KGResult.KGResultCode.NOT_KAKAOTALK_USER) {
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다. (예 : 카카오 스토리만 가입한 유저의 계정)
} else {
// 호출 실패
}
}
}); |
iOS 예제
#import <KakaoGame/KakaoGame.h>
// 진행중인 초대 이벤트 목록 조회하기
[KGKakaoInvitation loadEventsWithCompletionHandler:^(NSError *error, NSArray *invitationEvents) {
if (IS_SUCCESS(error) == YES)
{
// 호출 성공
// 진행중인 초대 이벤트 목록 가져오기
if (invitationEvents != nil)
{
for (KGKakaoEvent *invitationEvent in invitationEvents)
{
// 이벤트 아이디: 초대 메시지 전송, 초대장을 보낸 사람과 받은 사람 목록 가져오기 시 필요.
int eventId = invitationEvent.eventId;
// 이벤트 시작 시각
long long startTime = invitationEvent.startTime;
// 이벤트 종료 시각
long long finishTime = invitationEvent.finishTime;
// 설명
NSString *eventDescription = invitationEvent.eventDescription;
}
}
}
else if (error.code == KGErrorNotKakaoTalkUser)
{
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다.
}
else
{
// 호출 실패
}
}]; |
21.1.2. 카카오톡 초대 가능한 추천 친구 목록 조회하기
초대 메시지 전송 시 초대 가능한 추천 친구 목록을 조회하는 예제입니다.
카카오톡 초대 메시지 전송 시 반드시 이 API를 사용하여 받은 친구 객체를 인자로 전달해야합니다.
친구 목록은 인자로 넘긴 추천 친구 수 만큼 서버에서 매겨진 랭킹에 따라 먼저 목록에 포함되고 이후부터는 가나다 순으로 정렬됩니다.
LoadInvitableFriendProfiles() 의 첫 번째 매개변수에는 항상 0을 넣어주어야합니다.
Unity 예제
Android 예제
iOS 예제
21.1.3. 카카오톡 초대 메시지 보내기
카카오톡 초대 메시지를 보내는 예제입니다. (가이드 : 20. 카카오톡 메시지 템플릿 V2 )
Unity 예제
Android 예제
iOS 예제
21.1.4. 내가 초대 메시지를 보낸 친구 숫자 조회하기
내가 초대 메시지를 보낸 친구 숫자를 조회하는 예제입니다.
Unity 예제
Android 예제
iOS 예제
21.1.5. 내가 초대 메시지를 보낸 친구 목록 조회하기
내가 초대 메시지를 보낸 친구 목록을 조회하는 예제입니다.
Unity 예제
Android 예제
iOS 예제
21.1.6. 나에게 초대 메시지를 보낸 플레이어 숫자 조회하기
나에게 초대 메시지를 보낸 플레이어 숫자를 조회하는 예제입니다.
Unity 예제
Android 예제
iOS 예제
21.1.7. 나에게 초대 메시지를 보낸 플레이어 목록 조회하기
나에게 초대 메시지를 보낸 플레이어 목록을 조회하는 예제입니다.
Unity 예제
Android 예제
iOS 예제