Обзор миграции

Игровые сервисы Google Play, SDK игр v1 используют Google Sign-In для Android, который устарел и будет удален из SDK аутентификации сервисов Google Play ( com.google.android.gms:play-services-auth ) в 2025 году. Новые игры приложения могут использовать игры v1 до 2025 года. Удаление входа в систему Google приводит к возникновению проблем с зависимостями для существующих игровых приложений. Перенос существующих игровых приложений из SDK games v1 в SDK games v2 решает проблемы с зависимостями, возникшие из-за удаления входа в систему Google.

Этот документ поможет вам понять взаимодействие между игровым приложением и различными SDK. В этом документе также сравниваются функции приложения с функциями SDK игр Play Games Services v1 и games v2.

Взаимодействие с SDK

На диаграммах показано взаимодействие между игровым приложением на Android, Google Mobile Services (GMS) Core, Play Games Services и сторонним (3P) игровым сервером. В нем показано, как приложение использует сервисы Google для аутентификации и игровых функций, а также взаимодействует с отдельной сторонней системой.

игры v2 (текущие)

Взаимодействие между игровым приложением на     Android, GMS Core, игровые сервисы Play,     и сторонний (3P) игровой сервер.
Взаимодействие между игровым приложением на Android, GMS Core, игровыми сервисами Play и сторонним (3P) игровым сервером. (нажмите, чтобы увеличить).

игры v1 (Устаревшие)

Взаимодействие между игровым приложением на     Android, GMS Core, игровые сервисы Play,     и сторонний (3P) игровой сервер.
Взаимодействие между игровым приложением на Android, GMS Core, игровыми сервисами Play и сторонним (3P) игровым сервером. (нажмите, чтобы увеличить).

Ниже приводится краткий обзор компонентов и SDK:

  • Приложение «Игры».
    • Это представляет собой игровое приложение пользователя, работающее на устройстве под управлением Android.
    • Он содержит два основных компонента:
      • SDK для игр v1 или games v2. Клиентский SDK, отвечающий за взаимодействие с игровыми сервисами Play.
      • Аутентификация SDK. Сервисы Google Play Auth SDK отвечают за обработку потоков аутентификации и авторизации пользователей в играх v1.
    • Оба SDK взаимодействуют с помощью AIDL (языка определения интерфейса Android), указывая шаблон взаимодействия между различными процессами или службами.
  • GMS Core также называется Сервисами Google Play.
    • Это собственный слой Google на Android.
    • В игровом приложении используются два модуля GMS Core:
      • Игровой модуль. предоставляет функции, специфичные для игры, такие как таблицы лидеров, достижения и управление состоянием игры.
      • Модуль авторизации. Обрабатывает операции аутентификации и авторизации пользователей.
    • SDK Games и Auth в игровом приложении взаимодействуют с соответствующими модулями с помощью интерфейсов AIDL , указывая межпроцессное взаимодействие (IPC).

  • Шлюз игровых сервисов Play.
    • Логический шлюз, который обеспечивает связь между GMS Core и сервером Play Games Services.
    • Обрабатывает запросы API, преобразование данных и аутентификацию для связи с сервером.
  • Сервер игровых сервисов Play.
    • Представляет серверные службы Play Games Services, отвечающие за хранение игровых данных, управление учетными записями пользователей и поддержку многопользовательских функций.
  • Шлюз сторонних игр.
    • Если ваше игровое приложение квалифицируется как стороннее (3P) приложение, клиентская библиотека взаимодействует с серверами Play Games Services через сторонние игровые серверы.
    • Подразумевается, что приложение также может пройти аутентификацию у другого поставщика услуг.
  • Сторонний игровой сервер.
    • Представляет дополнительный внешний сервер, с которым может взаимодействовать игровое приложение, вероятно, для пользовательских функций или управления данными.
    • Связь с приложением происходит через сторонний игровой шлюз.

Сравнение функций

В этой таблице приведено сравнение функций SDK игр v1 и games v2:


Особенность

игры v1 SDK

игры v2 SDK

Аутентификация

Требуется интеграция с play-services-auth .

Упрощенный и оптимизированный; play-services-auth не требуется.

Авторизация

Дополнительный код для успеха, сбоев и повторных попыток.

Управляется SDK

Токен доступа к серверу

Можно запросить дополнительные области OAuth 2.0 с помощью GoogleSigninClient .

Дополнительный код для обработки ошибок во время входа.

Дополнительные области не допускаются.

Дополнительный код с обратным вызовом при успешном сбое с помощью serverAuthcode.

Процесс входа в систему

Использует GoogleSigninClient .

Дополнительный код для обработки шаблонного кода для автоматического входа и обработки ошибок.

Использует GamesSignInClient .

SDK обрабатывает шаблонный код, автоматический вход и обработку ошибок.

Приветственное всплывающее окно

Требуется дополнительный код.
Разработчики могут контролировать его размещение и время.

Никакого дополнительного кода не требуется. Согласованный пользовательский интерфейс во всех играх, настроенных на PGS V2. .

Зависимости

Требуется play-services-auth .

Нет отдельной зависимости от play-services-auth .
Выход

Использует GoogleSignInClient.signOut .

API выхода не поддерживается.

Несколько учетных записей игровых сервисов Play и настройки для каждой игры.

Выбор и управление учетной записью недоступны.

Для каждой игры вы можете управлять своей учетной записью Play Games Services. Это позволяет вам выбрать, какую учетную запись использовать в каждой игре.