Система владения играми
Как это работает
Система владения играми позволяет разработчику игр назначать пользователю право владения одной или несколькими играми.
Основные возможности:
- получение списка игр пользователя;
- предоставление права владения.
Для кого подходит
Для разработчиков игр, у которых есть минимум две игры — DRM-free и/или распространяемые через Steam.
Как настроить
Предварительные действия
- Зарегистрируйтесь в Личном кабинете Иксолла.
- Настройте модуль Игровые Ключи. В процессе настройки выберите DRM-free и/или Steam в блоке Информация о DRM.
Сценарий интеграции
- Реализуйте ручную или автоматическую активацию ключей пользователями, чтобы информация о владении игрой поступила в систему.
- Реализуйте методы API для работы с системой владения играми.
Ручная активация ключей
Ручную активацию DRM-free ключей можно реализовать:
- Через Лаунчер Иксолла.
- На лендинге через:
- JWT, если вы используете Авторизацию Иксолла;
- идентификатор пользователя, если вы используете собственную аутентификацию.
Активация Steam-ключей происходит в сервисе Steam, но вам необходимо реализовать методы API для добавления в систему прав доступа к игре.
Автоматическая активация ключей
Чтобы настроить автоматическую активацию DRM-free ключей:
- Добавьте аутентификацию пользователя перед покупкой. Ключ игры будет активирован для того пользователя, который прошел аутентификацию.
- Перейдите в Личный кабинет > Магазин > Настройки игровых ключей.
- Выберите необходимый пакет в списке игровых ключей.
- На вкладке Ключи и дистрибутивы включите параметр Активация ключей DRM-free.
- Добавьте параметр "is_activation_required": true в токен или access_data для покупки. Изучите подробное описание параметров и типов интеграции.
ПРИМЕР
- http
{
"purchase": {
"pin_codes": {
"codes": [
{
"digital_content": "test_pack2",
"drm": "drmfree",
"is_activation_required": true
}
]
}
},
"settings": {
"project_id": 17558
},
"user": {
"id": {
"value": "54AC70C177B6583F"
}
}
}
Аутентификация пользователя
Вы можете использовать Авторизацию Иксолла для аутентификации ваших пользователей, связывания аккаунтов Steam, игровой учетной записи и учетных записей в разных социальных сетях. Авторизация Иксолла работает с системой владения играми автоматически.
Если вы хотите использовать свою систему аутентификации, необходимо:
- Включить интеграцию через токен в Личном кабинете.
- Создать метод аутентификации.
- Добавить возможность связывать игровой аккаунт и Steam-аккаунт, если необходимо.
- Использовать Pay Station Access Token для вызова методов API. Обратите внимание, что для интеграции со Steam-аккаунтом необходимо передавать в токене параметр user.steam_id в формате SteamID64.
Интеграция со Steam
Чтобы проверять список игр пользователя в Steam, выполните следующие действия:
- Передайте аккаунт-менеджеру или специалисту по интеграции Иксолла свой appID (идентификатор игры) и ключ разработчика Steam.
- Реализуйте возможность связывать игровой аккаунт и аккаунт Steam.
При вызове методов API для предоставления доступа и получения списка игр пользователя Иксолла проверяет права доступа в Steam, чтобы исключить ситуации, когда пользователь сделал возврат покупки.