ライセンス リファレンス

LVL のクラスとインターフェース

表 1 に、Android SDK で利用可能な License Verification Library（LVL）のすべてのソースファイルを示します。ファイルはすべて、com.android.vending.licensing パッケージに含まれます。

表 1. LVL のクラスとインターフェースの概要

サーバー応答

表 2 に、ライセンス サーバーから返されるすべてのライセンス応答フィールドの一覧を示します。

表 2. Google Play サーバーから返されるライセンス応答フィールドの概要

サーバー応答コード

表 3 に、ライセンス サーバーがサポートしているすべてのライセンス応答コードの一覧を示します。通常、アプリではこれらの応答コードをすべて処理する必要があります。デフォルトでは、LVL の LicenseValidator クラスには、これらの応答コードに対する必要な処理がすべて含まれています。

表 3. Google Play サーバーからのライセンス応答で返される応答コードの概要

注: テスト環境のセットアップに記載されているとおり、アプリ デベロッパーと登録済みテストユーザー向けの応答コードは、Google Play Console を使用して手動でオーバーライドできます。

注: 以前は、公開前のドラフト版をアップロードしてアプリをテストできました。この機能はサポートされなくなったため、代わりに、アルファ版またはベータ版の配布チャンネルにアプリを公開する必要があります。詳しくは、ドラフト版アプリのサポートの終了についての説明をご覧ください。

サーバー応答の付加情報

アプリの払い戻し期間全体にわたってアプリへのアクセスを管理できるようにアプリをサポートし、また、上記以外の情報を提供するために、ライセンス応答にはライセンス サーバーによっていくつかの情報が付加されます。具体的には、ライセンス サービスから、アプリのライセンス有効期間、再試行猶予期間、最大許容再試行回数などの推奨設定値が提供されます。アプリで APK 拡張ファイルを使用している場合は、応答にファイルの名前、サイズ、URL も含まれます。サーバーはこれらの設定を、ライセンス応答の「付加情報」フィールドに Key-Value ペアとして追加します。

Policy 実装では、ライセンス応答から付加情報の設定を抽出し、必要に応じて使用できます。LVL のデフォルトの Policy 実装（ServerManagedPolicy）は、そのまま機能する実装としても、付加情報設定の取得、保存、使用の方法を示す例としても利用できます。

表 4. Google Play サーバーからのライセンス応答で提供されるライセンス管理設定の概要

ライセンス有効期間

Google Play ライセンス サーバーにより、ダウンロードされたすべてのアプリに対してライセンス有効期間が設定されます。この期間は、アプリ内のライセンス Policy で、アプリのライセンス ステータスが不変かつキャッシュ保存可能とみみなすべき期間を表します。どのライセンス チェックに対する応答にも、ライセンス サーバーにより、付加情報のキー VT の値として有効期限のタイムスタンプが追加されます。これにより、応答から有効期間がわかります。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 応答の条件付き処理を示します。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;
}