服务器时间
Yandex Games SDK 允许获取与服务器同步的时间。这个方法对于以下场景非常有用：
- 防止作弊：用户无法通过更改设备上的时间来影响游戏过程。
- 游戏事件：您可以基于此添加活动和奖励，对于这些活动和奖励，一个可靠的时间来源非常重要，例如：每日或每周奖励、季节性事件和任务。
ysdk.serverTime()
该方法返回一个 timestamp，即以毫秒为单位的服务器时间，对所有设备来说都是一致的。它类似于 Date.now() 的结果格式，但后者返回的是用户设备的时间，可能与服务器时间不同，且不能防止玩家的作弊行为。ysdk.serverTime() 方法能够有效防止设备系统时间被人为篡改，因此更加可靠。
每当您需要获取当前时间时，就调用它。
使用 await 的选项
不使用 await 的选项
1const ysdk = await YaGames.init();
2
3 // 返回与服务器同步的毫秒时间。
4 ysdk.serverTime(); // 例如，1720613073778。
5
6 // 一段时间后再次调用。
7 ysdk.serverTime(); // 例如，1720613132635。
1YaGames.init().then(ysdk => {
2
3 // 返回与服务器同步的时间（以毫秒为单位）。
4 ysdk.serverTime(); // 例如，1720613073778。
5
6 // 一段时间后再次调用。
7 ysdk.serverTime(); // 例如，1720613132635。
8});
每日奖励实现示例
- 使用
ysdk.serverTime()获取可靠的服务器时间。 - 通过 player.setData() 保存数据。
- 实现了防止重复领取奖励的保护机制。
- 以安全的方式对时间进行比较。
重要
示例中的 giveReward() 函数是你自行实现的，负责发放玩家奖励。
距上次登录游戏后24小时获得奖励
1YaGames.init().then(async ysdk => {
2 // 初始化玩家。
3 const player = await ysdk.getPlayer();
4
5 // 获取已保存的数据。
6 const data = await player.getData();
7
8 // 当前服务器时间。
9 const currentTime = ysdk.serverTime();
10
11 // 上次领取奖励的时间（如果没有，则使用0）。
12 const lastRewardTime = data.lastRewardTime || 0;
13
14 // 24小时的毫秒数。
15 const DAY_IN_MS = 24 * 60 * 60 * 1000;
16
17 if (currentTime - lastRewardTime >= DAY_IN_MS) {
18 // 已经过了24小时，可以发放奖励。
19 await giveReward(); // 您的奖励发放函数。
20
21 // 保存新的领奖时间。
22 await player.setData({
23 lastRewardTime: currentTime
24 });
25 }
26});
奖励每天（UTC时间午夜重置一次）
1YaGames.init().then(async ysdk => {
2 // 初始化玩家。
3 const player = await ysdk.getPlayer();
4
5 // 获取已保存的数据。
6 const data = await player.getData();
7
8 // 当前服务器时间。
9 const currentTime = ysdk.serverTime();
10
11 // 获取上次领奖日期，格式为 "YYYY-MM-DD"。
12 const lastRewardDate = data.lastRewardDate || '';
13
14 // 获取当前日期，格式为 "YYYY-MM-DD"。
15 const currentDate = new Date(currentTime).toISOString().split('T')[0];
16
17 if (currentDate !== lastRewardDate) {
18 // 今天还没有领取奖励。
19 await giveReward(); // 您的奖励发放函数。
20
21 // 保存领奖日期。
22 await player.setData({
23 lastRewardDate: currentDate
24 });
25 }
26});
备注
技术支持团队将协助您将已完成的游戏发布到 Yandex 游戏平台。关于开发和测试方面的具体问题，其他开发人员将在Discord 频道中进行回答。
如果您遇到 Yandex Games SDK 方面的问题或有其他问题想要咨询，请联系支持部门：