Документация Pixmove

Русский

English

Русский

English

Appearance

Процесс работы ​

Краткий обзор ​

Взаимодействие между Платформой (Партнером, Агрегатором игр) и Провайдером:

  • Platform API для Провайдера — описывает запросы от Провайдера к Платформе.
  • Provider API для Платформы — описывает запросы от Платформы к Провайдеру.

Игровой процесс ​

Открытие игры ​

  1. Игрок открывает страницу игры.
  2. Платформа отправляет запрос /game/init или /game/demo Провайдеру.
  3. Провайдер возвращает Платформе URL игры.
  4. Платформа использует полученный URL для открытия игры в iframe.
  5. Игрок начинает игру.

Игра ​

  1. В игре происходит событие (такое как получение баланса, ставка или выигрыш).
  2. Провайдер отправляет соответствующий запрос (/balance, /bet, /win) Платформе.
  3. Платформа обрабатывает событие и отвечает Провайдеру.
  4. Игрок продолжает игру.

Случаи неудачных запросов описаны в разделе Обработка ошибок и представлены ниже на диаграмме.

Диаграмма процесса ​


Игровой процессИгровой процесс

Фриспины ​

Реализация фриспинов не является обязательной для базовой интеграции — основной функционал платформы может работать без поддержки Freespins API.

Примечание

Если Платформа внедряет фриспины и ей необходима отправка /bet/win запросов для каждого отдельного спина, то Платформе следует заранее уведомить об этом инженера по интеграции.

Инженер по интеграции применит необходимые настройки для Платформы.

В реализации фриспинов используются две основные сущности - кампания фриспинов и фриспины. В рамках одной кампании фриспинов пользователю могут быть начислены только одни фриспины.

Кампания фриспинов - это общая промоакция, которую может создать партнер и по параметрам которой игрокам будут присвоены бесплатные вращения (фриспины).

Фриспины - это бесплатные вращения, которые будут начисляться игрокам при заходе в игру.

Создание кампании ​

  1. Платформа начисляет Игроку бонусные фриспины, создавая кампанию фриспинов через пользовательский интерфейс Платформы (или передавая запрос от Казино).

Примечание

При создании кампании Платформа должна убедиться, что установлен допустимый параметр betLevel.

Доступные уровни ставок можно получить через эндпоинт /bet-levels.

  1. Платформа отправляет запрос /freespins/create Провайдеру.
  2. Провайдер подтверждает успешный выпуск кампании фриспинов.

Отмена кампании ​

Отмена кампании также аннулирует и закрывает все текущие фриспины. Использование этой функции не рекомендуется, если игроки уже получили их.

  1. Платформа отменяет кампанию фриспинов через пользовательский интерфейс (или передает запрос от Казино).
  2. Платформа отправляет запрос /freespins/cancel Провайдеру.
  3. Провайдер подтверждает успешную отмену кампании фриспинов.

Игровой процесс ​

Примечание

Провайдер отправляет Платформе только один запрос /finish за бонусную игру с фриспинами. Провайдер не отправляет /bet и /win для каждого спина.

Если Платформа использует настройку /bet/win на каждый фриспин, Провайдер отправляет запросы /bet и /win для каждого спина и не отправляет запрос /finish вовсе.

  1. Игрок входит в игру.
  2. Система проверяет, соответствует ли игрок условиям кампании фриспинов (валюта, игра или конкретный идентификатор игрока).
    • Если игрок соответствует условиям, он получает фриспины.
    • В противном случае начинается обычный игровой процесс.

Бонусная игра с фриспинами не связана с реальным балансом Игрока. Вместо этого Игрок видит количество выданных фриспинов.

  1. Когда Игрок совершает спин, количество фриспинов уменьшается.
  2. Сумма выигрыша рассчитывается и накапливается на стороне Провайдера.
    • Если указан параметр maxWin, система проверяет, находится ли общая сумма в пределах лимита.
    • При достижении maxWin Провайдер завершает бонусную игру с фриспинами и отправляет запрос /finish (или последний /win) с суммой maxWin.
  3. Когда все фриспины сыграны, Провайдер отправляет запрос /finish Платформе с указанием общего выигрыша.
    • Если указан параметр minWin и общий выигрыш ниже этого значения, Провайдер отправляет запрос /finish (или последний /win) с суммой minWin.

Случаи неудачных запросов описаны в разделе Обработка ошибок и представлены на диаграмме обычного игрового процесса.

Диаграмма процесса ​


Процесс фриспиновПроцесс фриспинов

Обработка ошибок ​

  1. В игре происходит событие (такое как получение баланса, ставка, выигрыш или завершение раундов фриспинов).
  2. Провайдер отправляет соответствующий запрос (/balance, /bet, /win или /finish) Платформе.
  3. Платформа отвечает Провайдеру ошибкой.
  4. Провайдер отображает ошибку игроку.
  5. Если это был запрос /bet (из пункта 2), Провайдер отправляет запрос /refund (если ошибка не PlayerLowBalance).
  6. Если это был запрос /win или /finish, Провайдер повторяет запрос.
  7. Если это был запрос /refund и ошибка не BetNotFound, Провайдер повторяет запрос.

Значения по умолчанию

Тайм-аут запроса к Платформе не ограничен.

Интервалы между повторными попытками запроса (retry) в секундах: [8, 32, 64, 256, 1024, 4096, 16384, 65536]