Game Developer Guide
GRG Games SDK로 간단하게 랭킹 시스템을 구축하세요
🚀 Game Developer Guide - Ranking Game
JS SDK 포함하기
게임 HTML에 GRG Games SDK를 포함하세요.
<script src="https://grggames.com/grg-games-sdk.min.js"></script>
스코어 제출하기
- 게임 종료 시 간단한 함수 호출로 스코어를 제출하세요.
- 스코어는 -999,999 ~ 999,999,999,999 범위 내에서 제출 가능합니다.
- 낮은 숫자가 높은 순위를 의미하는 게임이라면, 최종 score에 * -1로 전달하여 음수를 사용하세요.
// 게임 종료 시 score(typeof Number) 제출. GRGScore.onGameEnd(score);
완료!
- 이제 게임에서 스코어가 자동으로 랭킹에 등록됩니다. 복잡한 보안 설정은 SDK가 모두 처리합니다.
- 게임이 GRG Games 플랫폼에서 로드될 때 자동으로 토큰이 생성되며, 이를 통해 안전한 스코어 제출이 가능합니다.
🛡️ Security & Protection Guide
토큰 기반 인증
- 게임 진입 시 고유한 토큰이 자동으로 생성됩니다.
- 토큰은 게임 ID, 사용자 ID, 시간 정보를 포함하여 안전하게 생성됩니다.
- 토큰은 5분간 유효하며, 만료 시 자동으로 갱신됩니다.
스코어 검증
- 스코어는 숫자 타입만 허용됩니다.
- 유효한 범위: -999,999 ~ 999,999,999,999
- 무한대, NaN 등은 자동으로 차단됩니다.
// 올바른 스코어 제출 예시
const finalScore = 1250; // 숫자 타입
GRGScore.onGameEnd(finalScore);
// 잘못된 예시 (자동 차단됨)
GRGScore.onGameEnd("1250"); // 문자열
GRGScore.onGameEnd(Infinity); // 무한대
GRGScore.onGameEnd(null); // null속도 제한 (Rate Limiting)
- 1초당 1회만 스코어 제출이 가능합니다.
- 일일 최대 100회 제출 제한이 있습니다.
- 과도한 제출 시 자동으로 차단됩니다.
Cross-Origin 보안
- 게임이 호스팅된 도메인에서만 스코어 제출이 가능합니다.
- 다른 도메인이나 동일 출처에서의 조작은 모두 차단됩니다.
- 새로운 게임 도메인은 자동으로 지원됩니다.
🛡️ 보안 안내
GRG Games SDK는 다층 보안 시스템을 통해 안전한 스코어 제출을 보장합니다. 복잡한 보안 설정은 모두 SDK에서 자동으로 처리되므로, 개발자는 게임 로직에만 집중하시면 됩니다.