---
url: https://developers.webzenk.kr/sdk/unity.md
---
# Unity SDK — 설치·시작

`com.webzenk.wk-gameapi` · Unity 2022.3 LTS 이상 · Android / iOS

* **외부 의존 없음** — JSON도 자체 구현이라 Newtonsoft 버전 충돌이 없어요.
* 결제는 **Unity IAP**, 광고는 **AppLovin MAX**를 설치했을 때만 연결돼요.
* 네임스페이스 `WK.GameApi`, 공개 이름은 모두 `WK`로 시작해요.

## 설치

[다운로드](../download)에서 `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` | 없음 | 결제 스토어 — [결제](./iap) |
| `AdNetwork` | 없음 | 광고 네트워크 — [보상형 광고](./ads) |
| `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`을 비우고** 게임 주소를 허용 도메인으로 등록하면 웹 모드로 동작해요. 결제·광고 모듈은 지원하지 않아요.
