В связи с прекращением поддержки API Google Sign-In , мы удаляем SDK для игр версии 1 в 2026 году. После февраля 2025 года вы не сможете публиковать в Google Play игры, которые были интегрированы с SDK для игр версии 1. Мы рекомендуем использовать вместо него SDK для игр версии 2.
Хотя существующие игры с интеграцией предыдущих версий v1 будут продолжать работать еще пару лет, мы рекомендуем перейти на версию v2, начиная с июня 2025 года.
Данное руководство предназначено для использования SDK Play Games Services v1. Информацию о последней версии SDK см. в документации v2 .
Вход через Play Games Services предоставляет вам игровой идентификатор игрока, который представляет собой идентификатор на уровне платформы, специфичный для игр на Android. Этот идентификатор помогает установить связь между вашей игрой и игроком. Игроки охотнее используют этот идентификатор для входа, чем альтернативные централизованные системы.
Кроме того, вход в систему предоставляет вам надежный и надежный идентификатор, который можно использовать в качестве ключа к системе облачного сохранения. Облачное сохранение высоко ценится; оно позволяет игрокам делать следующее:
- Продолжите с того места, где они остановились, если они изменят или перезагрузят свое устройство.
- Играйте в игру на нескольких устройствах (например, на другом телефоне или Chromebook).
- Удалите, а затем переустановите игру.
Вы можете использовать идентификатор Play Games Services в качестве ключа для собственного облачного хранилища сохранений, или же воспользоваться бесплатным сервисом Saved Games .
Сервисы Play Games Services (PGS) поддерживают автоматический вход в систему, обеспечивающий простой и удобный способ авторизации игроков, а также ручной вход в систему, выполняемый одним щелчком мыши. В этом документе описаны эти различные методы авторизации.
Рекомендуемый порядок входа в систему
Для успешной авторизации игроков в вашей игре используйте следующий процесс входа:
- Во время запуска игры попробуйте включить автоматический вход в систему, чтобы игрок автоматически авторизовался.
- Если автоматический вход в систему не работает, а устройство пользователя подключено к интернету, попробуйте ручной вход в систему .
- Если вход в систему вручную отклонен, запомните выбор пользователя и больше не показывайте страницу входа в систему вручную, а продолжайте попытки автоматического входа при запуске системы.
Кроме того, необходимо обеспечить пользователям возможность входа в игру с помощью своей учетной записи в сервисе Play Games, используя специальную, легкодоступную кнопку.
Автоматический вход в систему
Автоматический вход позволяет пользователям без каких-либо проблем входить в вашу игру — это происходит автоматически! Если ваша игра запрашивает вход пользователя и в приложении Google Play Games включена функция автоматического входа, вы получите учетные данные пользователя в PGS, и пользователь увидит процесс входа через PGS.
Автоматический вход в систему — это настройка, которую пользователи могут контролировать. Пользователи могут выбрать автоматический вход во все игры или запросить его каждый раз.
Вход вручную
Если пользователь не входит в игру автоматически, вы можете предложить ему войти вручную. Пользователи могут войти в игру одним щелчком мыши из диалогового окна, отображаемого в верхней части экрана игры.
Разрешите всплывающие окна PGS для корректной работы системы авторизации.
При использовании PGS пользователям необходимо убедиться, что они вошли в систему. Это достигается путем отображения интерфейса входа в PGS.
Для отображения процесса входа в систему вызовите метод setViewForPopups() класса GamesClient во время запуска игры. Это крайне важно для обеспечения корректного взаимодействия с пользователем.
Области действия OAuth и PGS
PGS использует систему OAuth , чтобы позволить пользователям предоставлять вашей игре доступ к своим учетным записям. Области действия OAuth — это разрешения, которые вы, как разработчик, можете запросить. Если они предоставлены, ваша игра сможет вызывать определенные API от имени пользователя, а также предоставит вам доступ к определенным частям его учетной записи Google.
PGS имеет уникальную область видимости для игр ( games-lite ) и использует другую область видимости ( drive.appdata ), если ваша игра использует функцию сохранения игр. Функция сохранения игр предоставляет доступ к учетной записи Google Drive пользователя, где хранятся данные игры.
Ваша игра может запрашивать любые необходимые вам области доступа, чтобы обеспечить пользователям отличный игровой опыт. Вы можете запросить все необходимые области доступа одним пакетом, ограничив количество запросов на доступ к учетной записи Google. Однако у этого подхода есть существенный недостаток. Если вы запросите больше областей доступа, чем требуется для PGS, автоматический вход в систему не будет работать. Автоматический вход в систему — лучший способ обеспечить авторизацию игроков в вашей игре.
Наилучшей практикой является использование поэтапных запросов на получение областей действия. В первоначальном запросе ваша игра должна сначала запросить области действия, доступные только для PGS, а остальные области действия запрашивать отдельно в более подходящий момент.
Доступ по протоколу OAuth предоставляется с помощью отдельного экрана для каждой области действия. Это позволяет пользователям детально определять, к каким областям действия предоставлять доступ. Использование автоматического входа в систему только для областей действия PGS избавляет пользователей от необходимости взаимодействовать с запросами OAuth, снижая сложности при входе в систему.
Поддержка нескольких способов входа в систему.
PGS предоставляет игрокам на Android игровую идентификацию, но это не обязательно должна быть единственная идентификация, связанная с вашими пользователями. Вы можете одновременно авторизовать игроков, используя PGS, идентификатор социальной сети и собственную внутриигровую систему идентификации. Каждая система предоставляет уникальные преимущества как для вас, так и для ваших игроков, и все они могут работать вместе, чтобы обеспечить отличный опыт для игроков на Android.
Безопасное получение и проверка личности игрока для интеграции с бэкэндом.
Вы можете запросить код авторизации сервера, чтобы ваш сервер мог напрямую взаимодействовать с серверами Play Games Services через REST API с разрешения авторизованного игрока. Это обеспечит прямой доступ к идентификатору игрока, его профилю и другой информации (например, списку друзей, если это разрешено). Если вы храните какие-либо идентификаторы игроков, идентификаторы друзей или другие связанные данные в своей серверной части, этот метод необходимо использовать, чтобы исключить возможность манипулирования этими полями на стороне устройства.
Кроме того, для некоторых старых игр и игроков идентификатор игрока, возвращаемый Android SDK, может отличаться от идентификатора, который видят другие игроки при просмотре этого игрока в той же игре — это особенно актуально при использовании списка друзей. Однако идентификатор player_id возвращаемый в REST API, всегда остается неизменным и всегда совпадает с идентификатором, который видят другие игроки.
Для получения более подробной информации см. разделы «Доступ в автономном режиме» и «Документация по REST API» .
Внедрение клиента
Чтобы узнать, как реализовать поддержку входа в систему на Android, см. раздел «Вход в систему в играх для Android» .