Интегрируйте обзоры в приложении (Unity)

В этом руководстве описывается, как интегрировать внутренние обзоры в ваше приложение с помощью Unity. Существуют отдельные руководства по интеграции, если вы используете Kotlin, Java или собственный код .

Обзор Unity SDK

API проверки приложений в приложении является частью семейства Play Core SDK . API для Unity предлагает класс ReviewManager для запроса и запуска потока с помощью методов RequestReviewFlow и LaunchReviewFlow . После отправки запроса ваше приложение может проверить статус запроса с помощью ReviewErrorCode .

Настройте среду разработки

Загрузите последнюю версию плагина Play In-App Review Unity из пакетов Google для Unity .

Создайте менеджер отзывов

Создайте экземпляр ReviewManager , который будет обрабатывать связь между вашим приложением и API. 

// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();

Запросить объект ReviewInfo

Следуйте инструкциям о том , когда запрашивать обзоры в приложении , чтобы определить хорошие моменты в потоке пользователей вашего приложения и предложить пользователю написать отзыв (например, после того, как пользователь закрывает экран сводки в конце уровня в игре). Когда ваше приложение приблизится к одной из этих точек, используйте экземпляр ReviewManager для создания асинхронной операции, как показано в следующем примере:

var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();

Если вызов успешен, API возвращает объект PlayReviewInfo , который необходим вашему приложению для запуска потока проверки в приложении. В этом примере вызов выполняется внутри сопрограммы для выполнения асинхронной операции (это не блокирует основной поток). Поскольку вызов выполняется асинхронно, он может занять до нескольких секунд, поэтому ваше приложение должно выполнить вызов до того, как оно достигнет точки пользовательского потока, где вы хотите показать обзор в приложении.

Запустите процесс проверки в приложении

После того как ваше приложение получит экземпляр PlayReviewInfo , оно может запустить процесс проверки в приложении. Обратите внимание, что объект PlayReviewInfo действителен только в течение ограниченного периода времени, поэтому вашему приложению не следует слишком долго ждать перед запуском потока. 

var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
    // Log error. For example, using requestFlowOperation.Error.ToString().
    yield break;
}
// The flow has finished. The API does not indicate whether the user
// reviewed or not, or even whether the review dialog was shown. Thus, no
// matter the result, we continue our app flow.

Следующие шаги

Проверьте процесс проверки вашего приложения внутри приложения , чтобы убедиться, что ваша интеграция работает правильно.