事件

游戏下载

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

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

ysdk.features.LoadingAPI.ready()

当游戏加载所有资源并准备好与用户互动时，应调用方法 ysdk.features.LoadingAPI.ready()。

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

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

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

示例

const ysdk = await YaGames.init();

// 通知平台，游戏已加载完毕，可以开始游戏。
ysdk.features.LoadingAPI?.ready()

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

游戏玩法

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

ysdk.features.GameplayAPI.start()

在玩家开始或恢复游戏进程的情况下，应调用方法 ysdk.features.GameplayAPI.start()：

• 级别启动；
• 菜单关闭；
• 游戏暂停后继续；
• 广告播放后游戏恢复；
• 返回至当前浏览器标签页。

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

ysdk.features.GameplayAPI.stop()

在玩家暂停或结束游戏进程的情况下，应调用方法 ysdk.features.GameplayAPI.stop()：

• 通过级别或失败；
• 调用菜单；
• 游戏暂停；
• 显示全屏或激励视频广告；
• 切换到另一个浏览器标签页。

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

示例

const ysdk = await YaGames.init();

// 通知游戏开始。
ysdk.features.GameplayAPI?.start()

// 游戏进程活跃。

// 通知游戏停止：
// 玩家进入菜单、通过级别或计划显示广告。
ysdk.features.GameplayAPI?.stop()

YaGames.init()
    .then((ysdk) => {
        // 通知游戏开始。
        ysdk.features.GameplayAPI?.start()

        // 游戏进程活跃。

        // 通知游戏停止：
        // 玩家进入菜单、通过级别或计划显示广告。
        ysdk.features.GameplayAPI?.stop()
    });

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