게임플레이 파트너 가이드

테마 전환

게임플레이 JS SDK 1.0.0-beta.3 ​

게임플레이 JS SDK 는 베타 버전입니다. 베타 테스트 기간 동안 스펙이 변경될 수 있습니다.

베타 기간 중 변경 사항은 릴리즈 노트의 SDK 탭에서 확인하세요.
연동 중 문제가 생기거나 궁금한 점이 있으면 데브톡으로 문의해 주세요.

게임플레이 JS SDK 는 카카오톡 게임웹뷰 기능과 카카오 로그인·공유, 애드핏 광고를 하나의 Gameplay 객체로 제공합니다.
CDN 에서 <script> 한 줄로 로드하며, 화면에 필요한 UI 컴포넌트도 함께 담겨 있습니다.

바로 시작하려면 시작하기로 이동하세요.

무엇을 해결하는가 ​

지금까지 파트너사는 게임 안에서 window.kakaotalkGamePlay(게임웹뷰 브리지), window.Kakao(카카오 로그인·공유), window.kakaoAdFit(카카오 애드핏)을 각각 따로 다뤄야 했습니다.
세 SDK 의 등록 절차·버전·예외 처리 방식이 제각각이라 게임마다 연동 코드가 달라졌고, 네이티브 스펙이 바뀌면 그때마다 게임 코드도 함께 고쳐야 했습니다.

게임플레이 JS SDK 는 이 세 계층을 하나의 Gameplay 객체로 통합합니다.
파트너사는 개별 SDK 의 문서나 버전을 몰라도 Gameplay.* 호출만으로 로그인·공유·광고·웹뷰 제어를 처리할 수 있고, 네이티브 브리지 스펙이 바뀌어도 SDK 내부의 변환 계층이 이를 흡수하므로 게임 코드를 다시 고칠 필요가 없습니다.

게임웹뷰 SDK 와의 관계 ​

신규로 게임플레이에 연동하는 파트너사는 게임플레이 JS SDK 사용을 권장합니다.
기존 게임웹뷰 SDK 문서는 window.kakaotalkGamePlay 등 네이티브 브리지를 직접 호출하는 방식의 기준 문서로 계속 유지됩니다.
게임플레이 JS SDK 내부 구현도 같은 브리지 스펙 위에서 동작하므로, 두 문서의 카카오톡 버전 배지는 같은 요구사항을 가리킵니다.

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

참고 문서 ​