---
url: /api-sdk/sdk.md
description: 게임플레이 JS SDK 와 개별 SDK 직접 연동 중 하나를 고르는 기준과 마이그레이션 안내
---

# SDK 연동 방식 선택

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

## 연동방식 선택 기준

| 상황 | 방식 |
| --- | --- |
| 이제 연동을 시작합니다 | [게임플레이 JS SDK](/api-sdk/sdk/gameplay-js/) |
| 이미 개별 SDK 로 연동을 마쳤습니다 | 당분간 그대로 두고, 여유가 생기면 게임플레이 JS SDK 로 옮깁니다 |

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

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

## 동시 구성 지양 안내

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

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

## 게임플레이 JS SDK&#x20;

| 문서 | 내용 |
| --- | --- |
| [게임플레이 JS SDK](/api-sdk/sdk/gameplay-js/) | 사전 준비·설치·초기화 |
| [게임플레이 JS SDK 레퍼런스](/api-sdk/sdk/gameplay-js/reference) | 전체 메서드와 타입 |
| [게임플레이 JS SDK UI](/api-sdk/sdk/gameplay-js/ui) | SDK 가 제공하는 UI 컴포넌트 |

**베타 버전**이라 스펙이 변경될 수 있습니다. 배포 버전과 `integrity` 값은 [다운로드](/api-sdk/sdk/gameplay-js/download)에서 확인합니다.

## 개별 SDK 직접 연동

| 문서 | 내용 |
| --- | --- |
| [게임웹뷰 SDK](/api-sdk/sdk/kakaotalk-gameplay) | 게임웹뷰 환경의 공통 스펙과 `window.kakaotalkGamePlay` 인터페이스 |
| [애드핏 광고 SDK](/api-sdk/sdk/adfit) | 전면 광고·보상형 전면 광고 |
| [카카오 JS SDK](/api-sdk/sdk/kakao-js) | 카카오톡 공유 호출을 위한 설치와 초기화 |
| [Tiara Web SDK](/api-sdk/sdk/tiara-web) | 게임플레이 JS SDK 미사용 게임의 게임 로그 수집·전송 |

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

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

## 로그 수집

게임플레이 JS SDK를 사용하지 않는 게임은 [Tiara Web SDK](/api-sdk/sdk/tiara-web)를 직접 설치하고 [게임 로그 설정](/api-sdk/sdk/tiara-game-logs)에 정의된 로그를 구현합니다.
게임플레이 JS SDK를 사용하는 게임은 [게임플레이 JS SDK](/api-sdk/sdk/gameplay-js/)의 로그 적용 방식을 따릅니다.

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

## 참고 문서

* [API & SDK 개요](/api-sdk/) — SDK 와 API 전체 목록
* [입점 안내](/docs/checklist/start-guide) — 연동 순서와 준비물
* [게임 실행 흐름](/docs/webview/launch-flow) — 카카오가 어디까지 하고 파트너사가 어디서 받는지
* 기술 문의 — [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)