--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/games/doc/en/console/debug-panel.md - https://yandex.com/dev/games/doc/hi/console/debug-panel.md - https://yandex.com/dev/games/doc/ko/console/debug-panel.md - https://yandex.com/dev/games/doc/ru/console/debug-panel.md - https://yandex.com/dev/games/doc/tr/console/debug-panel.md - https://yandex.com/dev/games/doc/vi/console/debug-panel.md - https://yandex.com/dev/games/doc/zh/console/debug-panel.md - href: ko/console/debug-panel.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/ko/llms.txt # Debug 패널 Debug 패널은 SDK 호출을 추적, 인터넷 연결 상태를 에뮬레이션, 게임의 포커스를 해제, 야냑스의 로딩 화면을 비활성화하는 등의 작업을 테스트할 수 있는 도구입니다. ## Debug 패널 활성화하기 {#debug-panel-on} {% list tabs %} - 개발자 콘솔을 통해서 1. [Yandex Games 콘솔](../_includes/requirements/(https:/games.yandex.com/console))을 엽니다. 1. 필요한 게임을 선택합니다. 1. 왼쪽 상단에 있는 **Open with debug panel**을 클릭합니다. - 주소 창을 통해서 1. 원하는 게임을 엽니다. 1. 브라우저의 주소 창 끝에 `&debug-mode=16`을 추가합니다. {% endlist %} 디버그 패널은 게임 페이지의 왼쪽 하단에 나타납니다. ## 디버그 패널의 구성요소 {#debug-panel-parts} ### 로더 {#loader} 로더는 다음과 같은 값을 가질 수 있습니다: #| || **지시등** | **텍스트** | **값** || || `W` | — | 초기화를 기다리고 있습니다. || || `IT` | Is loader: true | SDK 로더가 올바르게 초기화되었습니다. || || `IF` | Is loader: false | 구버전 로더를 사용 중입니다. [문서](https://yandex.com/dev/games/doc/ko/sdk/sdk-about.md#connect)에 따라 SDK를 로드하세요 ([1.19.1 항목](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#1-19-1)). || |# ### Game Ready 호출 인디케이터 {#game-ready-call} SDK의 게임 내 상태와 `LoadingAPI.ready()`([항목 1.19.2](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#1-19-2)) 메소드 호출 시점을 알아보려면 인디케이터에 마우스를 가져가세요. 색상은 파란색, 초록색 또는 빨간색일 수 있습니다:
#| || **인디케이터** | **텍스트** | **의미** || || 파란색으로 깜빡임 ![](../_images/debug-panel/gra-blue.svg) | SDK is not initialized. Wait for "unit" call. | 게임이 SDK 초기화를 기다리고 있습니다. || || 파란색으로 깜빡임 ![](../_images/debug-panel/gra-blue.svg) | The game has initialized the SDK. Waiting for call "ready". | 게임이 SDK를 초기화했으며 이제 `LoadingAPI.ready()` 메서드의 호출을 기다리고 있습니다. Game Ready 대기 시간은 90초입니다. || || 초록색으로 변함 ![](../_images/debug-panel/gra-green.svg) | The game called ready after … ms. | `LoadingAPI.ready()` 메서드가 지정된 밀리초 후에 호출되었습니다. || || 빨간색으로 변함 ![](../_images/debug-panel/gra-red.svg) | \"ready" called on timeout. | 게임에서 90초의 대기 시간 후에도 Game Ready가 호출되지 않았습니다. 이 경우 게임에서 Game Ready가 사용되지 않는 것으로 간주됩니다. || |#
#### SDK is not defined 오류가 왜 보이는데, Game Ready 표시기가 SDK가 초기화되었다고 보여주는 이유는 무엇인가요? SDK를 올바르게 초기화하는 것이 중요합니다: 스크립트 `/sdk.js`는 [YaGames.init()](https://yandex.com/dev/games/doc/ko/sdk/sdk-about.md#use) 실행 전에 연결되어야 합니다. Game Ready 인디케이터는 게임에 SDK가 [설치되었는지](https://yandex.com/dev/games/doc/ko/sdk/sdk-about.md#connect), 필요한 스크립트가 연결되었는지만을 등록합니다. ### Play 버튼 ▶️ {#play-button} Play 버튼은 게임 활동의 지표입니다. `game_api_pause`/`game_api_resume` 이벤트를 통해 플랫폼은 게임이 일시 정지되어야 하는 시점이나 게임 경험을 계속해야 하는 시점을 알립니다. 이벤트 작동을 시뮬레이션하려면 버튼을 클릭하세요: - ▶️ — 게임이 포커스를 받고 있으며, 게임이 진행 중입니다. - ⏸️ — 게임이 포커스를 잃었고, 구매 창이 열리거나 광고가 표시됩니다. ### 게임패드 버튼 🎮 {#gamepad-button} 게임패드 버튼 🎮은 [SDK 메소드](https://yandex.com/dev/games/doc/ko/sdk/sdk-game-events.md#gameplay) `GameplayAPI.start()` 및 `GameplayAPI.stop()` ([항목 1.19.3](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#1-19-3))의 사용을 흉내 냅니다. 상태 간 전환을 위해 이 버튼을 누르세요: - 흰색 배경 ![](../_images/debug-panel/gameplay-none.svg) (기본) — 게임 내 게임플레이가 사용되지 않음. - 녹색 배경 ![](../_images/debug-panel/gameplay-on.svg) — 게임플레이 진행 중. - 빨간색 배경 ![](../_images/debug-panel/gameplay-off.svg) — 게임플레이 일시 중지. ### 시계 버튼 ⏱️ {#clock-button} 얀덱스 부팅 화면의 투명도를 켜고 끄려면 시계 ⏱️ 버튼을 누르세요: - **Mute Game loader** — 투명도가 꺼지며, 게임 시작 시 게임 아이콘이 중앙에 표시되는 부팅 화면이 나타납니다. - **Show Game loader** — 투명도가 켜지며, 게임 로딩 아이콘이 투명해집니다. 게임이 로딩되는 동안 무슨 일이 일어나는지 볼 수 있습니다. ### 도구 버튼 SDK mocks ⚒️ {#tools-button} #### **Choose Game Lang** 매개 변수 {#lang} 이 기능은 게임에 대해 자동으로 결정되는 언어를 변경할 수 있게 해줍니다. 작동 원리: 1. **Choose Game Lang**을 클릭하세요. 2. 드롭다운 목록에서 언어를 선택하세요. 3. 게임을 다시 시작하세요. 선택한 언어 값이 `environment.i18n.lang`에 적용됩니다. 언어를 자동 결정으로 돌리려면: 1. 언어로 표시된 매개변수를 선택하세요 (예: **En ![](../_images/debug-panel/choose-game-lang-arrow.svg)**). 2. 드롭다운 목록에서 **Choose Game Lang** 첫 번째 항목을 선택하세요. 3. 게임을 다시 시작하세요. #### 링크 아이콘: 🔗 **Game links mock is disabled** / 🔗 **Game links mock is enabled**. {#link-icon} 이 매개변수를 사용하여 [요구 사항 항목 8.4.1](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#8-4-1)의 준수 여부를 확인합니다. 검사 모드에서 다른 게임으로의 링크 대신 정적 페이지가 열리면 이 항목이 충족된 것으로 간주됩니다. 자세한 내용은 [검사 방법](https://yandex.com/dev/games/doc/ko/requirements/8/4/1.md)을 참조하세요. 검사 모드를 활성화하거나 비활성화하려면: 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**. {#eye-icon} 게임의 포커스를 해제하거나 다시 설정하려면 버튼을 누르세요. 이는 게임 디버깅 및 테스트에 유용합니다. #### 로켓 아이콘 또는 거북이 아이콘: 🚀 **Network throttling is disabled** / 🐢 **Network throttling is enabled**. {#rocket-turtle-icon} 로켓과 거북이는 서버로부터의 응답 대기 시간을 변경합니다. 다양한 모드 사이에서 전환하려면 이 버튼을 누르세요: - 로켓 모드에서는 서버로부터의 응답 대기 시간이 표준입니다. 게임이 정상 모드로 작동합니다. - 거북이 모드에서는 클라이언트가 서버로부터 즉시 응답을 요구합니다. 짧은 시간 내에 응답이 없으면 게임은 서버가 응답하지 않았다고 판단합니다. 이 모드는 인터넷 연결이 느린 환경에서 게임을 테스트하거나, SDK 서버가 시간 내에 응답하지 않을 경우 구매와 같은 오류를 에뮬레이션할 때 사용됩니다. #### 화폐 아이콘: 🪙 **Currency mock is disabled** / 🪙 **Currency mock is enabled**. {#currency-icon} 이 설정은 게임 내 화폐(yans이라는 이름과 아이콘)를 에뮬레이트합니다: - **Currency mock is disabled** — 아이콘과 통화 이름 yans은 표준입니다. - **Currency mock is enabled** — 게임 내 화폐의 이름과 아이콘이 [모크](*currency_mock)로 변경되어야 합니다. 만약: * 화폐의 이름과 아이콘이 엔으로 변경된 경우 — 게임이 SDK 메서드를 올바르게 사용하여 포털 화폐를 표시하고 있음을 의미합니다(요구사항 섹션 3.8을 준수함 [요구사항 3.8](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#3-8)); * 화폐의 이름과 아이콘이 엔으로 변경되지 않은 경우 — 게임에서 포털 화폐를 표시하기 위한 메서드를 사용하지 않고 있으며, [요구사항 3.8](https://yandex.com/dev/games/doc/ko/concepts/requirements.md#3-8)을 위반하고 있습니다. 이런 게임은 모더레이터에 의해 거부될 것입니다. 화폐의 이름과 아이콘을 [개발자 문서](https://yandex.com/dev/games/doc/ko/sdk/sdk-purchases.md#currency-designation)에 따라 명시해야 합니다. [*currency_mock]: 모의 화폐는 서버가 제공하는 테스트용 조건부 화폐입니다. 모더레이터들은 모의 화폐로 TST와 엔화 기호 ¥를 사용합니다.