---
url: /api-sdk/sdk/gameplay-js.md
description: 카카오톡 게임웹뷰 기능과 카카오 로그인·공유·광고를 하나의 인터페이스로 제공하는 JavaScript SDK
---

# 게임플레이 JS SDK 

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

바로 시작하려면 [시작하기](/api-sdk/sdk/gameplay-js/getting-started)로 이동하세요.

## 무엇을 해결하는가

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

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

## 게임웹뷰 SDK 와의 관계

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

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

## 참고 문서

* [시작하기](/api-sdk/sdk/gameplay-js/getting-started): 사전 준비부터 초기화까지
* [다운로드](/api-sdk/sdk/gameplay-js/download): CDN 주소와 버전별 `integrity` 값
* [전체 메서드](/api-sdk/sdk/gameplay-js/reference): 메서드와 에러 코드 전체 명세
* [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui): managed UI 5개 컴포넌트의 옵션과 표시 정책
* [SDK 연동 방식 선택](/api-sdk/sdk/): 게임웹뷰 SDK 와의 비교와 마이그레이션 순서
* 기술 문의: [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)