화면 모드
HTML5 SDK — 설치·시작
@webzenk/wk-gameapi · TypeScript / JavaScript · 웹사이트 · 삼성 Instant Plays
설치
html
<script src="wk-gameapi.min.js"></script> <!-- 전역 이름은 WKGameApi 하나 -->ts
// dist/esm 을 프로젝트에 두고 (다운로드의 ESM zip)
import { WKGameApi, WKSamsungPlatform } from '@webzenk/wk-gameapi'파일은 다운로드에서 받아요.
시작
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을 호출하세요. - 게임 주소가 허용 도메인에 등록돼 있어야 해요.
같은 이름으로 다시 선언하지 마세요
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:로 시작 |