Debug 패널

Debug 패널은 SDK 호출을 추적, 인터넷 연결 상태를 에뮬레이션, 게임의 포커스를 해제, 야냑스의 로딩 화면을 비활성화하는 등의 작업을 테스트할 수 있는 도구입니다.

Debug 패널 활성화하기

디버그 패널은 게임 페이지의 왼쪽 하단에 나타납니다.

디버그 패널의 구성요소

로더

로더는 다음과 같은 값을 가질 수 있습니다:

지시등	텍스트	값
W	—	초기화를 기다리고 있습니다.
IT	Is loader: true	SDK 로더가 올바르게 초기화되었습니다.
IF	Is loader: false	구버전 로더를 사용 중입니다. 문서에 따라 SDK를 로드하세요 (1.19.1 항목).

Game Ready 호출 인디케이터

SDK의 게임 내 상태와 LoadingAPI.ready()(항목 1.19.2) 메소드 호출 시점을 알아보려면 인디케이터에 마우스를 가져가세요. 색상은 파란색, 초록색 또는 빨간색일 수 있습니다:

SDK is not defined 오류가 왜 보이는데, Game Ready 표시기가 SDK가 초기화되었다고 보여주는 이유는 무엇인가요?

SDK를 올바르게 초기화하는 것이 중요합니다: 스크립트 /sdk.js는 YaGames.init() 실행 전에 연결되어야 합니다. Game Ready 인디케이터는 게임에 SDK가 설치되었는지, 필요한 스크립트가 연결되었는지만을 등록합니다.

Play 버튼 ▶️

Play 버튼은 게임 활동의 지표입니다. game_api_pause/game_api_resume 이벤트를 통해 플랫폼은 게임이 일시 정지되어야 하는 시점이나 게임 경험을 계속해야 하는 시점을 알립니다.

이벤트 작동을 시뮬레이션하려면 버튼을 클릭하세요:

• ▶️ — 게임이 포커스를 받고 있으며, 게임이 진행 중입니다.
• ⏸️ — 게임이 포커스를 잃었고, 구매 창이 열리거나 광고가 표시됩니다.

게임패드 버튼 🎮

게임패드 버튼 🎮은 SDK 메소드 GameplayAPI.start() 및 GameplayAPI.stop() (항목 1.19.3)의 사용을 흉내 냅니다. 상태 간 전환을 위해 이 버튼을 누르세요:

• 흰색 배경 (기본) — 게임 내 게임플레이가 사용되지 않음.
• 녹색 배경 — 게임플레이 진행 중.
• 빨간색 배경 — 게임플레이 일시 중지.

시계 버튼 ⏱️

얀덱스 부팅 화면의 투명도를 켜고 끄려면 시계 ⏱️ 버튼을 누르세요:

• Mute Game loader – 투명도가 꺼지며, 게임 시작 시 게임 아이콘이 중앙에 표시되는 부팅 화면이 나타납니다.
• Show Game loader – 투명도가 켜지며, 게임 로딩 아이콘이 투명해집니다. 게임이 로딩되는 동안 무슨 일이 일어나는지 볼 수 있습니다.

도구 버튼 SDK mocks ⚒️

Choose Game Lang매개 변수

이 기능은 게임에 대해 자동으로 결정되는 언어를 변경할 수 있게 해줍니다.

작동 원리:

1. Choose Game Lang을 클릭하세요.
2. 드롭다운 목록에서 언어를 선택하세요.
3. 게임을 다시 시작하세요. 선택한 언어 값이 environment.i18n.lang에 적용됩니다.

언어를 자동 결정으로 돌리려면:

1. 언어로 표시된 매개변수를 선택하세요 (예: En ).
2. 드롭다운 목록에서 Choose Game Lang 첫 번째 항목을 선택하세요.
3. 게임을 다시 시작하세요.

링크 아이콘: 🔗 Game links mock is disabled / 🔗 Game links mock is enabled.

이 매개변수를 사용하여 요구 사항 항목 8.4.1의 준수 여부를 확인합니다. 검사 모드에서 다른 게임으로의 링크 대신 정적 페이지가 열리면 이 항목이 충족된 것으로 간주됩니다. 자세한 내용은 검사 방법을 참조하세요.

검사 모드를 활성화하거나 비활성화하려면:

1. 🔗 Game links mock is disabled 또는 🔗 Game links mock is enabled를 각각 선택하세요.
2. 5초 기다린 후 게임을 다시 시작하세요.

눈 아이콘: 👁 Remove the focus from the game / 👀 Return the focus to the game.

게임의 포커스를 해제하거나 다시 설정하려면 버튼을 누르세요. 이는 게임 디버깅 및 테스트에 유용합니다.

로켓 아이콘 또는 거북이 아이콘: 🚀 Network throttling is disabled / 🐢 Network throttling is enabled.

로켓과 거북이는 서버로부터의 응답 대기 시간을 변경합니다. 다양한 모드 사이에서 전환하려면 이 버튼을 누르세요:

• 로켓 모드에서는 서버로부터의 응답 대기 시간이 표준입니다. 게임이 정상 모드로 작동합니다.

• 거북이 모드에서는 클라이언트가 서버로부터 즉시 응답을 요구합니다. 짧은 시간 내에 응답이 없으면 게임은 서버가 응답하지 않았다고 판단합니다. 이 모드는 인터넷 연결이 느린 환경에서 게임을 테스트하거나, SDK 서버가 시간 내에 응답하지 않을 경우 구매와 같은 오류를 에뮬레이션할 때 사용됩니다.

화폐 아이콘: 🪙 Currency mock is disabled / 🪙 Currency mock is enabled.

이 설정은 게임 내 화폐(yans이라는 이름과 아이콘)를 에뮬레이트합니다:

• Currency mock is disabled — 아이콘과 통화 이름 yans은 표준입니다.

• Currency mock is enabled — 게임 내 화폐의 이름과 아이콘이 모크로 변경되어야 합니다. 만약:

  • 화폐의 이름과 아이콘이 엔으로 변경된 경우 — 게임이 SDK 메서드를 올바르게 사용하여 포털 화폐를 표시하고 있음을 의미합니다(요구사항 섹션 3.8을 준수함 요구사항 3.8);

  • 화폐의 이름과 아이콘이 엔으로 변경되지 않은 경우 — 게임에서 포털 화폐를 표시하기 위한 메서드를 사용하지 않고 있으며, 요구사항 3.8을 위반하고 있습니다. 이런 게임은 모더레이터에 의해 거부될 것입니다. 화폐의 이름과 아이콘을 개발자 문서에 따라 명시해야 합니다.

모의 화폐는 서버가 제공하는 테스트용 조건부 화폐입니다. 모더레이터들은 모의 화폐로 TST와 엔화 기호 ¥를 사용합니다.