Чтобы интегрировать игру с игровыми сервисами Google Play, сначала необходимо настроить аутентификацию на платформе. Это необходимо для доступа ко всем остальным функциям, таким как достижения, таблицы лидеров и события.
Чтобы соответствовать рекомендациям Google Play Games Level Up по пользовательскому опыту , ваша игра должна соответствовать рекомендуемому процессу аутентификации .
Инициализация и аутентификация
Это обязательный шаг для инициализации и аутентификации вашей игры:
- Реализуйте аутентификацию платформы, инициализировав Play Games Services v2 SDK при запуске. Подробнее см. в статье «Аутентификация платформы для игр Android» . Это обязательный шаг для доступа к функциям Play Games Services, таким как достижения и таблицы лидеров.
- Аутентификация выполняется как тихий фоновый процесс во время запуска игры.
Существующие пользователи Play Games Services увидят приветственное сообщение после успешной аутентификации.
Создание профиля
Для взаимодействия с платформой игрокам необходим профиль в сервисах Play Games. У некоторых игроков может не быть профиля в сервисах Play Games при запуске игры. Таким игрокам будет предложено его создать.
При запуске игры без профиля Play Games Services по умолчанию автоматически появляются запросы на создание профиля.
Рекомендуемый процесс аутентификации
Чтобы соответствовать требованиям к пользовательскому опыту в 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 установлена суточная квота на количество запросов на вход. Подробнее см. в разделе «Управление суточной квотой» .