Чтобы интегрировать игру с игровыми сервисами Google Play, сначала необходимо настроить аутентификацию на платформе. Это необходимо для доступа ко всем остальным функциям, таким как достижения, таблицы лидеров и события.
Чтобы соответствовать рекомендациям Google Play Games Level Up по пользовательскому опыту , ваша игра должна соответствовать рекомендуемому процессу аутентификации .
Инициализация и аутентификация
Это обязательный шаг для инициализации и аутентификации вашей игры:
- Реализуйте аутентификацию платформы, инициализировав Play Games Services v2 SDK при запуске. Подробнее см. в статье «Аутентификация платформы для игр Android» . Это обязательный шаг для доступа к функциям Play Games Services, таким как достижения и таблицы лидеров.
- Аутентификация выполняется как тихий фоновый процесс во время запуска игры.
Существующие пользователи Play Games Services увидят приветственное сообщение после успешной аутентификации.
Варианты создания профиля
Профиль в игровых сервисах Play необходим для взаимодействия игроков с платформой. У некоторых игроков может не быть профиля в игровых сервисах Play при запуске игры. Таким игрокам будет предложено его создать.
Вы можете определить, какой опыт будет наиболее подходящим для ваших пользователей, выбрав один из следующих вариантов:
Автоматически активируемые запросы на создание профиля Запросы на создание профиля появляются автоматически по умолчанию при запуске игры без профиля Play Games Services.
Запрос на создание профиля при запуске игры (кликните для увеличения). Отключите запросы на создание профиля при запуске и добавьте запросы вручную после инициализации игры. Вы можете отключить автоматические запросы на создание профиля через файл манифеста. Это позволит пользователям без профиля в сервисах Play Games использовать ваши методы аутентификации без необходимости немедленного создания профиля в сервисах Play Games.
Хотя пользователи могут войти с помощью любого поставщика удостоверений, мы рекомендуем инициировать запрос на создание профиля . Получите результат аутентификации , чтобы побудить их зарегистрироваться на платформе Play Games. Вы можете инициировать этот запрос по своему усмотрению, но убедитесь, что он появляется до того, как пользователи добьются значительного прогресса в таких функциях, как достижения и таблицы лидеров.
Рассмотрите возможность активации запроса профиля в следующие рекомендуемые моменты:
- После завершения обучения.
- В момент вознаграждения (например, победа в матче, сбор редкого предмета или достижение определённой цели).
- На момент запуска второй сессии.
Рекомендуемый процесс аутентификации
Чтобы соответствовать требованиям к пользовательскому опыту в Google Play Games Level Up, убедитесь, что вы соблюдаете требования к непрерывности игры . Для успешной регистрации игроков в вашей игре используйте следующую процедуру аутентификации:
- Во время запуска игры просмотрите параметры создания профиля и выберите нужный вариант.
- Если автоматический вход не работает или пользователь отказывается, покажите кнопку ручного входа на случай, если пользователь захочет войти позже.
Идентификатор игрока
Идентификатор игрока — это идентификатор учётной записи в игровых сервисах Play. Ваша игра может получить идентификатор игрока для любого игрока, который войдет в неё, используя аутентификацию в игровых сервисах Play. Интеграция с игровым клиентом , интеграция с игровым сервером и облачный сервис сохранения могут использовать этот идентификатор для безопасного доступа к данным игрока из игровых сервисов Play.
Идентификатор игрока остается неизменным, когда пользователь играет в вашу игру на нескольких устройствах. Однако он не всегда совпадает между играми. Подробнее см. в разделе «Идентификаторы игроков следующего поколения» .
Области OAuth
Игровые сервисы Play используют систему OAuth , чтобы игроки могли предоставлять вашей игре доступ к своим учётным записям. Игровые сервисы Play имеют отдельную область действия для игр ( games-lite ) и используют другую область действия ( drive.appdata ), если ваша игра использует функцию сохранённых игр. Функция сохранённых игр предоставляет доступ к учётной записи Google Диска пользователя, где хранятся игровые данные.
При использовании Play Games Services v2 SDK вы можете запросить дополнительные области OAuth . Если вам нужны дополнительные области OAuth, рекомендуем вызвать requestServerSideAccess . Подробнее см. в разделах «Получить код аутентификации сервера» и «Извлечь коды аутентификации сервера» .
Множественные службы аутентификации
Игровые сервисы Play предоставляют игрокам Android игровую идентификацию, но она не обязательно должна быть единственной идентификацией, привязанной к вашим пользователям. Вы можете аутентифицировать игроков, используя игровые сервисы Play, идентификатор социальной сети и вашу собственную внутриигровую систему идентификации одновременно.
API отзыва
API Recall позволяет играм управлять связями между пользователями PGS и их игровыми аккаунтами, сохраняя токены отзыва на серверах Google. Подробнее об этой функции см. в статье «Интеграция API Recall PGS в вашу игру» .
Интеграция игрового клиента
При интеграции аутентификации в ваш игровой проект мы рекомендуем следующий порядок действий пользователя:
Во время запуска игры запускаются параметры создания профиля и предпринимается попытка входа пользователя в систему или создания новой учетной записи.
Если автоматическая аутентификация не работает или пользователь отказывается, покажите кнопку ручного входа на случай, если пользователь захочет войти позже.
Информацию об интеграции аутентификации в ваш игровой проект см. в руководстве по началу работы для вашего типа проекта:
Интеграция игрового сервера
Вы можете получить код авторизации сервера, вызвав requestServerSideAccess после проверки подлинности игрока. Передайте этот код авторизации сервера на свой внутренний игровой сервер для прямого взаимодействия с серверами игровых сервисов Play. Это взаимодействие позволяет вашему серверу получать доступ к данным игрока, включая:
- Идентификатор игрока
- Профиль
- Список друзей
- Прогресс игры
- Достижения
Затем ваш сервер использует этот код авторизации с REST API для безопасного взаимодействия с серверами Play Games Services. Подробнее см. в разделе Доступ к Play Games Services со стороны сервера .
Квота запросов на вход
В игровых сервисах Play установлена суточная квота на количество запросов на вход. Подробнее см. в разделе «Управление суточной квотой» .