集成应用内评价 (Unity)

本指南介绍了如何使用 Unity 在应用中集成应用内评价。如果您使用的是 Kotlin 或 Java、原生代码或 Unreal Engine，请参阅单独的集成指南。

Unity SDK 概览

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

设置您的开发环境

OpenUPM-CLI

如果您已安装 OpenUPM CLI，则可以使用以下命令安装 OpenUPM 注册表：

openupm add com.google.play.review

OpenUPM

  1. 依次选择 Unity 菜单选项 Edit > Project Settings > Package Manager，打开软件包管理器设置。

  2. 将 OpenUPM 作为受限注册表添加到 Package Manager 窗口：

    Name: package.openupm.com
URL: https://package.openupm.com
Scopes: com.google.external-dependency-manager
  com.google.play.common
  com.google.play.core
  com.google.play.review

  3. 依次选择 Unity 菜单选项 Window > Package Manager，打开软件包管理器菜单。

  4. 将经理账号范围下拉菜单设置为选择我的注册库。

  5. 从软件包列表中选择 Google Play Integrity plugin for Unity 软件包，然后按 Install。

从 GitHub 导入

  1. 从 GitHub 下载最新的 .unitypackage 版本。

  2. 导入 .unitypackage 文件，方法是依次选择 Unity 菜单选项 Assets > Import package > Custom Package，然后导入所有项目。

创建 ReviewManager

创建负责处理应用与 Google Play API 之间通信的 ReviewManager 实例。

using Google.Play.Review;

// 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 launchFlowOperation.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.

后续步骤

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