게임플레이 파트너 가이드

테마 전환

SDK 연동 방식 선택 ​

게임플레이 연동에는 두 가지 방식이 있습니다.
둘 중 하나만 고릅니다.

연동방식 선택 기준 ​

상황방식
이제 연동을 시작합니다게임플레이 JS SDK
이미 개별 SDK 로 연동을 마쳤습니다당분간 그대로 두고, 여유가 생기면 게임플레이 JS SDK 로 옮깁니다

신규 연동에는 게임플레이 JS SDK를 권장합니다.
게임웹뷰 브리지·카카오 로그인·공유·광고를 하나의 Gameplay 객체로 다루므로 개별 SDK 의 등록 절차와 버전을 각각 따라갈 필요가 없습니다.

게임플레이 JS SDK 는 게임플레이 서비스보다 늦게 나왔습니다.
그래서 이미 개별 SDK 로 연동을 마친 파트너사를 위해 개별 SDK 문서를 당분간 유지합니다.
다만 장기적으로는 게임플레이 JS SDK 로 옮기는 것을 방향으로 삼고 있습니다.

동시 구성 지양 안내 ​

두 방식을 함께 구성하는 것은 권장하지 않습니다.
게임플레이 JS SDK 는 내부에서 window.kakaotalkGamePlay·window.Kakao·window.kakaoAdFit 을 다루므로, 게임 코드가 같은 SDK 객체를 따로 로드하면 같은 객체가 두 번 올라가 초기화 순서에 따라 설정이 덮이거나 콜백이 중복 호출될 수 있습니다.

마이그레이션 중이라면 게임 코드에서 개별 SDK 의 <script> 태그와 호출을 먼저 제거한 뒤 게임플레이 JS SDK 로 바꿉니다.

게임플레이 JS SDK 권장 ​

문서내용
게임플레이 JS SDK사전 준비·설치·초기화
게임플레이 JS SDK 레퍼런스전체 메서드와 타입
게임플레이 JS SDK UISDK 가 제공하는 UI 컴포넌트

베타 버전이라 스펙이 변경될 수 있습니다.
배포 버전과 integrity 값은 다운로드에서 확인합니다.

개별 SDK 직접 연동 ​

문서내용
게임웹뷰 SDK게임웹뷰 환경의 공통 스펙과 window.kakaotalkGamePlay 인터페이스
애드핏 광고 SDK전면 광고·보상형 전면 광고
카카오 JS SDK카카오톡 공유 호출을 위한 설치와 초기화
Tiara Web SDK게임플레이 JS SDK 미사용 게임의 게임 로그 수집·전송

게임웹뷰 SDK 문서는 게임플레이 JS SDK 를 쓰더라도 필요합니다.
게임플레이 JS SDK 내부 구현이 같은 브리지 스펙 위에서 동작하므로, 기능별 카카오톡 최소 지원 버전은 이 문서가 기준입니다.

카카오디벨로퍼스 JavaScript 키 발급과 애드핏 광고단위 발급도 방식과 무관하게 파트너사가 직접 진행합니다.

로그 수집 ​

게임플레이 JS SDK를 사용하지 않는 게임은 Tiara Web SDK를 직접 설치하고 게임 로그 설정에 정의된 로그를 구현합니다.
게임플레이 JS SDK를 사용하는 게임은 게임플레이 JS SDK의 로그 적용 방식을 따릅니다.

게임플레이 JS SDK 가 이 수집·전송을 대신 처리합니다.
init() 에 넘긴 gameCode 와 appId 가 그때 쓰이며, 그 SDK 를 쓰는 게임은 Tiara Web SDK 를 직접 연동하지 않습니다.

참고 문서 ​