개발자 가이드

// CDN에서 직접 import (복사 불필요, 항상 최신)
<script type="module">
  import { startRecording, submitScore, getLocale }
    from 'https://www.3secgames.app/sdk/3sec-score.js';
  import { initClip, reportScore, uploadHighlight }
    from 'https://www.3secgames.app/sdk/3sec-clip.js';
  // ... 게임 코드
</script>

// 빌드 프로젝트(React/TS)라면 sdk/3sec-score.ts 를 복사해 import 해도 됩니다.

import { startRecording, submitScore, getLocale }
  from 'https://www.3secgames.app/sdk/3sec-score.js';

// 게임 시작 시
startRecording('your-game-id');          // 하이라이트 녹화 시작 (선택)
const locale = getLocale();               // 포털 언어(?locale=) — UI 문자열 선택

// 게임 오버 시
async function onGameOver(finalScore) {
  try {
    const { personalBest, newBadges } =
      await submitScore('your-game-id', finalScore);

    if (personalBest !== null) showMessage(`최고 기록: ${personalBest}`);
    if (newBadges.length > 0) showBadgeUnlock(newBadges);  // 🏆 새 뱃지 (선택)
  } catch (e) {
    if (e.message === 'cooldown') {
      // 30초 쿨다운 — 조용히 무시하거나 안내 메시지
    }
    // 그 외 오류: 게임 진행에 영향 없게 무시
  }
}