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

`@webzenk/wk-gameapi` · TypeScript / JavaScript · 웹사이트 · 삼성 Instant Plays

## 설치

::: code-group

```html [스크립트 태그]
<script src="wk-gameapi.min.js"></script>  <!-- 전역 이름은 WKGameApi 하나 -->
```

```ts [npm·번들러]
// dist/esm 을 프로젝트에 두고 (다운로드의 ESM zip)
import { WKGameApi, WKSamsungPlatform } from '@webzenk/wk-gameapi'
```

:::

파일은 [다운로드](../download)에서 받아요.

## 시작

```js
const { WKSamsungPlatform, WKError } = WKGameApi   // 필요한 클래스만 꺼내 쓰기

const api = await WKGameApi.init({ appKey: '…', appVersion: '1.0.0' })   // Secret 없음
api.setLoadingProgress(50)                // 플랫폼 로딩 화면 (삼성)
await api.auth.login()                    // 플랫폼 계정 → 저장된 세션 → 게스트
if (api.iap.supported) await api.iap.restore(grantItem)   // 결제 복구
await api.start()                         // 로딩 화면 제거, 게임 시작
```

* `platform`을 생략하면 자동으로 골라요. 페이지에 삼성 SDK(`GSInstant`)가 있으면 `WKSamsungPlatform`, 없으면 `WKWebPlatform`.
* 삼성은 `window.onload` 이후에 `init`을 호출하세요.
* 게임 주소가 [허용 도메인](/guide/html5#준비)에 등록돼 있어야 해요.

::: warning 같은 이름으로 다시 선언하지 마세요
`const { WKGameApi } = WKGameApi` 처럼 쓰면 전역 이름이 가려져 오류가 나요. 다른 클래스만 꺼내 쓰세요.
:::

## 옵션

| 옵션 | 기본 | 설명 |
|---|---|---|
| `appKey` | — | 필수 |
| `baseUrl` | `https://game-api.webzenk.kr` | |
| `platform` | 자동 | `new WKWebPlatform()` / `new WKSamsungPlatform({...})` |
| `appVersion` | — | 이벤트에 함께 기록 |
| `timeoutMs` | 10000 | 요청 타임아웃 |
| `debug` | false | `[wk-gameapi]` 로그 |

## 이름 규칙

| 항목 | 이름 |
|---|---|
| 전역 (스크립트 태그) | `WKGameApi` 하나 — 다른 클래스는 `WKGameApi.WKSamsungPlatform`처럼 그 속성 |
| 클래스·타입 | `WKGameApi`, `WKError`, `WKWebPlatform`, `WKSamsungPlatform`, `WKPurchase` … |
| 브라우저 저장소 키 | `wk.ga:`로 시작 |
