Серверное время
SDK Яндекс Игр позволяет получить время, синхронизированное с сервером. Метод полезен для:
- Защиты от накруток: пользователи не смогут влиять на игровые процессы, изменяя время на своем устройстве.
- Игровых событий: на его базе вы можете добавлять активности и награды, для которых важен доверенный источник времени (например, ежедневные или еженедельные бонусы, сезонные события и квесты).
ysdk.serverTime()
Метод возвращает timestamp, серверное время в миллисекундах, одинаковое на всех устройствах. Он похож на Date.now() форматом результата, однако последний возвращает время устройства пользователя, которое может отличаться от серверного и не защищено от накруток со стороны игроков. Метод ysdk.serverTime() устойчив к накрутке системного времени на устройстве, что делает его более надежным.
Вызывайте его каждый раз, когда вам требуется получить актуальное время.
1const ysdk = await YaGames.init();
2
3// Возвращает время в мс, синхронизированное с сервером.
4ysdk.serverTime(); // Например, 1720613073778.
5
6// Спустя время вызываем еще раз.
7ysdk.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});
Примечание
Сотрудники службы поддержки помогают разместить готовую игру на платформе Яндекс Игр. На прикладные вопросы о разработке и тестировании предметно ответят другие разработчики в Сообществе в Телеграме.
Если при использовании SDK Яндекс Игр вы столкнулись с проблемой или у вас появился вопрос, обратитесь в службу поддержки: