錯誤代碼

本頁面列出一些常見的錯誤代碼、它們代表的意義,以及應用程式或遊戲可以如何回應這些代碼。

常見錯誤代碼

下表列出 API 可能會在任何平台上傳回的錯誤,以及建議採取的後續步驟。

錯誤代碼 說明 您可採取的行動
API_NOT_AVAILABLE Integrity API 無法使用。Play 商店版本可能過舊,或是應用程式尚未啟用這個 API。 1) 確認應用程式已啟用該 API。
2) 請使用者更新 Google Play 商店。
NETWORK_ERROR 找不到可用的網路。 請使用者檢查網路連線。
PLAY_STORE_NOT_FOUND 裝置上找不到官方 Play 商店應用程式。 請使用者安裝或啟用 Google Play 商店。
PLAY_STORE_VERSION_OUTDATED Play 商店應用程式需要更新。 請使用者更新 Google Play 商店。
PLAY_STORE_ACCOUNT_NOT_FOUND 裝置上找不到 Play 商店帳戶。請注意,Play Integrity API 現在支援未經驗證的請求。此錯誤代碼僅適用於已不支援的舊版 Play 商店版本。 請使用者登入 Google Play 商店。
CANNOT_BIND_TO_SERVICE 無法與 Play 商店中的服務繫結,這可能是因為裝置上安裝的 Play 商店版本過舊。 請使用者更新 Google Play 商店。
APP_NOT_INSTALLED 未安裝發出呼叫的應用程式。 發生問題;有可能是攻擊。無法操作。
PLAY_SERVICES_NOT_FOUND Play 服務無法使用或需要更新。 請使用者安裝或啟用 Play 服務。
PLAY_SERVICES_VERSION_OUTDATED Play 服務需要更新。 請使用者更新 Google Play 服務。
TOO_MANY_REQUESTS 發出呼叫的應用程式對 API 提出的要求過多,已受到限制。 以指數輪詢方式重試。
GOOGLE_SERVER_UNAVAILABLE 未知的 Google 內部伺服器錯誤。 以指數輪詢方式重試。
INTERNAL_ERROR 未知的內部錯誤。 以指數輪詢方式重試。
NONCE_TOO_SHORT Nonce 長度過短。Nonce 長度必須至少為 16 個位元組 (在 Base64 編碼之前)。 請使用較長的 Nonce 重試。
NONCE_TOO_LONG Nonce 長度過長。Nonce 長度不得超過 500 個位元組 (在 Base64 編碼之前)。 請使用較短的 Nonce 重試。
NONCE_IS_NOT_BASE64 Nonce 未採用可在網路上安全使用的 Base64 不換行格式。 請使用正確的 Nonce 格式重試。
CLOUD_PROJECT_NUMBER_IS_INVALID 提供的 Cloud 專案編號無效。 請使用已啟用 Play Integrity API 的 Cloud 專案編號。
APP_UID_MISMATCH 發出呼叫的應用程式 UID (使用者 ID) 與套件管理員中的 UID 不符。 發生問題;有可能是攻擊。無法操作。

原生專屬錯誤代碼

原生錯誤代碼會在開頭加上 INTEGRITY_ 前置字串,藉此避免可能發生的命名衝突。除了上述錯誤代碼以外,原生 API 還包含下列錯誤代碼:

錯誤代碼 說明 您可採取的行動
INTEGRITY_INITIALIZATION_NEEDED IntegrityManager 未初始化。 請先叫用 IntegrityManager_init()
INTEGRITY_INITIALIZATION_FAILED 初始化 Integrity API 時發生錯誤。 以指數輪詢方式重試。建議您回報錯誤。
INTEGRITY_INVALID_ARGUMENT 傳遞至 Integrity API 的引數無效。 請使用正確的引數重試。