Skip to content

삼성 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 저장소를 쓰면 영향이 없어요.

결제 방식 확인 중

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

관련 문서 · HTML5 플랫폼 SDK · 시작 템플릿

© WEBZEN K. All rights reserved.