화면 모드
SDK 선택
| 상황 | 사용 | 인증 |
|---|---|---|
| Unity 모바일 게임 (Android·iOS) | Unity SDK — Unity 2022.3 LTS 이상 | App Key + App Secret 서명 |
| HTML5 게임 (웹사이트·삼성 Instant Plays) | HTML5 SDK | App Key + 허용 도메인 |
| Unity WebGL | Unity SDK(App Secret 비움) 또는 HTML5 SDK | App Key + 허용 도메인 |
| 그 밖의 엔진 (Cocos, Unreal, 자체 엔진) | REST API 직접 호출 | App Key + App Secret 서명 |
| 개발사 서버 (지표·환불 회수·제재) | 개발사 서버 API | App Key + Server Secret 서명 |
두 SDK의 공통 구조
Unity와 HTML5 SDK는 같은 순서로 써요.
- 초기화 — App Key(와 App Secret)로 SDK를 만들어요.
- 지급 함수 등록 — 결제·광고 보상을 지급하는 함수를 로그인 전에 등록해요.
- 로그인 — 저장된 세션 → (플랫폼 계정) → 게스트 순서로 자동 로그인해요.
- 기능 호출 — 저장·랭킹·이벤트·결제·광고.
지급 함수를 먼저 등록해 두면, 로그인 직후 지난번에 지급하지 못한 결제·광고 보상을 SDK가 자동으로 복구해요.
이름 규칙
SDK의 공개 이름은 모두 WK(WEBZEN K)로 시작해요. 다른 SDK나 게임 코드와 겹치지 않아요. 예: WKGameApi, WKError, WKSamsungPlatform