Mit BillingResult-Antwortcodes umgehen

Wenn ein Play Billing Library-Aufruf eine Aktion auslöst, gibt die Bibliothek eine BillingResult um die Entwickelnden über das Ergebnis zu informieren. Wenn du beispielsweise queryProductDetailsAsync verwendest, um die verfügbaren Angebote für den Nutzer abzurufen, enthält der Antwortcode entweder einen OK-Code und das richtige ProductDetails-Objekt oder eine andere Antwort, die den Grund angibt, warum das ProductDetails-Objekt nicht bereitgestellt werden konnte.

Nicht alle Antwortcodes sind Fehler. Die BillingResponseCode enthält eine detaillierte Beschreibung der einzelnen Antworten, die in diesem Leitfaden erläutert werden. Beispiele für Antwortcodes, die keine Fehler anzeigen:

Wenn der Antwortcode einen Fehler anzeigt, liegt die Ursache manchmal an vorübergehenden Bedingungen und eine Wiederherstellung ist möglich. Wenn ein Aufruf von Google Play Billing Library-Methode gibt BillingResponseCode zurück. angegeben ist, der auf einen wiederherstellbaren Zustand hinweist, sollten Sie den Aufruf wiederholen. In In anderen Fällen gelten Bedingungen nicht als vorübergehend. wird nicht empfohlen.

Für vorübergehende Fehler sind unterschiedliche Wiederholungsstrategien erforderlich, je nachdem, ob der Fehler auftritt, während Nutzer eine Sitzung haben (z. B. wenn ein Nutzer einen Kaufvorgang durchläuft) oder im Hintergrund (z. B. wenn Sie die vorhandenen Käufe des Nutzers während onResume abfragen). Im Abschnitt Wiederholstrategien unten finden Sie Beispiele für diese verschiedenen Strategien. Im Abschnitt Wiederholbare AntwortenBillingResult wird empfohlen, welche Strategie für jeden Antwortcode am besten geeignet ist.

Neben dem Antwortcode enthalten einige Fehlermeldungen auch Meldungen für Debugging- und Logging-Zwecken.

Strategien für Wiederholungen

Einfacher Wiederholungsversuch

In Situationen, in denen sich der Nutzer in einer Sitzung befindet, ist es besser, eine einfache Wiederholungsstrategie so, dass der Fehler die Nutzererfahrung nur so wenig möglich. In diesem Fall empfehlen wir eine einfache Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Endbedingung.

Das folgende Beispiel zeigt eine einfache Wiederholungsstrategie zur Fehlerbehandlung beim Einrichten eines BillingClient Verbindung:

class BillingClientWrapper(context: Context) : PurchasesUpdatedListener {
  // Initialize the BillingClient.
  private val billingClient = BillingClient.newBuilder(context)
    .setListener(this)
    .enablePendingPurchases()
    .build()

  // Establish a connection to Google Play.
  fun startBillingConnection() {
    billingClient.startConnection(object : BillingClientStateListener {
      override fun onBillingSetupFinished(billingResult: BillingResult) {
        if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
          Log.d(TAG, "Billing response OK")
          // The BillingClient is ready. You can now query Products Purchases.
        } else {
          Log.e(TAG, billingResult.debugMessage)
          retryBillingServiceConnection()
        }
      }

      override fun onBillingServiceDisconnected() {
        Log.e(TAG, "GBPL Service disconnected")
        retryBillingServiceConnection()
      }
    })
  }

  // Billing connection retry logic. This is a simple max retry pattern
  private fun retryBillingServiceConnection() {
    val maxTries = 3
    var tries = 1
    var isConnectionEstablished = false
    do {
      try {
        billingClient.startConnection(object : BillingClientStateListener {
          override fun onBillingSetupFinished(billingResult: BillingResult) {
            if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
              isConnectionEstablished = true
              Log.d(TAG, "Billing connection retry succeeded.")
            } else {
              Log.e(
                TAG,
                "Billing connection retry failed: ${billingResult.debugMessage}"
              )
            }
          }
        })
      } catch (e: Exception) {
        e.message?.let { Log.e(TAG, it) }
        tries++
      }
    } while (tries <= maxTries && !isConnectionEstablished)
  }
  ...
}

