集成应用内评论（Unity）

本指南介绍了如何在使用 Unity 的应用中集成应用内评论。如果您使用的是 Kotlin 或 Java 或 原生代码，则有单独的集成指南。

Unity SDK 概述

Play 应用内评论 API 是 Play Core SDK 系列的一部分。Unity 的 API 提供了 ReviewManager 类，可以使用 RequestReviewFlow 和 LaunchReviewFlow 方法请求并启动流程。发出请求后，您的应用可以使用 ReviewErrorCode 检查请求的状态。

设置您的开发环境

从 Google 的 Unity 包 下载 Play 应用内评论 Unity 插件的最新版本。

创建 ReviewManager

创建 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.

下一步

测试您的应用的应用内评价流程以验证您的集成是否正常工作。