화면 모드
웹 (HTML5)
브라우저에는 Secret을 둘 수 없어서, HTML5 게임은 App Key + 허용 도메인으로 접속해요. 로그인한 뒤에는 앱과 같은 유저 토큰을 써요.
준비
- 게임이 열리는 주소를 운영 담당자에게 전달해 허용 도메인으로 등록해요.
https://game.example.com— 이 주소만https://*.example.com— 하위 도메인 전체 (상위 도메인 자체는 아님)http://localhost:8080— 개발용 (http는 localhost만)
- HTML5 SDK를 넣고 App Key만으로 초기화해요.
웹에서 다른 점
| 항목 | 웹 |
|---|---|
| 인증 | App Key + 브라우저가 붙이는 Origin. App Secret 서명 없음 |
| 로그인 | 게스트, Google·Apple(직접 받은 ID 토큰), 플랫폼 계정 |
| 결제 | 플랫폼 결제만 (삼성 Instant Plays). Google Play·App Store 검증은 막혀 있어요 |
| 광고 | 플랫폼 광고 SDK (서버 콜백 없음) |
| 저장·랭킹·이벤트 | 앱과 같아요 |
자주 보는 오류:
403 ORIGIN_NOT_ALLOWED— 지금 주소가 허용 도메인에 없어요.403 WEB_NOT_ENABLED— 게임에 웹이 아직 켜지지 않았어요.403 WEB_NOT_SUPPORTED— 웹에서 쓸 수 없는 API예요 (스토어 결제·MAX 광고).
Unity WebGL
Unity WebGL 빌드도 브라우저라서 같은 규칙이에요. Unity SDK에서 AppSecret을 비우면 웹 모드로 동작해요.