миграция API в SDK

Если ваши игры, созданные для Google Play Games на ПК, напрямую обращаются к API Play Billing , вам необходимо перевести игру на использование SDK для ПК.

В зависимости от используемого игрового движка, вы можете интегрировать C++ SDK или C# SDK . Обратитесь к примерам проектов, демонстрирующим варианты миграции вашей нативной игры на SDK.

Подготовка и организация

В этом разделе описаны этапы миграции с решения на основе API на нативный SDK Google Play Games для ПК.

Аргументы командной строки

В Google Play Games на ПК Native SDK для аутентификации пользователей используются некоторые аргументы командной строки, передаваемые во время запуска игрового процесса. Эти аргументы необходимо передать процессу, который вызывает Initialize SDK . Если запуск вашей игры включает несколько процессов, необходимо убедиться, что все аргументы переданы процессу, который в конечном итоге использует SDK. См. шаг « Поддержка нескольких игровых процессов» в процессе настройки.

сопоставление API

Для завершения миграции вам потребуется удалить все прямые вызовы API к серверам Play. В SDK есть соответствующие вызовы функций для достижения той же функциональности. В этом разделе приведено описание соответствия для каждой функции.

Вход через Google

Вход через Google, также известный как «Вход с помощью Google» , — это метод аутентификации OAuth, предоставляющий пользователям возможность аутентификации в один клик с помощью их учетной записи Google. В проектах на основе API вы связываете учетную запись игрока с его покупками. Решения на основе SDK не требуют этой связи.

Решения на основе SDK используют учетную запись Google клиента Google Play Games , которая уже связана с профилем игрока и его правами доступа. Это обеспечивает более удобный пользовательский опыт и более безопасную среду для разработчиков, поскольку SDK может безопасно взаимодействовать с клиентом Google Play Games через межпроцессное взаимодействие (IPC).

Вместо входа через Google, вызовите функцию Initialize SDK как можно раньше. Обработайте соответствующий код ошибки, чтобы обеспечить безопасную среду для выполнения вашей игры.

Получить список товаров

В API-решении ваш бэкэнд-сервер получает список продуктов, используя конечную точку inappproduct.gets API разработчиков Play.

В SDK список товаров в приложении можно получить непосредственно на стороне клиента, используя функцию QueryProductDetails .

Осуществлять покупки

В API-решении ваш бэкэнд-сервер получает информацию о покупках пользователей, используя конечную точку purchases.products.get API разработчиков Play.

В SDK используйте функцию QueryPurchases непосредственно из игрового клиента.

Запуск процесса покупки

В API-решении для запуска процесса покупки требуется обращение к нескольким конечным точкам для настройки и получения необходимых токенов.

В SDK запустите процесс, вызвав функцию LaunchPurchaseFlow объекта BillingClient . SDK выполнит всю необходимую работу.

Оформите покупку

Обработка покупки пользователя включает в себя подтверждение и использование покупки после успешной проверки её легитимности. И API-решение, и SDK-решение рекомендуют выполнять эти шаги на стороне бэкэнда в целях безопасности.

Процесс аналогичен как для API-решений, так и для решений на основе SDK:

После получения purchaseToken из покупки, например, ProductPurchase.purchaseToken в API-решении или purchase_token объекта ProductPurchaseDetails в SDK-решении, отправьте его на бэкэнд для проверки .

После проверки ваша серверная часть сможет безопасно подтвердить или использовать покупку, предоставив соответствующие права.

Отправить на тестирование

Чтобы отправить свою игру на тестирование, выполните следующие шаги.

Пакет документов для подачи заявки

Игры, использующие SDK, должны быть упакованы в формат Windows App Bundle и загружены через Play Console . Для упаковки игры в формат Windows App Bundle обратитесь к документации.