---
url: https://developers.webzenk.kr/guide/samsung.md
---
# 삼성 Instant Plays

Galaxy Store Instant Plays(게임 런처)에 올리는 HTML5 게임입니다. HTML5 SDK의 `WKSamsungPlatform`이 삼성 SDK와 Game API를 이어 줍니다.

| 기능 | 지원 |
|---|---|
| 로그인 | 삼성 계정 (없으면 게스트, 나중에 연결) |
| 결제 | 삼성 IAP → 서버 영수증 검증 → 지급 → 삼성 소진(consume) |
| 광고 | Samsung Ads + AdMob (advertisement2) |
| 저장·랭킹·이벤트 | Game API |

## 준비

1. 삼성 파트너십 담당자에게 **로그인 서명 공개키**와 **결제 Seller key**를 받아 운영 담당자에게 전달합니다.
2. 게임이 열리는 실제 주소(`location.origin`)를 허용 도메인으로 등록합니다. 삼성 Debug APK를 설치하고 PC의 `chrome://inspect`로 확인할 수 있습니다.
3. `index.html`에 삼성 SDK를 **스크립트 태그로 직접** 넣습니다. 다른 방식으로 로드하면 삼성 검수를 통과하지 못합니다.

```html
<script src="https://gtg.samsungapps.com/gsinstant-sdk/gsinstant.0.46.js"></script>
<script src="https://img.samsungapps.com/gsinstant-sdk/iapinstant.1.0.js"></script> <!-- 결제를 쓸 때 -->
<script src="wk-gameapi.min.js"></script>
```

## 동작 방식

* **로그인**: 삼성 `getSignatureAsync()` 서명을 서버가 삼성 공개키로 검증합니다. 삼성 계정이 로그인돼 있지 않으면 게스트로 시작하고, 버튼을 눌렀을 때 삼성 로그인 창을 띄워 연결할 수 있습니다.
* **결제**: SDK가 결제 요청에 `wk:<player_id>`를 넣고, 서버는 영수증 서명과 삼성 결제 조회로 확인합니다. 다른 유저의 영수증은 거부됩니다.
* **계정 변경**: 게임 중에 삼성 계정이 바뀌면 삼성 규격에 따라 게임을 재시작해야 합니다(SDK의 `onAccountChange` → `restart`).
* **SDK 0.46**: `setDataAsync`/`getDataAsync`에 삼성 계정 인증이 적용됐고 `adStart`/`adEnd`는 폐기되었습니다. Game API 저장소를 쓰면 영향이 없습니다.

::: warning 결제 방식 확인 중
삼성 결제는 Instant Games IAP SDK(`iapinstant.1.0.js`) 기준입니다. 최신 GSInstant SDK 0.46에는 결제 API가 없어, 현재 결제 방식은 삼성과 확인 중입니다.
:::

**관련 문서** · [HTML5 플랫폼 SDK](/sdk/html5/platforms) · [시작 템플릿](/sdk/html5/platforms#삼성-시작-템플릿)
