SDK方法

需求条目1.19

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

SDK的初始化必须严格按照安装和使用页面所述进行。
当用户可以开始玩游戏时，必须调用Game Ready中的LoadingAPI.ready()方法。
使用游戏玩法标记是可选的，但如果在游戏中使用了 GameplayAPI.start() 和 GameplayAPI.stop() 方法，则事件发送的时机必须严格符合游戏玩法节中的描述。
跟踪 game_api_pause 和 game_api_resume 事件是可选的，但如果游戏中使用了 ysdk.on() 和 ysdk.off() 方法，那么事件处理逻辑必须严格遵循在游戏暂停与恢复事件部分所描述的。

SDK初始化

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

检查加载器的更新性

使用debug面板启动游戏。
通过开发者控制台

通过地址栏
1. 打开 Yandex游戏控制台。
2. 选择所需的游戏。
3. 在左上角点击 Open with debug panel。
1. 打开所需的游戏。
2. 在浏览器地址栏末尾添加 &debug-mode=16。
已复制
在Game Ready指示器的左侧，找到两个字母：
- IF (init false) — 游戏支持旧加载器。将光标悬停在 IF上时，会显示_Is loader: false_。
- IT (init true) — 游戏支持新加载器。将光标悬停在 IT上时，会显示_Is loader: true_。

示例

加载器	评论
	旧加载器。在debug面板显示`IF`。
	旧加载器。在debug面板显示`IF`。
	新加载器。在debug面板显示`IT`。
	新加载器。在debug面板显示`IT`。

游戏准备就绪

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

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

游戏准备就绪的检查逻辑

准备工作

用debug面板启动游戏。
通过开发者控制台

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

检查的一般原则

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

游戏准备就绪工作正确

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

菜单可用时；
当游戏可供交互时（包括初始动画）。

游戏就绪	评论
	绿色指示器在菜单可用时出现。
	绿色指示器在菜单可用时出现。
	绿色指示器在菜单可用时出现。
	当游戏可供交互时，会出现绿色指示灯。
	当游戏可供交互时，会出现绿色指示灯。
	当游戏可供交互时，会出现绿色指示灯。

游戏就绪工作异常

蓝色指示器变成了绿色：

在游戏可供交互之前（存在进度条、加载动画、黑屏等情况）；
在游戏准备好交互几秒钟后。

游戏就绪	评论
	在游戏可供交互之前，绿色指示灯就会亮起。
	在游戏可供交互之前，绿色指示灯就会亮起。
	在游戏可供交互之前，绿色指示灯就会亮起。
	绿色指示灯在游戏可以交互几秒后才出现。
	绿色指示灯在游戏可以交互几秒后才出现。

游戏就绪未集成

指示器在90秒后变成红色。

游戏就绪	评论
	指示器变成红色 — 游戏就绪未集成。

游戏玩法标记

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

检查游戏玩法标记

准备工作

使用 debug面板启动游戏。
通过开发者控制台

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

检查的一般原则

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

当玩家开始游戏过程或在暂停后恢复时，应调用 GameplayAPI.start() 方法。游戏玩法指示器应变绿 — 表示游戏正在进行中。
当玩家结束游戏过程或将其暂停时，应调用 GameplayAPI.stop() 方法。游戏玩法指示器应变红 — 表示游戏已暂停。

检查时考虑的情况：

启动和结束关卡。
打开和关闭游戏菜单。
打开和关闭购买菜单。
启动和关闭广告。
游戏失去焦点并返回游戏（切换到另一个浏览器标签页或另一个窗口）。

提示

要了解焦点的位置（在游戏上还是在另一个窗口），请跟踪事件 game_api_resume 和 game_api_pause。

游戏玩法标注正确

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

游戏	评论
	在新一关的开始时，指示器为绿色。
	关卡结束，指示器变为红色。
	在进入菜单后再返回游戏时，指示器颜色会发生变化。
	在进入菜单后再返回游戏时，指示器颜色会发生变化。
	在进入购买菜单后再返回游戏时，指示器颜色会发生变化。
	广告关闭后，指示器颜色从红色变成绿色。
	当从浏览器标签页切换到另一个窗口然后返回游戏时，指示器颜色会发生变化。

游戏玩法标注不正确

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

游戏	评论
	关卡结束，指示器颜色未从绿色变为红色。
	在进入菜单时，指示器颜色未从绿色变为红色。
	广告关闭后，指示器颜色未从红色变为绿色。
	当从浏览器标签页切换到另一个窗口时，指示器颜色不发生变化。

联系审核

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

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

打开表单

这篇文章是否有用？

基本违规

游戏机制