Система владения играми

Как это работает

Система владения играми позволяет разработчику игр назначать пользователю право владения одной или несколькими играми.

Основные возможности:

  • получение списка игр пользователя;
  • предоставление права владения.

Для кого подходит

Для разработчиков игр, у которых есть минимум две игры — DRM-free и/или распространяемые через Steam.

Как настроить

Предварительные действия

  1. Зарегистрируйтесь в Личном кабинете Иксолла.
  2. Настройте модуль Игровые Ключи. В процессе настройки выберите DRM-free и/или Steam в блоке Информация о DRM.

Сценарий интеграции

  1. Реализуйте ручную или автоматическую активацию ключей пользователями, чтобы информация о владении игрой поступила в систему.
  2. Реализуйте методы API для работы с системой владения играми.

Note:
Когда настройка модуля Игровые ключи в Личном Кабинете завершена, пользователи, которые активировали ключ, будут автоматически добавлены в систему. Если ключ деактивируется, игра для пользователя помечается как неактивная.

Ручная активация ключей

Ручную активацию DRM-free ключей можно реализовать:

  1. Через Лаунчер Иксолла.
  2. На лендинге через:

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

Автоматическая активация ключей

Чтобы настроить автоматическую активацию DRM-free ключей:

  1. Добавьте аутентификацию пользователя перед покупкой. Ключ игры будет активирован для того пользователя, который прошел аутентификацию.
  2. Перейдите в Личный кабинет > Магазин > Настройки игровых ключей.
  3. Выберите необходимый пакет в списке игровых ключей.
  4. На вкладке Ключи и дистрибутивы включите параметр Активация ключей DRM-free.
  5. Добавьте параметр "is_activation_required": true в токен или access_data для покупки. Изучите подробное описание параметров и типов интеграции.

ПРИМЕР

Copy
Full screen
Small screen
{
    "purchase": {
        "pin_codes": {
            "codes": [
                {
                    "digital_content": "test_pack2",
                    "drm": "drmfree",
                    "is_activation_required": true
                }
            ]
        }
    },
    "settings": {
        "project_id": 17558
    },
    "user": {
        "id": {
            "value": "54AC70C177B6583F"
        }
    }
}

Аутентификация пользователя

Вы можете использовать Авторизацию Иксолла для аутентификации ваших пользователей, связывания аккаунтов Steam, игровой учетной записи и учетных записей в разных социальных сетях. Авторизация Иксолла работает с системой владения играми автоматически.

Если вы хотите использовать свою систему аутентификации, необходимо:

  1. Включить интеграцию через токен в Личном кабинете.
  2. Создать метод аутентификации.
  3. Добавить возможность связывать игровой аккаунт и Steam-аккаунт, если необходимо.
  4. Использовать Pay Station Access Token для вызова методов API. Обратите внимание, что для интеграции со Steam-аккаунтом необходимо передавать в токене параметр user.steam_id в формате SteamID64.

Интеграция со Steam

Чтобы проверять список игр пользователя в Steam, выполните следующие действия:

  1. Передайте аккаунт-менеджеру или специалисту по интеграции Иксолла свой appID (идентификатор игры) и ключ разработчика Steam.
  2. Реализуйте возможность связывать игровой аккаунт и аккаунт Steam.

При вызове методов API для предоставления доступа и получения списка игр пользователя Иксолла проверяет права доступа в Steam, чтобы исключить ситуации, когда пользователь сделал возврат покупки.

Note:
Проверка прав в Steam выполняется один раз в 24 часа, поскольку в Steam есть ограничение на количество запросов.