SDK方法

需求条目1.19

SDK Yandex Games 的初始化及其方法的使用必须严格遵循文档和游戏要求:

  1. SDK的初始化必须严格按照安装和使用页面所述进行。

  2. 当用户可以开始玩游戏时,必须调用Game Ready中的LoadingAPI.ready()方法。

  3. 使用游戏玩法标记是可选的,但如果在游戏中使用了 GameplayAPI.start()GameplayAPI.stop() 方法,则事件发送的时机必须严格符合游戏玩法节中的描述。

  4. 跟踪 game_api_pausegame_api_resume 事件是可选的,但如果游戏中使用了 ysdk.on()ysdk.off() 方法,那么事件处理逻辑必须严格遵循在 游戏暂停与恢复事件 部分所描述的。

SDK初始化

1.19.1. SDK的初始化必须严格按照安装和使用页面所述进行。要满足该要求,必须使用最新的加载器。

检查加载器的更新性

  1. 使用debug面板启动游戏。

    1. 打开 Yandex游戏控制台
    2. 选择所需的游戏。
    3. 在左上角点击 Open with debug panel
    1. 打开所需的游戏。
    2. 在浏览器地址栏末尾添加 &debug-mode=16
  2. 在Game Ready指示器的左侧,找到两个字母:

    • IF (init false) — 游戏支持旧加载器。将光标悬停在 IF上时,会显示_Is loader: false_。

    • IT (init true) — 游戏支持新加载器。将光标悬停在 IT上时,会显示_Is loader: true_。

示例

加载器

评论

旧加载器。在debug面板显示IF

旧加载器。在debug面板显示IF

新加载器。在debug面板显示IT

新加载器。在debug面板显示IT

Game Ready

1.19.2. 当用户已经可以开始游戏时,请调用LoadingAPI.ready()方法,从Game Ready进行。

为了要求被认为是满足的,LoadingAPI.ready()方法必须在正确的时刻被调用。

Game Ready的检查逻辑

准备工作

  1. 用debug面板启动游戏。

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

检查的一般原则

  1. 检查蓝色指示器 是否在90秒内变为绿色
  2. 重启游戏。
  3. 重新检查指示器颜色何时变化。

Game Ready工作正确

蓝色指示器 在以下时刻变为绿色

  • 菜单可用时;

  • 当游戏可供交互时(包括初始动画)。

Game Ready

评论

绿色指示器在菜单可用时出现。

绿色指示器在菜单可用时出现。

绿色指示器在菜单可用时出现。

当游戏可供交互时,会出现绿色指示灯。

当游戏可供交互时,会出现绿色指示灯。

当游戏可供交互时,会出现绿色指示灯。

Game Ready工作异常

蓝色指示器 变成了绿色

  • 在游戏可供交互之前(存在进度条、加载动画、黑屏等情况);

  • 在游戏准备好交互几秒钟后。

Game Ready

评论

在游戏可供交互之前,绿色指示灯就会亮起。

在游戏可供交互之前,绿色指示灯就会亮起。

在游戏可供交互之前,绿色指示灯就会亮起。

绿色指示灯在游戏可以交互几秒后才出现。

绿色指示灯在游戏可以交互几秒后才出现。

Game Ready未集成

指示器在90秒后变成红色

Game Ready

评论

指示器变成红色 — Game Ready未集成。

游戏玩法标记

1.19.3. GameplayAPI.start()GameplayAPI.stop() 方法允许标记游戏过程的开始和停止。如果在游戏中使用它们,那么事件发送的时刻将严格对应于 游戏玩法 部分中的描述。

检查游戏玩法标记

准备工作

  1. 使用 debug面板 启动游戏。

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

检查的一般原则

根据行动追踪游戏玩法指示器的状态:

  • 当玩家开始游戏过程或在暂停后恢复时,应调用 GameplayAPI.start() 方法。游戏玩法指示器应变绿 — 表示游戏正在进行中。

  • 当玩家结束游戏过程或将其暂停时,应调用 GameplayAPI.stop() 方法。游戏玩法指示器应变红 — 表示游戏已暂停。

检查时考虑的情况:

  • 启动和结束关卡。

  • 打开和关闭游戏菜单。

  • 打开和关闭购买菜单。

  • 启动和关闭广告。

  • 游戏失去焦点并返回游戏(切换到另一个浏览器标签页或另一个窗口)。

提示

要了解焦点的位置(在游戏上还是在另一个窗口),请跟踪 事件 game_api_resumegame_api_pause

游戏玩法标注正确

指示器颜色会根据不同的场景变化。

游戏

评论

在新一关的开始时,指示器为绿色。

关卡结束,指示器变为红色。

在进入菜单后再返回游戏时,指示器颜色会发生变化。

在进入菜单后再返回游戏时,指示器颜色会发生变化。

在进入购买菜单后再返回游戏时,指示器颜色会发生变化。

广告关闭后,指示器颜色从红色变成绿色。

当从浏览器标签页切换到另一个窗口然后返回游戏时,指示器颜色会发生变化。

游戏玩法标注不正确

指示器颜色不会根据不同的场景变化。

游戏

评论

关卡结束,指示器颜色未从绿色变为红色。

在进入菜单时,指示器颜色未从绿色变为红色。

广告关闭后,指示器颜色未从红色变为绿色。

当从浏览器标签页切换到另一个窗口时,指示器颜色不发生变化。

联系审核

如果您认为自己正确使用了 SDK 方法并且您的游戏被错误地下架或未通过审核 — 请填写下面的表格。

审核质量控制服务将重新检查决定并在游戏被不公平地封锁的情况下恢复它。

打开表单
上一篇
下一篇