화면 모드
Unity SDK — 설치·시작
com.webzenk.wk-gameapi · Unity 2022.3 LTS 이상 · Android / iOS
- 외부 의존 없음 — JSON도 자체 구현이라 Newtonsoft 버전 충돌이 없어요.
- 결제는 Unity IAP, 광고는 AppLovin MAX를 설치했을 때만 연결돼요.
- 네임스페이스
WK.GameApi, 공개 이름은 모두WK로 시작해요.
설치
다운로드에서 com.webzenk.wk-gameapi-<버전>.tgz를 받아 Package Manager → + → Add package from tarball… 로 설치해요.
초기화
csharp
using WK.GameApi;
var api = await WKGameApi.InitAsync(new WKGameApiOptions
{
AppKey = "…",
AppSecret = "…",
// Store = new WKUnityIapStore(new WKIapProduct("gem_100", ProductType.Consumable)), // 결제
// AdNetwork = new WKMaxAdNetwork("REWARDED_UNIT_ID", "INTERSTITIAL_UNIT_ID"), // 광고
});
// 지급 함수는 로그인 "전에" — 로그인 직후 지난번 미지급분을 자동 복구해요
api.Iap.GrantHandler = async p => { AddItem(p.ProductId); await SaveAsync(); };
api.Ads.RewardHandler = async r => { AddGold(10); await SaveAsync(); };
await api.Auth.LoginAsync(); // 저장된 세션 → 없으면 게스트await 뒤의 코드는 메인 스레드에서 실행되므로 Unity API를 바로 써도 돼요. 초기화한 인스턴스는 WKGameApi.Instance로도 꺼낼 수 있어요.
옵션
| 옵션 | 기본 | 설명 |
|---|---|---|
AppKey | — | 필수 |
AppSecret | — | 필수 (WebGL은 비움) |
BaseUrl | https://game-api.webzenk.kr | |
Store | 없음 | 결제 스토어 — 결제 |
AdNetwork | 없음 | 광고 네트워크 — 보상형 광고 |
Json | WKJson | 저장값 직렬화. Newtonsoft 등을 쓰려면 IWKJsonSerializer 구현 |
AppVersion | Application.version | 이벤트에 함께 기록 |
TimeoutSec | 10 | 요청 타임아웃 |
Debug | false | [wk-gameapi] 로그 출력 |
샘플
Package Manager → WK Game API → Samples
| 샘플 | 내용 |
|---|---|
| Quick Start | 초기화·로그인·저장·랭킹·이벤트·결제·광고 예제 (WKQuickStart) |
| AppLovin MAX 연동 | WKMaxAdNetwork — MAX 플러그인이 있어야 컴파일돼요 |
WebGL
WebGL 빌드는 브라우저라서 App Secret이 노출돼요. AppSecret을 비우고 게임 주소를 허용 도메인으로 등록하면 웹 모드로 동작해요. 결제·광고 모듈은 지원하지 않아요.