Подборки игр

Обзор

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

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

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

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

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

Platform	Link Type
Yandex.Games	✅ Внутренняя
VK Games	✅ Внутренняя
VK Play	✅ Внутренняя
OK Games	✅ Внутренняя
CrazyGames	💡 Внешняя (Public URL)
GameMonetize	💡 Внешняя (Public URL)
GameDestribution	❌ Запрещено
GamePix	❌ Запрещено
POKI	❌ Запрещено
SmartMarket	❌ Нет механизма шаринга, нельзя получить URL игры (ждем возможности)

info

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

tip

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

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

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

gp.gamesCollections.open();

// Or by tag "ALL"
gp.gamesCollections.open({ tag: 'ALL' });

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

// By custom TAG
gp.gamesCollections.open({ tag: 'HALLOWEEN_GAMES' });

// By ID
gp.gamesCollections.open({ id: 547 });

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

// Overlay opened
gp.gamesCollections.on('open', () => {});

// Overlay closed
gp.gamesCollections.on('close', () => {});

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

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

gp.gamesCollections.fetch();

// Or by tag "ALL"
gp.gamesCollections.fetch({ tag: 'ALL' });

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

// By custom TAG
gp.gamesCollections.fetch({ tag: 'HALLOWEEN_GAMES' });

// By 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]

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