게임 공개하기

제출 전 자동 검사

제출하면 플랫폼이 업로드된 파일을 자동으로 검사하고 문제가 있으면 아래에 목록으로 보여줘요 — 안내에 따라 수정한 뒤 다시 제출하세요. 결과는 작업물과 함께 저장되므로 언제든 “사전 검사 결과 보기”로 다시 확인할 수 있어요.

플랫폼 기능 사용하기

이 섹션은 사이트 안에서 실행되는 단일 HTML 파일과 웹 번들에 적용됩니다. 다운로드 작업물은 건너뛰어도 됩니다.

게임은 플랫폼이 제공하는 iframe 셸 안에서 실행돼요. 상단 바(Yonest로 돌아가기 / 리더보드 / 다시 시작 / 전체 화면)는 플랫폼이 제공하고, HTML 파일에는 플랫폼 코드가 전혀 기록되지 않아요. 플랫폼 기능이 필요할 때는 아래처럼 선택적인 보호 호출만 추가하면 돼요:

플랫폼이 게임에 제공하는 것

• 상단 바와 내비게이션(Yonest로 돌아가기, 리더보드, 다시 시작, 전체 화면)은 플랫폼이 제공합니다. 직접 만들 필요가 없습니다.
• 게임 오버 창에 ‘Yonest로 돌아가기’ 버튼을 한 줄로 추가. 스타일은 자동으로 맞춰집니다.
• 점수 전송과 리더보드. 역대 최고 기록과 내 순위를 보여 줍니다(리더보드가 켜진 게임만).
• 최대 8개 언어의 사전 테이블. 한 번 등록하면 UI가 플레이어 언어를 따라갑니다.
• 플레이어 정보(표시 이름과 id)로 인사말과 개인화 콘텐츠를 만들 수 있습니다.
• 이 게임 전용 로그인 토큰. 자체 백엔드에서 신원과 권한을 검증할 수 있습니다.
• 완전히 제거 가능. 플랫폼이 없으면 호출이 건너뛰어지고, 내보낼 때 훅을 한 번에 제거할 수 있습니다.
• 로컬 mock과 TypeScript 타입. 플랫폼 없이 통합 테스트가 가능하고 window.Yonest에 타입이 붙습니다.
• 일시정지/재개/전체 화면/떠나기 직전 이벤트로 타이머와 저장이 플레이어 동작을 따라갑니다.
• 게임 내 이벤트 집계(Yonest.track)와 메이커 콘솔의 CSV 내보내기.
• 클라우드 저장(Yonest.save). 진행 상황이 계정을 따라가 기기를 바꿔도 이어서 플레이할 수 있습니다. 플레이어당 작품당 20개, 개당 32KB.
• 업적(Yonest.achievement). 해금 기록은 플랫폼이 저장하며, 멱등이라 중복되지 않습니다.
• 일간·주간 순위(UTC)가 전체 최고 기록과 함께 제공됩니다. 추가 개발이 필요 없습니다.

/* yonest:start */
if (window.Yonest) window.Yonest.gameOverActions(resultEl); // add "Back to Yonest" to the game-over dialog
if (window.Yonest && window.Yonest.supportsLeaderboard) {
  window.Yonest.submitScore(score);                        // submit a score (leaderboard-enabled games only)
}
// window.Yonest is injected after the iframe loads: queue init calls, they replay on install
(window.YonestQueue = window.YonestQueue || []).push(function (Yonest) {
  Yonest.i18n(dictionaries, 'en');                          // required: register your dictionaries (don't skip this)
  Yonest.applyI18n();
});
/* yonest:end */

window.Yonest가 없으면 이 호출들은 자동으로 건너뛰어져서 플랫폼 밖에서도 게임이 잘 실행돼요.

전체 기능 목록과 호출 방법은 Yonest SDK 가이드에서 확인할 수 있어요 — 시작하기 전에 꼭 끝까지 읽어 보세요.