Перейти к основному содержимому

Подборки игр

Обзор

С GamePush вы можете показать игроку список своих игр. Откроется оверлей со списком игр, доступных на текущей площадке.

Чтобы игра была видна в списке на платформе, вам необходимо:

  1. Зайти в настройки игры и отметить все площадки, на которых игра уже опубликована. Это можно сделать в поле Опубликована на платформах в разделе Публичная зона.

  1. На площадках, не поддерживающих внутренние URL - добавьте в игру публичный URL. Это можно сделать в поле Публичный URL игры в разделе Настройки проекта.

Некоторые платформы разрешают обмен ссылками только внутри платформы. Ниже представлена таблица типов ссылок.

ПлощадкаТип ссылки
Yandex.Games✅ Внутренняя
VK Games✅ Внутренняя
VK Play✅ Внутренняя
OK Games✅ Внутренняя
Kongregate✅ Внутренняя
PlayDeck✅ Внутренняя
GooglePlay💡 Внешняя (Public URL)
CrazyGames💡 Внешняя (Public URL)
GameMonetize💡 Внешняя (Public URL)
GameDestribution❌ Запрещено
GamePix❌ Запрещено
WG Playground❌ Запрещено
POKI❌ Запрещено
SmartMarket❌ Нет механизма шаринга, нельзя получить URL игры (ждем возможности)
info

💡 Внешняя (Public URL) - игра будет отображаться только в том случае, если в игре указан публичный URL.

tip

Вы можете создавать любые подборки на странице Games Dashboard.

Показать подборку игр

+1 Request

Открыть оверлей со всеми играми, отсортированными по новизне

gp.gamesCollections.open();

//Или открыть по тегу "ALL"
gp.gamesCollections.open({ tag: 'ALL' });

Открыть оверлей с играми из специальной подборки по ID или TAG

// Открыть по тэгу
gp.gamesCollections.open({ tag: 'HALLOWEEN_GAMES' });

// Открыть по ID
gp.gamesCollections.open({ id: 547 });

Открыть оверлей с играми с дополнительными параметрами для шаринга. Например, указать ID игрока или награду за переход. Параметры передаются в формате { "key": "value" }.

gp.gamesCollections.open({
tag: 'HALLOWEEN_GAMES',
shareParams: {
playerId: gp.player.id,
fromGame: gp.projectId,
fromPlatform: gp.platform.type,
fromUrl: gp.app.url,
},
});

События открытия подборки

// Открытие оверлея
gp.gamesCollections.on('open', () => {});

// Закрытие оверлея
gp.gamesCollections.on('close', () => {});

Получение подборки игр

+1 Request

Получить все игры отсортированные по новизне

gp.gamesCollections.fetch();

//Или открыть по тегу "ALL"
gp.gamesCollections.fetch({ tag: 'ALL' });

Получить игры из специальной подборки по ID или TAG

// По тэгу
gp.gamesCollections.fetch({ tag: 'HALLOWEEN_GAMES' });

// По ID
gp.gamesCollections.fetch({ id: 547 });

Получение с promises

const result = await gp.gamesCollections.fetch();

// Ответ
const {
// ID подборки
id,
// Тег подборки
tag,
// Имя подборки
name,
// Описание подборки
description,
// Список игр в подборкe
games,
} = result;

События получения подборки игр

// Успешное получение
gp.gamesCollections.on('fetch', (result) => {});

/**
* Ошибка при получении
* @type {
* 'not_found' |
* undefined
* }
*/
gp.gamesCollections.on('error:fetch', (error) => {});

Поля подборки

/**
* ID Подборки
* @type {number}
*/
collection.id;

/**
* Необязательный тег для помощи при выборе
* Вы можете использовать его вместо ID
* @type {string}
*/
collection.tag;

/**
* Название, переведенное на язык пользователя
* @type {string}
*/
collection.name;

/**
* Описание, переведенное на язык пользователя
* @type {string}
*/
collection.description;

/**
* Список игры в коллекции (отсортированный)
* @type {GamePreview[]}
*/
collection.games;

Поля игры

/**
* ID Игры
* @type {number}
*/
game.id;

/**
* Название, переведенное на язык пользователя
* @type {string}
*/
game.name;

/**
* Описание, переведенное на язык пользователя
* @type {string}
*/
game.description;

/**
* Ссылка на иконку размером 256x256
* @type {string}
*/
game.icon;

/**
* URL на платформе или публичный URL игры
* @type {string}
*/
game.url;

Оставайтесь на связи

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: [email protected]

Желаем вам успехов!