Wiederholung mit exponentiellem Backoff

Wir empfehlen die Verwendung des exponentiellen Backoffs für Play Billing Library-Vorgänge, die im Hintergrund ausgeführt werden und die Nutzerfreundlichkeit nicht beeinträchtigen, während die Sitzung aktiv ist.

Diese Vorgehensweise wäre beispielsweise sinnvoll, wenn Sie neue Käufe tätigen, weil dieser Vorgang im Hintergrund erfolgen kann Bestätigung muss nicht in Echtzeit erfolgen, wenn ein Fehler auftritt.

private fun acknowledge(purchaseToken: String): BillingResult {
  val params = AcknowledgePurchaseParams.newBuilder()
    .setPurchaseToken(purchaseToken)
    .build()
  var ackResult = BillingResult()
  billingClient.acknowledgePurchase(params) { billingResult ->
    ackResult = billingResult
  }
  return ackResult
}

suspend fun acknowledgePurchase(purchaseToken: String) {

  val retryDelayMs = 2000L
  val retryFactor = 2
  val maxTries = 3

  withContext(Dispatchers.IO) {
    acknowledge(purchaseToken)
  }

  AcknowledgePurchaseResponseListener { acknowledgePurchaseResult ->
    val playBillingResponseCode =
    PlayBillingResponseCode(acknowledgePurchaseResult.responseCode)
    when (playBillingResponseCode) {
      BillingClient.BillingResponseCode.OK -> {
        Log.i(TAG, "Acknowledgement was successful")
      }
      BillingClient.BillingResponseCode.ITEM_NOT_OWNED -> {
        // This is possibly related to a stale Play cache.
        // Querying purchases again.
        Log.d(TAG, "Acknowledgement failed with ITEM_NOT_OWNED")
        billingClient.queryPurchasesAsync(
          QueryPurchasesParams.newBuilder()
            .setProductType(BillingClient.ProductType.SUBS)
            .build()
        )
        { billingResult, purchaseList ->
          when (billingResult.responseCode) {
            BillingClient.BillingResponseCode.OK -> {
              purchaseList.forEach { purchase ->
                acknowledge(purchase.purchaseToken)
              }
            }
          }
        }
      }
      in setOf(
         BillingClient.BillingResponseCode.ERROR,
         BillingClient.BillingResponseCode.SERVICE_DISCONNECTED,
         BillingClient.BillingResponseCode.SERVICE_UNAVAILABLE,
       ) -> {
        Log.d(
          TAG,
          "Acknowledgement failed, but can be retried --
          Response Code: ${acknowledgePurchaseResult.responseCode} --
          Debug Message: ${acknowledgePurchaseResult.debugMessage}"
        )
        runBlocking {
          exponentialRetry(
            maxTries = maxTries,
            initialDelay = retryDelayMs,
            retryFactor = retryFactor
          ) { acknowledge(purchaseToken) }
        }
      }
      in setOf(
         BillingClient.BillingResponseCode.BILLING_UNAVAILABLE,
         BillingClient.BillingResponseCode.DEVELOPER_ERROR,
         BillingClient.BillingResponseCode.FEATURE_NOT_SUPPORTED,
       ) -> {
        Log.e(
          TAG,
          "Acknowledgement failed and cannot be retried --
          Response Code: ${acknowledgePurchaseResult.responseCode} --
          Debug Message: ${acknowledgePurchaseResult.debugMessage}"
        )
        throw Exception("Failed to acknowledge the purchase!")
      }
    }
  }
}

