화면 모드
API & SDK 한눈에 보기
기능별로 SDK 사용법과 REST API 문서를 모았어요. SDK를 쓰면 서명·토큰 갱신·결제 복구를 SDK가 처리해요.
| 기능 | 설명 | Unity | HTML5 | REST API |
|---|---|---|---|---|
| 초기화 | App Key(·Secret)로 SDK 시작 | 설치·시작 | 설치·시작 | 인증과 서명 |
| 로그인 | 게스트·Google·Play Games·Apple·삼성 계정, 계정 연결 | 로그인 | 로그인 | 로그인·계정 |
| 저장 | 유저별 JSON 저장, 충돌 시 재시도 | 저장 | 저장 | 데이터 저장 |
| 랭킹 | 점수 제출·순위·지난 시즌 | 랭킹 | 랭킹 | 랭킹 |
| 이벤트 | 커스텀 이벤트 (모아서 전송) | 이벤트 | 이벤트 | 이벤트 |
| 결제 | 스토어 결제 → 서버 검증 → 지급 → 완료 | Unity IAP | 플랫폼 결제 | 결제 |
| 보상형 광고 | 광고 시청 → 서버 확인 → 지급 | AppLovin MAX | 플랫폼 광고 | 보상형 광고 |
| 플랫폼 | 웹·삼성 Instant Plays | — | 플랫폼 | — |
| 지표 조회·환불 회수·제재 | 개발사 서버에서 | — | — | 개발사 서버 API |
SDK 비교
| Unity SDK | HTML5 SDK | |
|---|---|---|
| 패키지 | com.webzenk.wk-gameapi (UPM) | @webzenk/wk-gameapi (npm) / wk-gameapi.min.js |
| 대상 | Unity 2022.3 LTS 이상, Android·iOS (WebGL은 웹 모드) | 웹사이트, 삼성 Instant Plays |
| 인증 | App Key + App Secret 서명 | App Key + 허용 도메인 |
| 결제 | Unity IAP 4.8+ (설치했을 때만 연결) | 플랫폼 결제 (삼성 IAP) |
| 광고 | AppLovin MAX (샘플 어댑터) | 플랫폼 광고 (Samsung Ads + AdMob) |
| 외부 의존 | 없음 (자체 JSON) | 없음 |
| 비동기 | async/await (Task) | async/await (Promise) |