游戏加载与玩法标记

游戏加载

Yandex Games在全球范围内运行，因此收集统计数据对于提高游戏加载速度和可用性至关重要。例如，我们会根据这些数据决定在哪里部署新的数据中心。

了解游戏何时被加载，将使我们能够添加新的功能，如显示所有游戏共用的加载屏幕、游戏截图或评论。这将提升游戏的吸引力。

ysdk.features.LoadingAPI.ready()

当游戏加载完所有资源并准备好与用户互动时，需要调用此方法。

确保在游戏中从 Game Ready 调用方法时：

• 所有元素都已准备好与玩家互动。
• 没有加载屏幕。

可以在 DevTools 中的 Performance 选项卡中跟踪 Game Ready 指标。

示例

1const ysdk = await YaGames.init();
2
3// 通知平台，游戏已加载完毕，可以开始游戏。
4ysdk.features.LoadingAPI?.ready()

1YaGames.init()
2    .then((ysdk) => {
3        // 通知平台，游戏已加载完毕，可以开始游戏。
4        ysdk.features.LoadingAPI?.ready()
5    })
6    .catch(console.error);

游戏玩法

对我们来说，了解用户何时以及如何与游戏互动非常重要。为此，SDK 中有专用方法，用于标记游戏进程的开始和停止。使用这些方法将帮助我们提高目录中的推荐精度，将游戏推广到更多平台，并在开发人员控制台中生成额外的指标。

ysdk.features.GameplayAPI.start()

当玩家开始或恢复游戏进程时，需要调用此方法。此类情况包括：

• 启动关卡。
• 关闭菜单。
• 取消暂停。
• 广告播放后恢复游戏。
• 返回至当前浏览器标签页。

确保在发送 GameplayAPI.start() 事件后，游戏进程立即开始。

ysdk.features.GameplayAPI.stop()

当玩家暂停或结束游戏进程时，需要调用此方法。此类情况包括：

• 通过关卡或失败。
• 打开菜单。
• 暂停游戏。
• 显示全屏或 rewarded 广告。
• 切换到另一个浏览器标签页。

确保在发送 GameplayAPI.stop() 事件后，游戏进程已经停止。

示例

 1const ysdk = await YaGames.init();
 2
 3// 通知游戏进程开始。
 4ysdk.features.GameplayAPI?.start()
 5
 6// 游戏进程处于活跃状态。
 7
 8// 通知游戏进程停止：
 9// 玩家进入菜单、通过关卡或计划显示广告。
10ysdk.features.GameplayAPI?.stop()

 1YaGames.init()
 2    .then((ysdk) => {
 3        // 通知游戏进程开始。
 4        ysdk.features.GameplayAPI?.start()
 5
 6        // 游戏进程处于活跃状态。
 7
 8        // 通知游戏进程停止：
 9        // 玩家进入菜单、通过关卡或计划显示广告。
10        ysdk.features.GameplayAPI?.stop()
11    });

如果您遇到 Yandex Games SDK 方面的问题或有其他问题想要咨询，请联系支持部门：