21.1 카카오톡 친구피커 초대 예제

21.1. 카카오톡 친구피커 초대 예제

1 21.1. 카카오톡 친구피커 초대 예제
- 1.1 21.1.1. 싱글 피커로 초대하기
- 1.2 21.1.2. 멀티 피커로 초대하기

주의

기존 3.12.0 미만 API들과 혼합하여 사용하지 마세요.

21.1.1. 싱글 피커로 초대하기

싱글 피커를 이용한 친구 초대 예제입니다.

Unity 예제

using Kakaogame.SDK;
using Kakaogame.SDK.Kakao;
  
// [TODO] 팝업창으로 띄울지 여부 설정
bool isPopup;
  
// [TODO] 템플릿 Id 설정
string templateId;
  
// [TODO] 메시지 템플릿에 설정한 인자 설정
Dictionary<string, object> argumentDic = new Dictionary<string, object>();
  
// 싱글 피커로 초대하기
KGKakaoPicker.SendSingleInviteMessage(isPopup, templateId, argumentDic, (result, user) => {
    if (result.isSuccess)
    {
        // 요청 성공
    }
    else
    {
        // 요청 실패
        if (result.code == KGResultCode.MessageSettingDisabled)
        {
            // 받은이가 메시지 수신 거부를 설정한 경우.
        }
        else if (result.code == KGResultCode.ExceedDailyUsage)
        {
            // 한명이 특정 앱에 대해 보낼 수 있는 하루 쿼터(받는 사람 관계없이) 초과시 발생.
        }
        else if (result.code == KGResultCode.ExceedMonthlyUsage)
        {
            // 한명이 특정 앱에 대해 특정인에게 보낼 수 있는 한달 쿼터 초과시 발생.
        }
        else if (result.code == KGResultCode.NotKakaoTalkUser)
        {
            // 로그인 한 유저가 '카카오톡' 유저가 아닙니다.
        }
        else
        {
            // 그 밖의 에러
        }
    }
});

Android 예제

import com.kakaogame.KGKakaoPicker;
import com.kakaogame.KGKakaoPicker.KGKakaoUser;
import com.kakaogame.KGResult;
import com.kakaogame.KGResultCallback;
  
// [TODO] 팝업창으로 띄울지 여부 설정
int isPopUp; // 팝업창으로 띄울지 여부
 
// [TODO] 템플릿 Id 설정
String templateId; // 메시지 템플릿 어드민에서 생성한 템플릿의 Id 값
  
// [TODO] 메시지 템플릿에 설정한 인자 설정
String nickname = ((KGKakaoProfile) KGLocalPlayer.getCurrentPlayer().getIdpProfile()).getNickname();
Map<String, String> args = new LinkedHashMap<String, String>();
args.put("${sender_name}", nickname);
 
// 싱글 피커로 초대하기
KGKakaoPicker.sendSingleInviteMessage(activity, isPopUp, templateId, args, new KGResultCallback<KGKakaoUser>() {
    @Override
    public void onResult(KGResult<KGKakaoUser> result) {
        if (result.isSuccess()) {
            // 요청 성공
        } else {
            // 요청 실패
            if (result.getCode() == KGResult.KGResultCode.MESSAGE_SETTING_DISABLE) {
                // 받은이가 메시지 수신 거부를 설정한 경우.
            } else if (result.getCode() == KGResult.KGResultCode.EXCEED_DAILY_USAGE) {
                // 한명이 특정 앱에 대해 보낼 수 있는 하루 쿼터(받는 사람 관계없이) 초과시 발생.
            } else if (result.getCode() == KGResult.KGResultCode.EXCEED_MONTHLY_USAGE) {
                // 한명이 특정 앱에 대해 특정인에게 보낼 수 있는 한달 쿼터 초과시 발생.
            } else {
                // 그 밖의 에러
            }
        }
    }
});

iOS 예제

#import <KakaoGame/KakaoGame.h>
#import <KakaoGameKakao/KakaoGameKakao.h>
  
// [TODO] 팝업창으로 띄울지 여부 설정
BOOL isPopup;
  
// [TODO] 템플릿 Id 설정
NSString *templateId;
  
// [TODO] 메시지 템플릿에 설정한 인자 설정
NSDictionary *argumentDic = [NSDictionary dictionary];
  
// 싱글 피커로 초대하기
[KGKakaoPicker sendSingleInviteMessageWithIsPopup:isPopup templateId:templateId argumentDic:argumentDic completionHandler:^(NSError *error, KGKakaoUser *user) {
    if (IS_SUCCESS(error))
    {
        // 요청 성공
    }
    else
    {
        // 요청 실패
        if (error.code == KGErrorMessageSettingDisabled)
        {
            // 받은이가 메시지 수신 거부를 설정한 경우.
        }
        else if (error.code == KGErrorExceedDailyUsage)
        {
            // 한명이 특정 앱에 대해 보낼 수 있는 하루 쿼터(받는 사람 관계없이) 초과시 발생.
        }
        else if (error.code == KGErrorExceedMonthlyUsage)
        {
            // 한명이 특정 앱에 대해 특정인에게 보낼 수 있는 한달 쿼터 초과시 발생.
        }
        else if (error.code == KGErrorKakaoTalkNotInstalled)
        {
            // 로그인 한 유저가 '카카오톡' 유저가 아닙니다.
        }
        else
        {
            // 그 밖의 에러
        }
    }
});

Unreal 예제

21.1.2. 멀티 피커로 초대하기

멀티 피커를 이용한 친구 초대 예제입니다.

멀티 피커의 경우 초대 메시지보내기가 한명이라도 성공한 경우 성공으로 리턴됩니다.

Unity 예제

Android 예제

iOS 예제

Unreal 예제