Серверное время
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()
2 .then((ysdk) => {
3 // Возвращает время в мс, синхронизированное с сервером.
4 ysdk.serverTime(); // Например, 1720613073778.
5
6 // Спустя время вызываем еще раз.
7 ysdk.serverTime(); // Например, 1720613132635.
8 });
Примеры реализации ежедневных наград
- Используется
ysdk.serverTime()для получения надежного серверного времени. - Данные сохраняются через player.setData().
- Реализована защита от повторного получения награды.
- Время сравнивается безопасным способом.
Важно
Функция giveReward() в примерах — это ваша реализация начисления награды игроку.
Награда спустя 24 часа после последнего посещения игры
1YaGames.init()
2 .then(async (ysdk) => {
3 // Инициализация игрока.
4 const player = await ysdk.getPlayer();
5
6 // Получаем сохраненные данные.
7 const data = await player.getData();
8
9 // Текущее серверное время.
10 const currentTime = ysdk.serverTime();
11
12 // Время последнего получения награды (если нет, используем 0).
13 const lastRewardTime = data.lastRewardTime || 0;
14
15 // 24 часа в миллисекундах.
16 const DAY_IN_MS = 24 * 60 * 60 * 1000;
17
18 if (currentTime - lastRewardTime >= DAY_IN_MS) {
19 // Прошло более 24 часов — можно выдать награду.
20 await giveReward(); // Ваша функция начисления награды.
21
22 // Сохраняем новое время получения награды.
23 await player.setData({
24 lastRewardTime: currentTime
25 });
26 }
27 });
Награда один раз в календарные сутки (сброс в полночь по UTC)
1YaGames.init()
2 .then(async (ysdk) => {
3 // Инициализация игрока.
4 const player = await ysdk.getPlayer();
5
6 // Получаем сохраненные данные.
7 const data = await player.getData();
8
9 // Текущее серверное время.
10 const currentTime = ysdk.serverTime();
11
12 // Получаем дату последней награды в формате "YYYY-MM-DD".
13 const lastRewardDate = data.lastRewardDate || '';
14
15 // Получаем текущую дату в формате "YYYY-MM-DD".
16 const currentDate = new Date(currentTime).toISOString().split('T')[0];
17
18 if (currentDate !== lastRewardDate) {
19 // Сегодня награда еще не была получена.
20 await giveReward(); // Ваша функция начисления награды.
21
22 // Сохраняем дату получения награды.
23 await player.setData({
24 lastRewardDate: currentDate
25 });
26 }
27 });
Примечание
Сотрудники службы поддержки помогают разместить готовую игру на платформе Яндекс Игр. На прикладные вопросы о разработке и тестировании предметно ответят другие разработчики в сообществе в Телеграме и в сообществе ВКонтакте.
Если при использовании SDK Яндекс Игр вы столкнулись с проблемой или у вас появился вопрос, обратитесь в службу поддержки: