Skip to content

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은 비움)
BaseUrlhttps://game-api.webzenk.kr
Store없음결제 스토어 — 결제
AdNetwork없음광고 네트워크 — 보상형 광고
JsonWKJson저장값 직렬화. Newtonsoft 등을 쓰려면 IWKJsonSerializer 구현
AppVersionApplication.version이벤트에 함께 기록
TimeoutSec10요청 타임아웃
Debugfalse[wk-gameapi] 로그 출력

샘플 ​

Package Manager → WK Game API → Samples

샘플내용
Quick Start초기화·로그인·저장·랭킹·이벤트·결제·광고 예제 (WKQuickStart)
AppLovin MAX 연동WKMaxAdNetwork — MAX 플러그인이 있어야 컴파일돼요

WebGL ​

WebGL 빌드는 브라우저라서 App Secret이 노출돼요. AppSecret을 비우고 게임 주소를 허용 도메인으로 등록하면 웹 모드로 동작해요. 결제·광고 모듈은 지원하지 않아요.

© WEBZEN K. All rights reserved.