private suspend fun <T> exponentialRetry(
  maxTries: Int = Int.MAX_VALUE,
  initialDelay: Long = Long.MAX_VALUE,
  retryFactor: Int = Int.MAX_VALUE,
  block: suspend () -> T
): T? {
  var currentDelay = initialDelay
  var retryAttempt = 1
  do {
    runCatching {
      delay(currentDelay)
      block()
    }
      .onSuccess {
        Log.d(TAG, "Retry succeeded")
        return@onSuccess;
      }
      .onFailure { throwable ->
        Log.e(
          TAG,
          "Retry Failed -- Cause: ${throwable.cause} -- Message: ${throwable.message}"
        )
      }
    currentDelay *= retryFactor
    retryAttempt++
  } while (retryAttempt < maxTries)

  return block() // last attempt
}

Retriable BillingResult-Antworten

NETWORK_ERROR (Fehlercode 12)

Problem

Dieser Fehler weist auf ein Problem mit der Netzwerkverbindung hin. zwischen dem Gerät und den Play-Systemen.

Mögliche Lösung

Verwenden Sie zur Wiederherstellung einfache Wiederholungsversuche oder einen exponentiellen Backoff, je nachdem, Aktion hat den Fehler ausgelöst.

SERVICE_TIMEOUT (Fehlercode -3)

Problem

Dieser Fehler gibt an, dass die maximale Zeitüberschreitung für die Anfrage erreicht wurde, bevor Google Play antworten konnte. Dies kann beispielsweise durch eine Verzögerung bei der Ausführung der vom Play Billing Library-Aufruf angeforderten Aktion verursacht werden.

Mögliche Lösung

Das ist in der Regel nur vorübergehend. Wiederholen Sie die Anfrage entweder mit einem einfache oder exponentielle Backoff-Strategie, je nachdem, welche Aktion den Fehler.

Im Gegensatz zu SERVICE_DISCONNECTED unten wird die Verbindung zum Google Play Billing-Dienst nicht getrennt. Sie müssen nur den Play Billing Library-Vorgang noch einmal versuchen.

SERVICE_DISCONNECTED (Fehlercode -1)

Problem

Dieser fatale Fehler gibt an, dass die Verbindung der Clientanwendung zum Google Play Store-Dienst über BillingClient unterbrochen wurde.

Mögliche Lösung

Um diesen Fehler so weit wie möglich zu vermeiden, sollten Sie vor jedem Aufruf der Play Billing Library die Verbindung zu den Google Play-Diensten prüfen. Rufen Sie dazu BillingClient.isReady() auf.

Wenn Sie versuchen möchten, eine Wiederherstellung von SERVICE_DISCONNECTED auszuführen, sollte Ihre Clientanwendung versuchen, die Verbindung mit BillingClient.startConnection wiederherzustellen.

Verwenden Sie wie bei SERVICE_TIMEOUT einfache Wiederholungen oder exponentielles Backoff, je nachdem, welche Aktion den Fehler ausgelöst hat.

SERVICE_UNAVAILABLE (Fehlercode 2)

Wichtiger Hinweis:

Ab Google Play Billing Library 6.0.0 wird SERVICE_UNAVAILABLE bei Netzwerkproblemen nicht mehr zurückgegeben. Sie wird zurückgegeben, wenn der Abrechnungsdienst nicht verfügbar und die eingestellten SERVICE_TIMEOUT-Fallszenarien.

Problem

Dieser vorübergehende Fehler weist darauf hin, dass der Google Play-Abrechnungsdienst derzeit nicht verfügbar ist. In den meisten Fällen liegt ein Problem mit der Netzwerkverbindung vor. irgendwo zwischen dem Clientgerät und den Google Play Billing-Diensten.

Mögliche Lösung

Dies ist in der Regel ein vorübergehendes Problem. Wiederholen Sie die Anfrage mit einer einfachen oder exponentiellen Backoff-Strategie, je nachdem, welche Aktion den Fehler zurückgegeben hat.

