Skip to content

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—필수
baseUrlhttps://game-api.webzenk.kr
platform자동new WKWebPlatform() / new WKSamsungPlatform({...})
appVersion—이벤트에 함께 기록
timeoutMs10000요청 타임아웃
debugfalse[wk-gameapi] 로그

이름 규칙 ​

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

© WEBZEN K. All rights reserved.