授權參考資料

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 擴充檔案，回應還會包含檔案名稱、大小和網址。伺服器會在授權回應的「額外項目」欄位中附加鍵/值組合形式的設定。

任何 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 回應代碼呼叫政策 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;
}