21.1 카카오톡 초대 예제
21.1. 카카오톡 초대 SDK 예제
주의
신규 3.9.0 이상 API들과 혼합하여 사용하지 마세요.
21.1.1. 카카오톡 초대 메시지 보내기 예제
21.1.2. 카카오톡 초대 대상자 목록 조회하기
기존 LoadInvitableFriendProfiles(argument 3개) API, LoadRecommendedInvitableFriendProfiles API 2개는 3.7.0버전부터 deprecated되었습니다. 기존에 사용하고 있던 개발사는 계속 사용해도 되지만, 신규 LoadInvitableFriendProfiles(argument 4개) API 로 대체하기를 권장드립니다.
카카오톡 초대 대상자 목록 조회하는 예제입니다.
추천 친구 수를 넣으면, 그 수 이하에서 친구가 추천됩니다. 추천할만한 친구가 적을 경우에는 추천 친구 수보다 적게 추천될 수 있습니다. 추천 친구는 카카오 AI를 통해, 가장 가입 확률이 높은 순서로 제공됩니다.
한번에 얻어갈 수 있는 friend의 수가 2000명이 넘으면 그 이상을 요청해도 2000 명만 내려줍니다.
recommended 는 게임에 가입할 확률이 높은 추천 친구인지 여부입니다. 해당 값을 이용해서 차등 보상을 설계할 수 있습니다. 콜백을 통해, 전달되는 추천 친구 목록은 가입확률이 높은 추천 친구 유저가 먼저 있고, 그 다음에는 이름으로 정렬되어서 전달됩니다.
Unity 예제
using Kakaogame.SDK;
// [TODO] 추천 친구 수
int recommendLimit = 5; // 추천 친구 수
// [TODO] 친구 목록 조회 시작 값 설정
int offset = 0; // 친구 목록 조회 시작 값
// [TODO] 친구 목록 조회 사이즈 설정
int limit = 300; // 친구 목록 사이즈
KGKakaoProfile.LoadInvitableFriendProfiles(
recommendLimit,
offset,
limit,
(result, totalCount, idpProfiles) => {
if (result.isSuccess) {
// 카카오톡 초대가능한 친구 프로필 목록 조회 성공
// 카카오톡 초대가능한 전체 친구 수
int _totalCount = totalCount;
// 초청 가능한 친구 프로필 목록
foreach(var kakaoProfile in idpProfiles) {
// 추천 친구 여부
bool isRecommended = kakaoProfile.isRecommended;
// 게임을 실행 전 유저는 playerId가 없는 상태이기 때문에 KGKakaoProfile.uuid 를 이용하여 게임에서 관리하여 사용합니다.
string uuid = kakaoProfile.uuid;
}
}
else if (result.code == KGResultCode.NotKakaoTalkUser)
{
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다. 카카오 스토리만 가입한 유저의 계정과 같이 카카오톡 유저가 아닌 경우.
}
else {
// 카카오톡 초대가능한 친구 프로필 목록 조회 실패
}
}); |
Android 예제
// [TODO] 추천 친구 수
int recommendLimit = 5; // 추천 친구 수
// [TODO] 친구 목록 조회 시작 값 설정
int offset; // 친구 목록 조회 시작 값
// [TODO] 친구 목록 조회 사이즈 설정
int limit; // 친구 목록 사이즈
// 카카오톡 초대가능한 친구 프로필 목록 조회하기
KGKakaoProfile.loadInvitableFriendProfiles(recommendLimit, offset, limit, new KGResultCallback<KGKakaoFriendsResponse>() {
@Override
public void onResult(KGResult<KGKakaoFriendsResponse> result) {
if (result.isSuccess()) {
// 카카오톡 초대가능한 친구 프로필 목록 조회 성공
KGKakaoFriendsResponse response = result.getContent();
// 카카오톡 초대가능한 전체 친구 수
int totalCount = response.getTotalCount();
// 초청 가능한 친구 프로필 목록
List<KGKakaoProfile> friendList = response.getFriendList();
for (KGKakaoProfile profile : friendList) {
// 추천 친구 여부
boolean isRecommended = profile.isRecommended();
// 게임을 실행 전 유저는 playerId가 없는 상태이기 때문에 KGKakaoProfile.getUUID() 를 이용하여 게임에서 관리하여 사용합니다.
String UUID = profile.getUUID();
}
} else if (result.getCode() == KGResult.KGResultCode.NOT_KAKAOTALK_USER) {
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다. 카카오 스토리만 가입한 유저의 계정과 같이 카카오톡 유저가 아닌 경우.
} else {
// 카카오톡 초대가능한 친구 프로필 목록 조회 실패
}
}
}); |
iOS 예제
#import <KakaoGame/KakaoGame.h>
// [TODO] 추천 친구 수
int recommendLimit = 5; // 추천 친구 수
// [TODO] 친구 목록 조회 시작 값 설정
int offset = 0; // 친구 목록 조회 시작 값
// [TODO] 친구 목록 조회 사이즈 설정
int limit = 300; // 친구 목록 사이즈
// 카카오톡 초대가능한 친구 프로필 목록 조회하기
[KGKakaoProfile loadInvitableFriendProfilesWithRecommendLimit:recommendLimit offset:offset limit:limit completionHandler:^(NSError *error, int totalCount, NSArray *idpProfiles) {
if (IS_SUCCESS(error) == YES)
{
// 카카오톡 초대가능한 친구 프로필 목록 조회 성공
// 카카오톡 초대가능한 전체 친구 수
int _totalCount = totalCount;
// 초청 가능한 친구 프로필 목록
for(KGKakaoProfile *kakaoProfile in idpProfiles)
{
// 추천 친구 여부
BOOL isRecommended = kakaoProfile.isRecommended;
// 게임을 실행 전 유저는 playerId가 없는 상태이기 때문에 KGKakaoProfile.uuid 를 이용하여 게임에서 관리하여 사용합니다.
NSString* uuid = kakaoProfile.uuid;
}
}
else if (error.code == KGErrorNotKakaoTalkUser)
{
// 로그인 한 유저가 '카카오톡' 유저가 아닙니다. (예 : 카카오 스토리만 가입한 유저의 계정)
}
else
{
// 카카오톡 초대가능한 친구 프로필 목록 조회 실패
}
}]; |
21.1.3. 카카오톡 초대 메시지 보내기
카카오톡 초대 메시지를 보내는 예제입니다.(가이드 : 20. 카카오톡 메시지 템플릿 V2)
Unity 예제
Android 예제
iOS 예제