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