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。

Game Ready调用指示器

将鼠标悬停在指示器上,以了解游戏中的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。此类游戏将被审核员拒绝。需要按照开发者文档来标明货币的名称和图标。

云按钮 ☁️

云按钮 ☁️ 的状态表示游戏如何通过 Yandex Games SDK 使用云存档。

背景

文本

含义

Cloud data.

默认状态。

Cloud data has been read.

已记录玩家数据的读取。

Cloud data has been saved.

已记录玩家数据的保存。

Cloud data is not used.

90秒内没有发生任何事件。未使用云存档。

点击按钮时,标签页会重新加载,但游戏的静态文件会从另一个域获取。

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