许可参考

LVL 类和接口

表 1 列出了通过 Android SDK 提供的许可验证库 (LVL) 中的所有源文件。所有文件都属于 com.android.vending.licensing 软件包。

表 1. LVL 库类和接口摘要。

服务器响应

表 2 列出了许可服务器返回的所有许可响应字段。

表 2. Google Play 服务器返回的许可响应字段摘要。

服务器响应代码

表 3 列出了许可服务器支持的所有许可响应代码。通常，应用程序应处理所有这些响应代码。默认情况下，LVL 中的 LicenseValidator 类为您提供了所有这些响应代码的必要处理。

表 3. Google Play 服务器在许可响应中返回的响应代码摘要。

注意：如 设置测试环境 中所述，可以通过 Google Play 管理中心手动覆盖应用程序开发者和任何注册测试用户的响应代码。

注意：以前，您可以通过上传未发布的“草稿”版本来测试应用程序。此功能不再受支持；相反，您必须将其发布到 Alpha 或 Beta 分发渠道。有关更多信息，请参阅不再支持草稿应用。

服务器响应额外信息

为了帮助您的应用程序在退款期内管理应用程序的访问权限并提供其他信息，许可服务器在许可响应中包含了几部分信息。具体来说，该服务为应用程序的许可有效期、重试宽限期、最大允许重试次数和其他设置提供了建议值。如果您的应用程序使用 APK 扩展文件，响应中还包括文件名、大小和 URL。服务器将这些设置作为键值对附加到许可响应的“extras”字段中。

任何 Policy 实现都可以从许可响应中提取额外设置并根据需要使用它们。LVL 默认的 Policy 实现 ServerManagedPolicy，作为一个可行的实现，并说明了如何获取、存储和使用这些设置。

表 4. Google Play 服务器在许可响应中提供的许可管理设置摘要。

许可有效期

Google Play 许可服务器为所有下载的应用程序设置许可有效期。该期限表示应用程序的许可状态应被应用程序中的许可 Policy 视为不变且可缓存的时间间隔。许可服务器在其所有许可检查的响应中都包含有效期，将有效期结束时间戳作为额外信息附加到响应中，键为 VT。A Policy 可以提取 VT 键值并使用它有条件地允许访问应用程序，而无需重新检查许可，直到有效期过期。

许可有效期向许可 Policy 发出信号，指示何时必须与许可服务器重新检查许可状态。它不意味着应用程序是否实际已获许可使用。也就是说，当应用程序的许可有效期过期时，这并不意味着应用程序不再获许可使用 — 相反，它仅表示 Policy 必须与服务器重新检查许可状态。因此，只要许可有效期未过期，Policy 就可以在本地缓存初始许可状态并返回缓存的许可状态，而不是向服务器发送新的许可检查。

许可服务器管理有效期，作为帮助应用程序在 Google Play 为付费应用程序提供的退款期内正确执行许可的一种方式。它根据应用程序是否已购买以及购买了多久来设置有效期。具体来说，服务器按如下方式设置有效期：

• 对于付费应用程序，服务器设置初始许可有效期，以便许可响应在应用程序可退款期间内保持有效。应用程序中的许可 Policy 可以缓存初始许可检查的结果，并且无需重新检查许可，直到有效期过期。
• 当应用程序不再可退款时，服务器会设置更长的有效期——通常是几天。
• 对于免费应用程序，服务器将有效期设置为非常高的值 (long.MAX_VALUE)。这确保了，只要 Policy 在本地缓存了有效期时间戳，未来就无需重新检查应用程序的许可状态。

ServerManagedPolicy 实现使用提取的时间戳 (mValidityTimestamp) 作为主要条件，用于确定在允许用户访问应用程序之前是否与服务器重新检查许可状态。

重试期和最大重试次数

在某些情况下，系统或网络条件可能会阻止应用程序的许可检查到达许可服务器，或者阻止服务器的响应到达 Google Play 客户端应用程序。例如，用户可能在没有蜂窝网络或数据连接可用时（例如在飞机上）或网络连接不稳定或蜂窝信号弱时启动应用程序。

当网络问题阻止或中断许可检查时，Google Play 客户端会通过向 Policy 的 processServerResponse() 方法返回 RETRY 响应代码来通知应用程序。在系统问题的情况下，例如当应用程序无法绑定到 Google Play 的 ILicensingService 实现时，LicenseChecker 库本身会使用 RETRY 响应代码调用 Policy processServerResponse() 方法。

一般来说，RETRY 响应代码是向应用程序发出的信号，表明发生了阻止许可检查完成的错误。

Google Play 服务器通过设置重试“宽限期”和建议的最大重试次数来帮助应用程序在错误条件下管理许可。服务器在所有许可检查响应中都包含这些值，并将它们作为额外信息附加到 GT 和 GR 键下。

应用程序 Policy 可以提取 GT 和 GR 额外信息，并使用它们有条件地允许访问应用程序，如下所示：

• 对于导致 RETRY 响应的许可检查，Policy 应缓存 RETRY 响应代码并增加 RETRY 响应计数。
• Policy 应允许用户访问应用程序，前提是重试宽限期仍然有效或尚未达到最大重试次数。

ServerManagedPolicy 使用服务器提供的 GT 和 GR 值，如上所述。下面的示例展示了 allow() 方法中重试响应的条件处理。RETRY 响应的计数在 processServerResponse() 方法中维护，此处未显示。

fun allowAccess(): Boolean {
    val ts = System.currentTimeMillis()
    return when(lastResponse) {
        LICENSED -> {
            // Check if the LICENSED response occurred within the validity timeout.
            ts <= validityTimestamp  // Cached LICENSED response is still valid.
        }
        RETRY -> {
            ts < lastResponseTime + MILLIS_PER_MINUTE &&
                    // Only allow access if we are within the retry period
                    // or we haven't used up our max retries.
                    (ts <= retryUntil || retryCount <= maxRetries)
        }
        else -> false
    }
}

public boolean allowAccess() {
    long ts = System.currentTimeMillis();
    if (lastResponse == LicenseResponse.LICENSED) {
        // Check if the LICENSED response occurred within the validity timeout.
        if (ts <= validityTimestamp) {
            // Cached LICENSED response is still valid.
            return true;
        }
    } else if (lastResponse == LicenseResponse.RETRY &&
                ts < lastResponseTime + MILLIS_PER_MINUTE) {
        // Only allow access if we are within the retry period
        // or we haven't used up our max retries.
        return (ts <= retryUntil || retryCount <= maxRetries);
    }
    return false;
}