„Gefällt mir“-Angabe für SERVICE_DISCONNECTED entfernen ist die Verbindung zum Google Play Billing-Dienst nicht getrennt und Sie benötigen um den gerade auszuführenden Vorgang zu wiederholen.

BILLING_UNAVAILABLE (Fehlercode 3)

Problem

Dieser Fehler gibt an, dass beim Kaufvorgang ein Abrechnungsfehler aufgetreten ist. Das kann unter anderem in folgenden Fällen passieren:

  • Die Play Store App auf dem Gerät des Nutzers ist veraltet.
  • Der Nutzer befindet sich in einem nicht unterstützten Land.
  • Der Nutzer ist ein Unternehmensnutzer und sein Administrator hat den Kauf für Nutzer deaktiviert.
  • Google Play kann die Zahlungsmethode des Nutzers nicht belasten. Beispiel: Der Parameter Die Kreditkarte des Nutzers ist möglicherweise abgelaufen.

Mögliche Lösung

In diesem Fall sind automatische Wiederholungsversuche wahrscheinlich nicht hilfreich. Ein manueller Wiederholungsversuch kann jedoch Hilfe, wenn der Nutzer die Ursache des Problems behoben hat. Wenn der Nutzer beispielsweise seine Play Store-Version auf eine unterstützte Version aktualisiert, kann ein manueller Neuversuch des ursprünglichen Vorgangs funktionieren.

Wenn dieser Fehler auftritt, während sich der Nutzer nicht in einer Sitzung befindet, führt ein neuer Versuch möglicherweise nicht dazu, Sinn. Wenn Sie eine BILLING_UNAVAILABLE erhalten, Fehler infolge des Kaufvorgangs verursacht haben, ist es sehr wahrscheinlich, dass der Nutzer Feedback von Google Play während des Kaufvorgangs erhalten und möglicherweise wissen, ist schiefgelaufen. In diesem Fall wird möglicherweise eine Fehlermeldung ist ein Fehler aufgetreten. Dem Nutzer wurde die Schaltfläche „Erneut versuchen“ angeboten, über die er noch einmal versuchen, nachdem sie das Problem behoben haben.

ERROR (Fehlercode 6)

Problem

Dies ist ein schwerwiegender Fehler, der auf ein internes Problem mit Google Play hinweist selbst.

Mögliche Lösung

Manchmal sind interne Google Play-Probleme, die zu ERROR führen, vorübergehend. Zur Abmilderung kann ein erneuter Versuch mit einem exponentiellen Backoff implementiert werden. Während einer Sitzung empfiehlt sich eine einfache Wiederholung.

ITEM_ALREADY_OWNED

Problem

Diese Antwort gibt an, dass der Google Play-Nutzer bereits Eigentümer des ein Produkt abonnieren oder einen einmaligen Kauf tätigen möchten. In den meisten Fällen ist dies kein vorübergehender Fehler, es sei denn, er wird durch einen veralteter Google Play-Cache.

Mögliche Lösung

Um zu vermeiden, dass dieser Fehler auftritt, wenn die Ursache kein Cache-Problem ist, sollten Sie keinen das Produkt zum Kauf anbieten, wenn es der Nutzenden bereits gehört. Prüfe die Berechtigungen des Nutzers, wenn du die zum Kauf verfügbaren Produkte präsentierst, und filtere die Produkte entsprechend. Wenn die Client-App aufgrund eines Cache-Problems diesen Fehler erhält, wird der Google Play-Cache mit den neuesten Daten aus dem Play-Backend aktualisiert. Wenn Sie nach dem Fehler noch einmal versuchen, sollte dieses Problem in diesem Fall behoben werden. BillingClient.queryPurchasesAsync() anrufen nachdem ein ITEM_ALREADY_OWNED um zu prüfen, ob die Nutzenden das Produkt erworben haben Implementieren Sie eine einfache Wiederholungslogik, um den Kauf erneut zu versuchen.

NICHT_EIGENEN ARTIKEL

Problem

