카카오 | SDK 2.0 API

 

 

iOS API

---

 

환경설정

+ API 호출 전 게임 세부정보 수정 번들 ID 등록

+ info.plist URL Types에서 URLSchemes값 추가

+ info.plist Native App Key 등록

 

KakaoGameAPI 클래스에 구현된 메소드를 사용

+ #import <KakaoGameSDK/KakaoGameSDK.h>

 

KOUtils 클래스에서 KA header 값을 얻을 수 있다

+ NSString *kaHeader = [KOUtils kaHeader];

 

 

 

 

 

AOS API

---

 

환경설정

+ API호출 전에 게임센터->게임관리->키해시등록

+ kakao.strings.xml의 kakao_app_key에 있는 값을 게임세부정보 네이티브앱키로 변경

+ kakao_scheme 또한 Native App Key 적용

 

GameAPI class 

+ SDK 내 GameAPI.java에 GameAPI class로 정의

+ 위치 : kakao_android.sdk_for_elipse/src/com/kakao/game/GameAPI.java

+ 구현 시 : com.kakako.game.GameAPI를 import, GameAPI class에 정의된 메소드 사용

 

KA header 내용 얻기

+ package com.kakao.util.helper의 SystemInfo class에서 getKAHeader() 메소드를 사용 KA 헤더 값 얻을 수 있다.

SystemInfo.getKAHeader();

+ (CommonProtocol.KA_SDK_KEY).append("1.1.5")

+ (CommonProtocol.KA_GAME_SDK).append("2.0.0")

 

KakaoWebViewActivity 설정

+ 로그인 웹뷰 액티비티를 프로젝트에 적용(택 1)

project.properties에 적용

이 방법 권장

샘플 프로젝트의 project.properties 파일 참고

+ AndroidManifest.xml에 적용

SDK AndroidMainfest.xml 파일 중 KakaoWebViewActivity 관련 된 activity 부분을 복사 

게임 프로젝트의 AndroidManifest.xml 붙여넣기

 

 

REST API

---

 

유의 사항

+ Server API 와 Client API 구분

+ Server API

서버에서 호출

Authorization을 어드민 키로 하는 경우 마스터 키이므로 주의 요망.

+ Client API

클라이언트에서 호출

유저 토큰 유효성 검증

회원번호 전송하지 않도록 유의

 

+ REST Call 로 API 호출 시 https 로 요청

+ 호출할 때마다 아래 KA 헤더를 반드시 포함

+ KA 헤더는 Client 뿐 아니라 Server to Server 호출 시에도 포함

+ KA: sdk/{sdk_version} os/{platform_os_version}lang/{language} res/{resolution} device/{device_info} origin/{android_key_hash 또는ios_bundle_id 또는client_origin} android_pkg/{package_name} game_sdk/{game_sdk_version}

 

유저 식별자

+ Service User ID(카카오 회원번호) 대신 User ID (게임 회원번호)를 사용

+ 사용자 정보요청 API를 통해 유저의 게임 회원번호 알아낼 수 있다

+ 탈퇴 후 재가입 시 값 변경