Debug面板

Debug面板 — 这是一个工具,您可以通过它测试草稿:追踪SDK调用,模拟差的互联网连接,取消游戏的焦点,关闭Yandex的启动画面等等。

启用debug面板

  1. 打开 Yandex游戏控制台
  2. 选择所需的游戏。
  3. 在左上角点击 Open with debug panel
  1. 打开所需的游戏。
  2. 在浏览器地址栏末尾添加 &debug-mode=16

Debug面板将出现在游戏页面的左下角。

Debug面板的组成部分

加载器

加载器可以有以下值:

指示器

文本

含义

W

等待初始化。

IT

Is loader: true

SDK加载器正确初始化。

IF

Is loader: false

使用的是旧的加载器。请按照文档条款 1.19.1)载入SDK。

游戏就绪调用指示器

将鼠标悬停在指示器上,以了解游戏中的SDK状态和LoadingAPI.ready()方法调用的时刻(条款1.19.2)。可能是蓝色、绿色或红色:

指示灯

文本

含义

闪烁蓝色

SDK is not initialized. Wait for "unit" call.

游戏等待SDK初始化。

闪烁蓝色

The game has initialized the SDK. Waiting for call "ready".

游戏已初始化SDK,现在等待调用方法LoadingAPI.ready()。Game Ready等待时间 – 90秒。

变为绿色

The game called ready after … ms.

方法LoadingAPI.ready()在指定的毫秒数后被调用。

变为红色

"ready" called on timeout.

游戏中的Game Ready在等待90秒后未被调用。在这种情况下,认为游戏中未使用Game Ready。

为什么会显示“SDK is not defined”的错误,尽管Game Ready指示器显示SDK已经初始化了?

重要的是要正确初始化 SDK:/sdk.js 脚本必须在执行 YaGames.init() 之前被加载。Game Ready 指示器仅注册 SDK 是否已经在游戏中安装,是否已连接所需的脚本。

播放按钮 ▶️

播放按钮是游戏活动的指示器。通过game_api_pause/game_api_resume事件,平台通知游戏何时应该暂停或继续游戏体验。

点击按钮以模拟事件操作:

  • ▶️ — 游戏在焦点中,游戏过程正在进行。
  • ⏸️ — 游戏不在焦点中,购物窗口打开或正在显示广告。

游戏手柄按钮 🎮

游戏手柄按钮 🎮 模拟使用 SDK 方法 GameplayAPI.start()GameplayAPI.stop()第1.19.3条)。按下它以在以下状态之间切换:

  • 白色背景 (默认)— 游戏中未使用游戏玩法。
  • 绿色背景 — 游戏玩法正在进行中。
  • 红色背景 — 游戏玩法已暂停。

按钮⏱️

点击⏱️图标,可切换打开或关闭 Yandex 启动屏幕的透明度:

  • 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. 重新加载游戏。

通过这个参数可以检查是否符合要求项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。此类游戏将被审核员拒绝。需要按照开发者文档来标明货币的名称和图标。

模拟货币是服务器用于测试的一种假定货币。审核员使用的模拟货币是TST,货币图标为日元符号¥。