Используйте этот контрольный список, чтобы убедиться, что ваша игра соответствует всем требованиям и рекомендациям, прежде чем отправить ее на проверку в Google Play Games на компьютере.
Как настроить проект
- Скачайте и импортируйте SDK. Интегрируйте последнюю версию Play Games PC SDK для своей среды. Дополнительную информацию можно найти в руководствах по Unity и C++.
- Создайте манифест приложения. Создайте файл
manifest.xml, сопоставляющий<PackageName>с пакетом, который вы заявили в Play Console. Подробную информацию можно найти в руководстве по манифесту. - Добавьте цифровую подпись к исполняемому файлу. Подпишите игру с помощью цифровой подписи Authenticode и сохраните сертификат для всех будущих обновлений. Хотя вы можете пропустить этот шаг во время локальной разработки, включив режим разработчика, вы должны подписать свой окончательный двоичный файл фактическим производственным сертификатом от известного центра сертификации. Подробнее о том, как добавить цифровую подпись в игру…
- Отформатируйте и отправьте сертификат. Отправьте информацию о сертификате представителю Google. Файл сертификата должен содержать только информацию, связанную с сертификатом. Убедитесь, что все блоки, не относящиеся к сертификату, удалены. Вы можете использовать OpenSSL для преобразования файлов DER/CER в требуемый формат PEM.
Интеграция API и функций
- Инициализируйте SDK. Реализуйте логику инициализации SDK, например
InitializeAsync, во время запуска, прежде чем использовать другие функции. Дополнительную информацию можно найти в руководстве по инициализации. - Реализуйте простой вход. Настройте автоматическую аутентификацию игроков с помощью аккаунта клиента Play Игр через Recall API. Дополнительную информацию можно найти в руководстве по быстрому входу.
- Интегрируйте Play Integrity API. Используйте
IntegrityClient, чтобы запрашивать токены и проверять легитимность игровых сеансов на сервере. Подробную информацию можно найти в руководстве по Play Integrity API. - Добавьте Play Install Referrer API. Интегрируйте Install Referrer API, если вам нужно отслеживать источники трафика на ПК. Дополнительную информацию можно найти в руководстве по Install Referrer.
- Обработка ошибок инициализации. Чтобы использовать SDK, вызовите
GooglePlayInitialize(C++) илиGooglePlayInitialization.InitializeAsync(C#) для инициализации API. Прежде чем использовать другие API, вызовите этот метод и убедитесь, что обратный вызов завершается с кодомInitializeResult::ok()(C++) илиResult.IsOk(C#) возвращаетtrue. - Обработка обязательного завершения работы. Обработайте
kActionRequiredShutdownClientProcess, как можно скорее завершив процесс клиента. - Обработка требований к установке Google Play Игр. Обрабатывайте ошибку
kSdkRuntimeUnavailable, сообщая пользователям, что для продолжения необходимо установить Google Play Игры и среду выполнения SDK. - Обработка обновлений Google Play Игр. Обрабатывайте
kSdkRuntimeUpdateRequired, уведомляя пользователей о том, что требуется обновить среду выполнения Google Play Игр.
Внедрите Google Play Платежи
- Проверьте типы покупок. Убедитесь, что в вашей игре используются только покупки в приложении, поскольку регулярные платежи и подписки не поддерживаются. Дополнительную информацию можно найти в разделе часто задаваемых вопросов об оплате.
- Запрос информации о товарах. Используйте
QueryProductDetails, чтобы получить локализованные данные о магазине. Если у вас больше 50 товаров, разделите запрос на несколько вызовов. Подробную информацию вы найдете в руководстве по запросам товаров. - Запустите процесс покупки. Используйте
LaunchPurchaseFlowдля обработки транзакций. Если вы закроете браузер, не выполнив платеж, через пять минут появится сообщение об ошибке. Подробную информацию вы найдете в руководстве по процессу покупки. - Восстановление существующих покупок. Вызывайте
QueryPurchasesпри запуске и выводе приложения на передний план, чтобы отслеживать неподтвержденные покупки на разных устройствах. Подробную информацию вы найдете в руководстве по восстановлению покупок. - Безопасная обработка на сервере. Проверяйте
purchaseTokenна сервере, прежде чем предоставлять доступ к контенту и завершать покупку с помощьюAcknowledgePurchaseилиConsumePurchase. Дополнительные сведения вы можете найти в руководстве по безопасной обработке. - Учитывайте задержку распространения лицензионного ключа. При настройке новых ключей оплаты или лицензирования в Play Console подождите несколько часов, пока кеш серверной части синхронизируется со средами обслуживания коммерческих операций, и только потом проводите тестирование покупок. Если попытаться совершить покупку до завершения синхронизации, будет возвращен код ошибки 6.
Тестирование в режиме разработчика и контроль качества перед подготовкой к запуску
- Тестирование в режиме разработчика. Добавьте
<IsDeveloperMode>true</IsDeveloperMode>в манифест и настройте GUID партнера по раннему доступу для тестирования в локальной интегрированной среде разработки (IDE). Если у вас нет GUID партнера с ранним доступом, заполните форму. - Управление покупками в режиме разработчика. При тестировании покупок в режиме разработчика используйте покупку в течение трех минут, чтобы предотвратить автоматический возврат средств. Дополнительную информацию можно найти в разделе часто задаваемых вопросов о тестировании.
- Отключите режим разработчика. Как можно скорее удалите тег
<IsDeveloperMode>, прежде чем упаковывать конечную сборку. Подробную информацию вы найдете в руководстве по режиму разработчика. - Передача аргументов с помощью сторонних программ запуска. Передавайте все неизвестные аргументы командной строки, полученные программой запуска от клиента Google Play Games, непосредственно в запущенный процесс игры. Дополнительную информацию можно найти в руководстве по многопроцессной архитектуре.
- Проверьте с помощью VPN. Если вы находитесь в неподдерживаемом регионе, используйте VPN с включенным режимом TUN, чтобы получить поддерживаемый IP-адрес. Дополнительную информацию можно найти в разделе часто задаваемых вопросов о тестировании VPN.
- Поддержка ярлыков на рабочем столе. Чтобы обеспечить бесперебойную поддержку ярлыков, ознакомьтесь с часто задаваемыми вопросами о ярлыках. Если вы запустите игру или сторонний лаунчер напрямую с помощью ярлыка, могут возникнуть ошибки инициализации.
Упаковка, тестирование и публикация игры
- Упакуйте WAB. Используйте Play Publishing Tool, чтобы упаковать игру в набор Windows App Bundle (WAB). Размер файла WAB не должен превышать 10 ГБ для публикации через установщик и 200 ГБ для управляемой публикации в Google Play. Подробнее о требованиях к упаковке…
- Используйте последние версии SDK и инструментов. Скомпилируйте и упакуйте выпуск с помощью последних версий SDK Play Игр на ПК, SDK Unity Play Игр на ПК, инструмента разработчика Play для ПК и инструмента публикации Play.
- Проверьте, требуется ли повышение прав. Если установщик, средство запуска или деинсталлятор нужно запускать от имени администратора, убедитесь, что для параметра
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONилиUNINSTALLER_REQUIRES_ELEVATIONзадано значениеtrue. В противном случае они не будут запущены с правами администратора, что приведет к сбою запуска. Подробную информацию можно найти в разделе Формат файла конфигурации WAB. - Отправьте установщики сторонних программ запуска. Если вы используете стороннюю программу запуска, отправьте ее установщик в WAB. Дополнительную информацию можно найти в руководстве по публикации установщиков.
- Обработка токена сеанса автозапуска. Если вы включили автозапуск, задав значение
acceptsCommandLineArguments="true"вplay_publishing_config.xml, убедитесь, что установщик извлекает аргумент командной строки--g_session_token=<token>и использует его для запуска игры. Убедитесь, что установщик обрабатывает резервный случай, когда токен отсутствует. Дополнительную информацию можно найти в разделе часто задаваемых вопросов о панели запуска. - Обновление игры и программы запуска или установщика. Контент пакета, включая установщики программы запуска, должен обновляться автоматически. Управляйте всеми ресурсами, необходимыми для игры, включая обновление самого лаунчера.
- Поделитесь с Google информацией о запуске. Свяжитесь с партнером Google Play и сообщите ему название пакета, страны, в которых будет запущен продукт (используйте двухсимвольные коды ISO, например US, CA, MX), а также дату и время запуска по всемирному координированному времени (UTC).
- Настройте доступ для тестирования. Укажите внешнюю группу Google, которую нужно добавить в белый список для тестирования, документации и доступа к Google Диску. Поделитесь списком адресов электронной почты тестовых аккаунтов с партнером Google Play, поскольку каналы тестирования в Play Console не поддерживаются на ПК.
- Добавьте тип устройства "ПК". В Google Play Console добавьте для приложения тип устройства "Google Play Игры на компьютере". Если у вас нет доступа к этой вкладке, попросите партнера Google Play добавить ваш аккаунт в белый список.
- Настроить требования к ПК. Укажите требования к оборудованию (ОЗУ, графический процессор, хранилище) для ПК с Windows. Подробную информацию можно найти в руководстве по требованиям к ПК.
- Загрузите объекты для страницы приложения в Google Play. Загрузите упакованный файл WAB в рабочую версию и настройте визуальные объекты. Подробную информацию вы найдете в руководстве по загрузке объектов.
- Опубликуйте приложение для тестирования в пользовательской среде. Для этого в Google Play Console нажмите Опубликовать. В отличие от версии для Android, нажатие кнопки Опубликовать для WAB не приводит к общедоступному выпуску. Вместо этого оно делает приложение доступным для поиска в тестовых аккаунтах, чтобы вы могли провести тестирование в пользовательской среде после проверки Google.
- Официальный запуск. Google контролирует запуск на основе официальной даты, которую вы сообщили партнеру Google Play.
- Тестирование во время предварительной регистрации. На этапе предварительной регистрации вы должны провести внутреннее тестирование в стране, которая не входит в выбранные регионы предварительной регистрации.
- Проверьте завершение процесса установки. Убедитесь, что основной процесс установки остается активным, пока не будут созданы и зарегистрированы все необходимые ключи реестра. Если процесс завершается преждевременно, то проверка установки не выполняется. Подробнее о публикации установщиков…
- Поддерживайте согласованность кустов реестра и очищайте их при удалении.
Google Play Игры на компьютере проверяют
HKEY_LOCAL_MACHINEпередHKEY_CURRENT_USERи используют первое совпадающее значение. Куст реестра должен быть одинаковым для всех обновлений и игр, запускаемых через общую программу запуска. При удалении игры удаляйте и разделы реестра, чтобы устаревшие записиHKEY_LOCAL_MACHINEне перекрывали действительные путиHKEY_CURRENT_USER. Подробнее о публикации установщиков…
Как перейти с API на SDK
Переход с API на SDK не является обязательным. Если вы решите перенести сайт, следуйте этим рекомендациям:
- Удалите устаревшие REST API. Сопоставьте устаревшие вызовы Play Developer API (например,
purchases.products.get) с функциями Native SDK на стороне клиента. Дополнительную информацию вы найдете в руководстве по переносу данных. - Проверьте аргументы командной строки. Аргументы командной строки в среде SDK могут отличаться от аргументов в среде API. Убедитесь, что ваш пакет правильно обрабатывает и передает все аргументы. Подробнее о подтверждении…
- Проверьте путь к реестру. Чтобы переход на Native SDK прошел без проблем, конфигурация реестра должна соответствовать предыдущим версиям. Подробную информацию вы найдете в руководстве по файлам WAB.