事件
游戏下载
Yandex Games在全球范围内运行,因此收集统计数据对于提高游戏加载速度和可用性至关重要。例如,我们会根据这些数据决定在哪里部署新的数据中心。
了解游戏何时被加载,将使我们能够添加新的功能,如显示所有游戏共用的加载屏幕、游戏截图或评论。这将提升游戏的吸引力。
ysdk.features.LoadingAPI.ready()
当游戏加载所有资源并准备好与用户互动时,应调用方法 ysdk.features.LoadingAPI.ready()
。
确保游戏调用此方法时:
- 所有元素都准备好与玩家互动;
- 没有加载屏幕。
示例
使用 await 的版本
不用 await 的版本
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()
。
示例
使用 await 的版本
不用 await 的版本
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 方面的问题或有其他问题想要咨询,请联系支持部门:
已复制