화면 모드
삼성 Instant Plays
Galaxy Store Instant Plays(게임 런처)에 올리는 HTML5 게임이에요. HTML5 SDK의 WKSamsungPlatform이 삼성 SDK와 Game API를 이어 줘요.
| 기능 | 지원 |
|---|---|
| 로그인 | 삼성 계정 (없으면 게스트, 나중에 연결) |
| 결제 | 삼성 IAP → 서버 영수증 검증 → 지급 → 삼성 소진(consume) |
| 광고 | Samsung Ads + AdMob (advertisement2) |
| 저장·랭킹·이벤트 | Game API |
준비
- 삼성 파트너십 담당자에게 로그인 서명 공개키와 결제 Seller key를 받아 운영 담당자에게 전달해요.
- 게임이 열리는 실제 주소(
location.origin)를 허용 도메인으로 등록해요. 삼성 Debug APK를 설치하고 PC의chrome://inspect로 확인할 수 있어요. 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 저장소를 쓰면 영향이 없어요.
결제 방식 확인 중
삼성 결제는 Instant Games IAP SDK(iapinstant.1.0.js) 기준이에요. 최신 GSInstant SDK 0.46에는 결제 API가 없어, 현재 결제 방식은 삼성과 확인 중이에요.
관련 문서 · HTML5 플랫폼 SDK · 시작 템플릿