---
url: https://developers.webzenk.kr/guide/choose-sdk.md
---
# SDK 선택

| 상황 | 사용 | 인증 |
|---|---|---|
| Unity 모바일 게임 (Android·iOS) | [Unity SDK](/sdk/unity/) — Unity 2022.3 LTS 이상 | App Key + App Secret 서명 |
| HTML5 게임 (웹사이트·삼성 Instant Plays) | [HTML5 SDK](/sdk/html5/) | App Key + 허용 도메인 |
| Unity WebGL | Unity SDK(App Secret 비움) 또는 HTML5 SDK | App Key + 허용 도메인 |
| 그 밖의 엔진 (Cocos, Unreal, 자체 엔진) | [REST API](/api/) 직접 호출 | App Key + App Secret 서명 |
| 개발사 서버 (지표·환불 회수·제재) | [개발사 서버 API](/api/server) | App Key + Server Secret 서명 |

## 두 SDK의 공통 구조

Unity와 HTML5 SDK는 같은 순서로 써요.

1. **초기화** — App Key(와 App Secret)로 SDK를 만들어요.
2. **지급 함수 등록** — 결제·광고 보상을 지급하는 함수를 **로그인 전에** 등록해요.
3. **로그인** — 저장된 세션 → (플랫폼 계정) → 게스트 순서로 자동 로그인해요.
4. **기능 호출** — 저장·랭킹·이벤트·결제·광고.

지급 함수를 먼저 등록해 두면, 로그인 직후 **지난번에 지급하지 못한 결제·광고 보상을 SDK가 자동으로 복구**해요.

::: info 이름 규칙
SDK의 공개 이름은 모두 `WK`(WEBZEN K)로 시작해요. 다른 SDK나 게임 코드와 겹치지 않아요. 예: `WKGameApi`, `WKError`, `WKSamsungPlatform`
:::
