ARCore API 授權問題疑難排解

選取平台：

免鑰匙功能無法運作 (ERROR_NOT_AUTHORIZED)

與 ARCore API 伺服器通訊時，如果擲回 ERROR_NOT_AUTHORIZED，請確認應用程式包含 com.google.android.gms:play-services-auth 程式庫：

  1. 建構應用程式，並使用 APK 分析工具檢查產生的構件。確認建構的應用程式二進位檔包含 com.google.android.gms.auth 套件，且內容未重新命名或縮小。
    • 如果沒有，請按照「加入必要程式庫」一文的說明操作，確保程式庫已加入，且縮小設定正確無誤。

  2. 使用 keytool 公用程式，顯示失敗目標構件中的安全性資訊：

    AAB 構件

    keytool -printcert -jarfile artifact.aab

    APK 構件

    keytool -printcert -jarfile artifact.apk

  3. 請確認 SHA-1 憑證指紋與專案 OAuth 2.0 用戶端 ID 中使用的憑證相符。

  4. 請確認您已在 Google Cloud 中為正確的專案啟用 ARCore API。

無金鑰授權在某些建構類型 (例如偵錯) 中成功，但在其他類型中失敗

如果無金鑰授權在某些建構版本中成功，但在其他版本中失敗，請確認失敗構件中的指紋與 Google Cloud 控制台中列出的指紋相符。請參閱「無金鑰授權無法運作」一文，然後按照步驟驗證該構件的簽署金鑰指紋是否與 Google Cloud 中列出的指紋相符。

使用 Play 應用程式簽署功能時，無金鑰授權無法運作

如果無金鑰授權功能在您本機建構的應用程式中運作正常，但上傳至 Google Play 商店並啟用 Play 應用程式簽署功能後卻無法運作，請確認專案憑證中註冊的 SHA-1 憑證指紋與 Google 用來簽署應用程式的指紋相符：

  • 在 Google Play 的「應用程式簽署」頁面中，捲動到「應用程式簽署金鑰憑證」。記下 SHA-1 憑證指紋。
  • 使用上一步的 SHA-1 憑證指紋，建立新的 OAuth 2.0 用戶端 ID。

詳情請參閱「Play 應用程式簽署」。

API 金鑰驗證無法運作

如果 API 金鑰授權無法運作，請按照下列步驟操作：