事件

游戏下载

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

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

ysdk.features.LoadingAPI.ready()

当游戏加载所有资源并准备好与用户互动时,应调用方法 ysdk.features.LoadingAPI.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() 事件后,游戏进程已经停止。

重要

在恢复游戏进程时,再次调用方法 ysdk.features.GameplayAPI.start()

示例

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 游戏平台。关于开发和测试方面的具体问题,其他开发人员将在Discord 频道中进行回答。

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

发送电子邮件
下一篇