Diese Kaufantwort gibt an, dass der Google Play-Nutzer nicht der Inhaber des Abo- oder Einmalkaufprodukt, das der Nutzer ersetzen möchte, zu bestätigen oder zu konsumieren. In den meisten Fällen ist dies kein vorübergehender Fehler, es sei denn, der Cache von Google Play ist veraltet.

Mögliche Lösung

Wenn der Fehler aufgrund eines Cache-Problems auftritt, wird der Google Play-Cache mit den neuesten Daten aus dem Play-Backend aktualisiert. Wird wiederholt mit einer einfachen Wiederholungsstrategie nach dem Fehler beheben, vorübergehende Instanz. Rufe BillingClient.queryPurchasesAsync() auf, nachdem du eine ITEM_NOT_OWNED erhalten hast, um zu prüfen, ob der Nutzer das Produkt gekauft hat. Falls nicht, kannst du mit einer einfachen Wiederholungslogik einen weiteren Kaufversuch starten.

Nicht abrufbare BillingResult-Antworten

Diese Fehler können nicht mithilfe der Wiederholungslogik behoben werden.

FEATURE_NOT_SUPPORTED

Problem

Dieser nicht wiederholbare Fehler gibt an, dass die Google Play Billing-Funktion auf dem Gerät des Nutzers nicht unterstützt wird, wahrscheinlich aufgrund einer alten Play Store-Version.

Zum Beispiel könnten die Geräte unterstützen In-App-Messaging nicht.

Mögliche Abhilfe

Verwenden Sie BillingClient.isFeatureSupported(), um die Funktionsunterstützung zu prüfen, bevor Sie die Play Billing Library aufrufen.

when {
  billingClient.isReady -> {
    if (billingClient.isFeatureSupported(BillingClient.FeatureType.IN_APP_MESSAGING)) {
       // use feature
    }
  }
}

NUTZER_ABGEBROCHEN

Problem

Der Nutzer hat die Benutzeroberfläche für den Abrechnungsvorgang verlassen.

Mögliche Lösung

Dies dient nur zur Information und kann ordnungsgemäß fehlschlagen.

ITEM_UNAVAILABLE

Problem

Das Google Play Billing-Abo oder das Produkt für einmaligen Kauf ist nicht für diesen Nutzer zum Kauf verfügbar.

Mögliche Abhilfe

Achten Sie darauf, dass die Produktdetails in Ihrer App wie empfohlen über queryProductDetailsAsync aktualisiert werden. Berücksichtigen Sie, wie oft Änderungen am Produktkatalog an der Play Console-Konfiguration, zusätzliche Aktualisierungen. Bieten Sie nur Produkte über Google Play Billing an, die über queryProductDetailsAsync die richtigen Informationen zurückgeben. Prüfen Sie die Konfiguration der Produktberechtigung auf Inkonsistenzen. Beispielsweise wird möglicherweise nach einem Produkt gesucht, das nur für eine andere Region als diejenige verfügbar ist, in der der Nutzer einen Kauf abschließen möchte. Damit ein Produkt gekauft werden kann, muss es aktiv und die zugehörige App veröffentlicht sein. Außerdem muss die App im Land des Nutzers verfügbar sein.

Manchmal, insbesondere während der Tests, ist im Produkt alles korrekt. Konfiguration, aber Nutzern wird dieser Fehler weiterhin angezeigt. Mögliche Gründe die Übertragung der Produktdetails auf den Google-Servern verzögert. Noch einmal versuchen .

DEVELOPER_ERROR

Problem

Dies ist ein schwerwiegender Fehler, der darauf hinweist, dass Sie eine API nicht ordnungsgemäß verwenden. Beispielsweise kann die Angabe falscher Parameter für BillingClient.launchBillingFlow diesen Fehler verursacht.

Mögliche Lösung

Achten Sie darauf, dass Sie die verschiedenen Aufrufe der Play Billing Library richtig verwenden. Weitere Informationen zum Fehler finden Sie in der Debug-Nachricht.