จัดการโค้ดตอบกลับ Billingผลลัพธ์

เมื่อการเรียกใช้ Play Billing Library ทริกเกอร์การดำเนินการ ไลบรารีจะแสดงผลการตอบกลับ BillingResult เพื่อแจ้งผลลัพธ์ให้นักพัฒนาแอปทราบ เช่น หากคุณใช้ queryProductDetailsAsync เพื่อรับข้อเสนอที่ใช้ได้สำหรับผู้ใช้ โค้ดตอบกลับจะมีโค้ด OK และแสดงออบเจ็กต์ ProductDetails ที่ถูกต้อง หรือมีการตอบกลับอื่นที่ระบุเหตุผลที่ไม่สามารถแสดงออบเจ็กต์ ProductDetails ได้

โค้ดตอบกลับบางรายการไม่ใช่ข้อผิดพลาด หน้าอ้างอิง BillingResponseCode มีคำอธิบายโดยละเอียดของการตอบกลับแต่ละรายการที่กล่าวถึงในคู่มือนี้ ตัวอย่างโค้ดตอบกลับที่ไม่ได้ระบุข้อผิดพลาดมีดังนี้

  • BillingClient.BillingResponseCode.OK : การดำเนินการที่ทริกเกอร์โดยการโทรเสร็จสมบูรณ์แล้ว
  • BillingClient.BillingResponseCode.USER_CANCELED : สำหรับการดำเนินการที่แสดงขั้นตอน UI ของ Play Store แก่ผู้ใช้ การตอบกลับนี้บ่งชี้ว่าผู้ใช้ออกจากขั้นตอน UI เหล่านั้นโดยไม่ดำเนินการให้เสร็จสมบูรณ์

เมื่อโค้ดตอบกลับระบุข้อผิดพลาด บางครั้งสาเหตุอาจเกิดจากสภาวะชั่วคราว จึงอาจกู้คืนได้ เมื่อการเรียกใช้เมธอด Play Billing Library แสดงผลค่า BillingResponseCode ที่บ่งบอกถึงสภาวะที่กู้คืนได้ คุณควรลองเรียกใช้อีกครั้ง ในกรณีอื่นๆ เงื่อนไขจะไม่ถือว่าเกิดขึ้นชั่วคราว จึงไม่แนะนำให้ลองอีกครั้ง

ข้อผิดพลาดชั่วคราวต้องใช้กลยุทธ์การลองใหม่ที่แตกต่างกัน โดยขึ้นอยู่กับปัจจัยต่างๆ เช่น ข้อผิดพลาดเกิดขึ้นเมื่อผู้ใช้อยู่ในเซสชันหรือไม่ เช่น เมื่อผู้ใช้กำลังอยู่ในขั้นตอนการซื้อ หรือข้อผิดพลาดเกิดขึ้นในเบื้องหลัง เช่น เมื่อคุณค้นหาการซื้อที่มีอยู่ของผู้ใช้ระหว่าง onResume ส่วนกลยุทธ์การลองใหม่จะแสดงตัวอย่างกลยุทธ์ต่างๆ เหล่านี้ และส่วนBillingResultการตอบกลับที่คุณลองใหม่ได้จะแนะนำกลยุทธ์ที่เหมาะกับโค้ดตอบกลับแต่ละรายการมากที่สุด

นอกจากโค้ดตอบกลับแล้ว การตอบกลับข้อผิดพลาดบางรายการยังมีข้อความเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่องและการบันทึกด้วย

กลยุทธ์การลองใหม่

ลองอีกครั้งแบบง่าย

ในสถานการณ์ที่ผู้ใช้อยู่ในเซสชัน การใช้กลยุทธ์การลองใหม่แบบง่ายๆ จะดีกว่า เพื่อให้ข้อผิดพลาดรบกวนประสบการณ์ของผู้ใช้น้อยที่สุด ในกรณีนี้ เราขอแนะนำให้ใช้กลยุทธ์การลองใหม่แบบง่ายๆ โดยกำหนดจำนวนครั้งสูงสุดที่พยายามเป็นเงื่อนไขในการออก

ตัวอย่างต่อไปนี้แสดงกลยุทธ์การลองใหม่แบบง่ายเพื่อจัดการข้อผิดพลาดเมื่อสร้างการเชื่อมต่อ BillingClient

// Initialize the BillingClient.
private val billingClient = BillingClient.newBuilder(context)
    .setListener(this)
    .enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())
    .build()

private val coroutineScope = kotlinx.coroutines.CoroutineScope(
    kotlinx.coroutines.SupervisorJob() + kotlinx.coroutines.Dispatchers.Main.immediate
)

private var connectionJob: kotlinx.coroutines.Job? = null

// Establish a connection to Google Play.
fun startBillingConnection() {
    connectionJob?.cancel()
    connectionJob = coroutineScope.launch {
        connectWithRetry()
    }
}

// Suspended helper to perform a single connection attempt
private suspend fun connectBilling(): BillingResult =
    kotlinx.coroutines.suspendCancellableCoroutine { continuation ->
        billingClient.startConnection(object : BillingClientStateListener {
            override fun onBillingSetupFinished(billingResult: BillingResult) {
                if (continuation.isActive) {
                    continuation.resume(billingResult)
                }
            }

            override fun onBillingServiceDisconnected() {
                Log.e(TAG, "Google Play Billing Service disconnected")
                if (continuation.isActive) {
                    continuation.resume(
                        BillingResult.newBuilder()
                            .setResponseCode(BillingClient.BillingResponseCode.SERVICE_DISCONNECTED)
                            .setDebugMessage("Service disconnected during connection setup")
                            .build()
                    )
                } else {
                    startBillingConnection()
                }
            }
        })
    }

// Billing connection retry logic. This is a simple max retry pattern
private suspend fun connectWithRetry() {
    val maxTries = 3
    var tries = 1
    var isConnectionEstablished = false
    while (tries <= maxTries && !isConnectionEstablished) {
        val billingResult = connectBilling()
        if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
            isConnectionEstablished = true
            Log.d(TAG, "Billing response OK")
        } else {
            Log.e(TAG, "Billing connection retry failed: ${billingResult.debugMessage}")
            tries++
            if (tries <= maxTries) {
                delay(2000L) // Wait 2 seconds before retrying
            }
        }
    }
}

fun cleanUp() {
    coroutineScope.cancel()
}
// ...

ลองอีกครั้งโดยใช้ Exponential Backoff

เราขอแนะนำให้ใช้ Exponential Backoff สำหรับการดำเนินการของ Play Billing Library ที่เกิดขึ้นในเบื้องหลังและไม่ส่งผลต่อประสบการณ์ของผู้ใช้ขณะที่ผู้ใช้อยู่ในเซสชัน

ตัวอย่างเช่น การใช้กลยุทธ์นี้จะเหมาะสมเมื่อรับทราบการซื้อใหม่ เนื่องจากสามารถดำเนินการนี้ในเบื้องหลังได้ และไม่จำเป็นต้องรับทราบแบบเรียลไทม์หากเกิดข้อผิดพลาด

private suspend fun acknowledge(purchaseToken: String): BillingResult =
    kotlinx.coroutines.suspendCancellableCoroutine { continuation ->
        val params = AcknowledgePurchaseParams.newBuilder()
            .setPurchaseToken(purchaseToken)
            .build()
        billingClient.acknowledgePurchase(params) { billingResult ->
            continuation.resumeWith(Result.success(billingResult))
        }
    }

private suspend fun queryPurchases(productType: String): Pair<BillingResult, List<Purchase>> =
    kotlinx.coroutines.suspendCancellableCoroutine { continuation ->
        val params = QueryPurchasesParams.newBuilder()
            .setProductType(productType)
            .build()
        billingClient.queryPurchasesAsync(params) { billingResult, purchaseList ->
            continuation.resumeWith(Result.success(Pair(billingResult, purchaseList)))
        }
    }

suspend fun acknowledgePurchase(purchaseToken: String) {
    val retryDelayMs = 2000L
    val retryFactor = 2
    val maxTries = 3

    var tries = 1
    var currentDelay = retryDelayMs
    var acknowledgePurchaseResult: BillingResult

    do {
        acknowledgePurchaseResult = acknowledge(purchaseToken)
        val playBillingResponseCode = acknowledgePurchaseResult.responseCode

        when (playBillingResponseCode) {
            BillingClient.BillingResponseCode.OK -> {
                Log.i(TAG, "Acknowledgement was successful")
                return
            }

            BillingClient.BillingResponseCode.ITEM_NOT_OWNED -> {
                Log.d(TAG, "Acknowledgement failed with ITEM_NOT_OWNED")
                val (billingResult, purchaseList) = queryPurchases(BillingClient.ProductType.SUBS)
                if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
                    purchaseList.forEach { purchase ->
                        acknowledge(purchase.purchaseToken)
                    }
                }
                return
            }

            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}"
                )
                if (tries < maxTries) {
                    delay(currentDelay)
                    currentDelay *= retryFactor
                    tries++
                } else {
                    break
                }
            }

            else -> {
                Log.e(
                    TAG,
                    "Acknowledgement failed and cannot be retried -- " +
                        "Response Code: ${acknowledgePurchaseResult.responseCode} -- " +
                        "Debug Message: ${acknowledgePurchaseResult.debugMessage}"
                )
                throw Exception("Failed to acknowledge the purchase!")
            }
        }
    } while (tries <= maxTries)

    throw Exception("Failed to acknowledge the purchase after $maxTries attempts!")
}

การตอบกลับ BillingResult ที่คุณลองอีกครั้งได้

NETWORK_ERROR (รหัสข้อผิดพลาด 12)

ปัญหา

ข้อผิดพลาดนี้บ่งชี้ว่าเกิดปัญหาเกี่ยวกับการเชื่อมต่อเครือข่ายระหว่างอุปกรณ์กับระบบ Play

การแก้ไขที่เป็นไปได้

หากต้องการกู้คืน ให้ใช้การลองอีกครั้งแบบง่ายหรือ Exponential Backoff โดยขึ้นอยู่กับการดำเนินการที่ทำให้เกิดข้อผิดพลาด

SERVICE_TIMEOUT (รหัสข้อผิดพลาด -3)

ปัญหา

ข้อผิดพลาดนี้บ่งชี้ว่าคำขอถึงระยะหมดเวลาสูงสุดก่อนที่ Google Play จะตอบกลับได้ ตัวอย่างเช่น ปัญหานี้อาจเกิดจากความล่าช้าในการดำเนินการตามคำขอที่เรียกใช้ Play Billing Library

การแก้ไขที่เป็นไปได้

ซึ่งโดยปกติแล้วปัญหานี้จะเกิดขึ้นเพียงชั่วคราว ลองส่งคำขออีกครั้งโดยใช้กลยุทธ์ Backoff แบบง่ายหรือแบบ Exponential ขึ้นอยู่กับการดำเนินการที่แสดงข้อผิดพลาด

การเชื่อมต่อกับบริการ Google Play Billing จะไม่ถูกตัดขาดเหมือนกับ SERVICE_DISCONNECTED และคุณเพียงแค่ต้องลองดำเนินการใดๆ ของ Play Billing Library ที่พยายามทำอีกครั้ง

SERVICE_DISCONNECTED (รหัสข้อผิดพลาด -1)

ปัญหา

ข้อผิดพลาดร้ายแรงนี้บ่งชี้ว่าการเชื่อมต่อของแอปไคลเอ็นต์กับบริการ Google Play Store โดยใช้ BillingClient ถูกตัดขาด

การแก้ไขที่เป็นไปได้

Play Billing Library เวอร์ชัน 8.0.0 เปิดตัวฟีเจอร์enableAutoServiceReconnection() เราขอแนะนำอย่างยิ่งให้คุณเปิดใช้ฟีเจอร์นี้เมื่อสร้าง BillingClient ซึ่งจะช่วยให้ไลบรารีพยายามสร้างการเชื่อมต่ออีกครั้งโดยอัตโนมัติเมื่อมีการเรียก API ของ Billing ขณะที่บริการถูกตัดการเชื่อมต่อ ซึ่งจะช่วยลดการเกิดข้อผิดพลาดนี้ได้อย่างมาก

Kotlin

val billingClient = BillingClient.newBuilder(context)
    .setListener(listener)
    .enablePendingPurchases(
        PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()
    )
    .enableAutoServiceReconnection() // Enable automatic service reconnection
    .build()

Java

BillingClient billingClient = BillingClient.newBuilder(context)
    .setListener(listener)
    .enablePendingPurchases()
    .enableAutoServiceReconnection() // Enable automatic service reconnection
    .build();
หากคุณเปิดใช้การเชื่อมต่อบริการอีกครั้งโดยอัตโนมัติ

Play Billing Library จะพยายามเชื่อมต่อใหม่โดยอัตโนมัติ หากคุณยังคงได้รับโค้ดตอบกลับ SERVICE_DISCONNECTED เมื่อทำการเรียก API แสดงว่าไลบรารีไม่สามารถเชื่อมต่อใหม่ได้หลังจากพยายามเชื่อมต่อโดยอัตโนมัติ ในกรณีนี้ คุณควรใช้ตรรกะการลองใหม่ในแอป ดังนี้

  • สำหรับการดำเนินการที่ผู้ใช้เริ่ม (ในเซสชัน): ให้ลองเรียก API ซ้ำแบบง่ายๆ ปัญหาที่สำคัญอาจเกิดขึ้นชั่วคราว
  • สำหรับคำขอที่ทำงานอยู่เบื้องหลัง: ให้ลองอีกครั้งโดยใช้ Exponential Backoff เพื่อหลีกเลี่ยงไม่ให้ระบบทำงานหนักเกินไปหากการตัดการเชื่อมต่อใช้เวลานาน
หากคุณไม่ได้เปิดใช้การเชื่อมต่อบริการอีกครั้งโดยอัตโนมัติ

เพื่อหลีกเลี่ยงข้อผิดพลาดนี้ให้มากที่สุด โปรดตรวจสอบการเชื่อมต่อกับบริการ Google Play ก่อนทำการเรียกใช้ Play Billing Library โดยเรียกใช้ BillingClient.isReady

หากต้องการพยายามกู้คืนจาก SERVICE_DISCONNECTED แอปไคลเอ็นต์ควรพยายามสร้างการเชื่อมต่ออีกครั้งโดยใช้ BillingClient.startConnection

เช่นเดียวกับ SERVICE_TIMEOUT ให้ใช้การลองใหม่แบบง่ายหรือ Exponential Backoff โดยขึ้นอยู่กับการดำเนินการที่ทำให้เกิดข้อผิดพลาด

SERVICE_UNAVAILABLE (รหัสข้อผิดพลาด 2)

หมายเหตุสำคัญ:

ตั้งแต่ Google Play Billing Library 6.0.0 เป็นต้นไป ระบบจะไม่แสดง SERVICE_UNAVAILABLE สำหรับปัญหาเกี่ยวกับเครือข่ายอีกต่อไป ระบบจะแสดงข้อผิดพลาดนี้เมื่อบริการเรียกเก็บเงินไม่พร้อมใช้งานและในกรณีที่เลิกใช้งาน SERVICE_TIMEOUT

ปัญหา

ข้อผิดพลาดชั่วคราวนี้บ่งชี้ว่าบริการ Google Play Billing ไม่พร้อมใช้งานในขณะนี้ ในกรณีส่วนใหญ่ ข้อผิดพลาดนี้หมายความว่ามีปัญหาการเชื่อมต่อเครือข่ายระหว่างอุปกรณ์ไคลเอ็นต์กับบริการ Google Play Billing

การแก้ไขที่เป็นไปได้

ซึ่งโดยปกติแล้วปัญหานี้จะเกิดขึ้นเพียงชั่วคราว ลองส่งคำขออีกครั้งโดยใช้กลยุทธ์ Backoff แบบง่ายหรือแบบ Exponential ขึ้นอยู่กับการดำเนินการที่แสดงข้อผิดพลาด

การเชื่อมต่อกับบริการ Google Play Billing จะไม่ถูกตัดขาด ซึ่งต่างจาก SERVICE_DISCONNECTED และคุณต้องลองดำเนินการที่พยายามทำอีกครั้ง

BILLING_UNAVAILABLE (รหัสข้อผิดพลาด 3)

ปัญหา

ข้อผิดพลาดนี้บ่งชี้ว่าเกิดข้อผิดพลาดในการเรียกเก็บเงินจากผู้ใช้ระหว่างกระบวนการซื้อ ตัวอย่างกรณีที่อาจเกิดเหตุการณ์นี้ขึ้น ได้แก่

  • แอป Play Store ในอุปกรณ์ของผู้ใช้ไม่ใช่เวอร์ชันล่าสุด
  • ผู้ใช้อยู่ในประเทศที่ไม่รองรับ
  • ผู้ใช้เป็นผู้ใช้ระดับองค์กร และผู้ดูแลระบบระดับองค์กรได้ปิดใช้ไม่ให้ผู้ใช้ทำการซื้อ
  • Google Play เรียกเก็บเงินจากวิธีการชำระเงินของผู้ใช้ไม่ได้ เช่น บัตรเครดิตของผู้ใช้อาจหมดอายุแล้ว
  • แอป Play Store ถูกบล็อกโดยระบบ (เช่น ในโหมดสำหรับเด็กที่ปรับแต่งโดย OEM) ในกรณีนี้ BillingResult จะมีข้อความแก้ไขข้อบกพร่อง Play Store ถูกบล็อก

การแก้ไขที่เป็นไปได้

  • การลองใหม่อัตโนมัติไม่น่าจะช่วยได้ในกรณีนี้ อย่างไรก็ตาม การลองใหม่ด้วยตนเองจะช่วยได้หากผู้ใช้แก้ไขเงื่อนไขที่เป็นสาเหตุของปัญหา ตัวอย่างเช่น หากผู้ใช้อัปเดตเวอร์ชัน Play Store เป็นเวอร์ชันที่รองรับ การลองดำเนินการเริ่มต้นอีกครั้งด้วยตนเองอาจได้ผล

  • หากข้อผิดพลาดนี้เกิดขึ้นเมื่อผู้ใช้ไม่ได้อยู่ในเซสชัน การลองใหม่อาจไม่สมเหตุสมผล เมื่อคุณได้รับข้อผิดพลาด BILLING_UNAVAILABLE อันเป็นผลมาจากขั้นตอนการซื้อ เป็นไปได้มากว่าผู้ใช้ได้รับความคิดเห็นจาก Google Play ในระหว่างขั้นตอนการซื้อและอาจทราบว่าเกิดข้อผิดพลาดอะไรขึ้น ในกรณีนี้ คุณสามารถแสดงข้อความแสดงข้อผิดพลาดที่ระบุว่าเกิดข้อผิดพลาดและมีปุ่มลองอีกครั้งเพื่อให้ผู้ใช้มีตัวเลือกในการลองอีกครั้งด้วยตนเองหลังจากแก้ไขปัญหาแล้ว

ERROR (รหัสข้อผิดพลาด 6)

ปัญหา

ข้อผิดพลาดร้ายแรงนี้บ่งบอกถึงปัญหาภายในของ Google Play เอง

การแก้ไขที่เป็นไปได้

บางครั้งปัญหาภายใน Google Play ที่ทำให้เกิด ERROR จะเกิดขึ้นชั่วคราว และสามารถลดปัญหาได้โดยการลองอีกครั้งด้วย Exponential Backoff เมื่อผู้ใช้อยู่ในเซสชัน การลองใหม่แบบง่ายๆ จะเป็นวิธีที่เหมาะสมกว่า

ITEM_ALREADY_OWNED

ปัญหา

การตอบกลับนี้บ่งชี้ว่าผู้ใช้ Google Play เป็นเจ้าของการสมัครใช้บริการหรือผลิตภัณฑ์ที่ซื้อครั้งเดียวซึ่งพยายามซื้ออยู่แล้ว ในกรณีส่วนใหญ่ ข้อผิดพลาดนี้ไม่ใช่ข้อผิดพลาดชั่วคราว เว้นแต่จะเกิดจากแคชของ Google Play ที่ไม่มีการอัปเดต

การแก้ไขที่เป็นไปได้

เพื่อหลีกเลี่ยงข้อผิดพลาดนี้เมื่อสาเหตุไม่ใช่ปัญหาเกี่ยวกับแคช อย่าเสนอขายผลิตภัณฑ์ที่ผู้ใช้เป็นเจ้าของอยู่แล้ว ตรวจสอบสิทธิ์ของผู้ใช้เมื่อแสดงผลิตภัณฑ์ที่พร้อมจำหน่าย และกรองสิ่งที่ผู้ใช้ซื้อได้ตามความเหมาะสม เมื่อแอปไคลเอ็นต์ได้รับข้อผิดพลาดนี้เนื่องจากปัญหาเกี่ยวกับแคช ข้อผิดพลาดจะทริกเกอร์แคชของ Google Play ให้อัปเดตด้วยข้อมูลล่าสุดจากแบ็กเอนด์ของ Play การลองอีกครั้งหลังจากเกิดข้อผิดพลาดควรแก้ไขอินสแตนซ์ชั่วคราวที่เฉพาะเจาะจงนี้ได้ในกรณีนี้ เรียกใช้ BillingClient.queryPurchasesAsync() หลังจากได้รับ ITEM_ALREADY_OWNED เพื่อตรวจสอบว่าผู้ใช้ได้รับไอเทมหรือไม่ และหากไม่ได้รับ ให้ใช้ตรรกะการลองใหม่แบบง่ายเพื่อพยายามซื้ออีกครั้ง

ITEM_NOT_OWNED

ปัญหา

การตอบกลับการซื้อนี้ระบุว่าผู้ใช้ Google Play ไม่ได้เป็นเจ้าของการสมัครใช้บริการหรือผลิตภัณฑ์ที่ซื้อครั้งเดียวที่ผู้ใช้พยายามแทนที่ รับทราบ หรือใช้ ในกรณีส่วนใหญ่ ข้อผิดพลาดนี้ไม่ใช่ข้อผิดพลาดชั่วคราว ยกเว้นเมื่อเกิดจากแคชของ Google Play อยู่ในสถานะเก่า

การแก้ไขที่เป็นไปได้

เมื่อได้รับข้อผิดพลาดเนื่องจากปัญหาเกี่ยวกับแคช ข้อผิดพลาดจะทริกเกอร์แคชของ Google Play ให้อัปเดตด้วยข้อมูลล่าสุดจากแบ็กเอนด์ของ Play การลองอีกครั้งด้วยกลยุทธ์การลองใหม่แบบง่ายๆ หลังจากเกิดข้อผิดพลาดควรแก้ไขอินสแตนซ์ชั่วคราวที่เฉพาะเจาะจงนี้ได้ เรียกใช้ BillingClient.queryPurchasesAsync() หลังจากได้รับ ITEM_NOT_OWNED เพื่อตรวจสอบว่าผู้ใช้ได้รับไอเทมแล้วหรือไม่ หากยังไม่ได้รับ ให้ใช้ตรรกะการลองใหม่แบบง่ายเพื่อพยายามทำการซื้ออีกครั้ง

การตอบกลับ BillingResult ที่ลองใหม่ไม่ได้

คุณไม่สามารถกู้คืนจากข้อผิดพลาดเหล่านี้โดยใช้ตรรกะการลองใหม่

FEATURE_NOT_SUPPORTED

ปัญหา

ข้อผิดพลาดที่ลองใหม่ไม่ได้นี้บ่งชี้ว่าอุปกรณ์ของผู้ใช้ไม่รองรับฟีเจอร์ Google Play Billing ซึ่งอาจเป็นเพราะใช้ Play Store เวอร์ชันเก่า

ตัวอย่างเช่น อุปกรณ์ของผู้ใช้บางรายอาจไม่รองรับการรับส่งข้อความในแอป

การผ่อนปรนชั่วคราวที่อาจเป็นไปได้

ใช้ BillingClient.isFeatureSupported เพื่อตรวจสอบการรองรับฟีเจอร์ก่อนเรียกใช้ Play Billing Library

when {
    billingClient.isReady -> {
        val billingResult =
            billingClient.isFeatureSupported(BillingClient.FeatureType.IN_APP_MESSAGING)
        if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
            // use Feature
        }
    }
}

USER_CANCELED

ปัญหา

ผู้ใช้คลิกออกจาก UI ของโฟลว์การเรียกเก็บเงิน

การแก้ไขที่เป็นไปได้

ข้อมูลนี้มีไว้เพื่อแจ้งให้ทราบเท่านั้น และอาจไม่สำเร็จได้โดยไม่มีผลกระทบใดๆ

ITEM_UNAVAILABLE

ปัญหา

ผลิตภัณฑ์การสมัครใช้บริการ Google Play Billing หรือการซื้อครั้งเดียวไม่พร้อมให้ผู้ใช้รายนี้ซื้อ

การผ่อนปรนชั่วคราวที่อาจเป็นไปได้

ตรวจสอบว่าแอปรีเฟรชรายละเอียดสินค้าโดยใช้ queryProductDetailsAsync ตามที่แนะนำ พิจารณาความถี่ที่แคตตาล็อกสินค้าเปลี่ยนแปลงในการกำหนดค่า Play Console เพื่อใช้การรีเฟรชเพิ่มเติมหากจำเป็น พยายามขายผลิตภัณฑ์ใน Google Play Billing ที่แสดงข้อมูลที่ถูกต้องโดยใช้ queryProductDetailsAsync เท่านั้น ตรวจสอบการกำหนดค่าการมีสิทธิ์ของผลิตภัณฑ์เพื่อหาความไม่สอดคล้องกัน เช่น คุณอาจค้นหาผลิตภัณฑ์ที่พร้อมให้บริการในภูมิภาคอื่นนอกเหนือจากภูมิภาคที่ผู้ใช้พยายามซื้อเท่านั้น ผลิตภัณฑ์จะต้องอยู่ในสถานะใช้งานอยู่ จะต้องมีการเผยแพร่แอปของผลิตภัณฑ์นั้น และแอปจะต้องพร้อมให้บริการในประเทศของผู้ใช้เพื่อให้ผลิตภัณฑ์พร้อมจำหน่าย

บางครั้ง โดยเฉพาะในระหว่างการทดสอบ ทุกอย่างในการกำหนดค่าผลิตภัณฑ์ถูกต้อง แต่ผู้ใช้ยังคงเห็นข้อผิดพลาดนี้ ซึ่งอาจเกิดจากความล่าช้าในการเผยแพร่รายละเอียดสินค้าในเซิร์ฟเวอร์ของ Google โปรดลองอีกครั้งในภายหลัง

DEVELOPER_ERROR

ปัญหา

ข้อผิดพลาดร้ายแรงนี้บ่งบอกว่าคุณใช้ API อย่างไม่ถูกต้อง ตัวอย่างเช่น การระบุพารามิเตอร์ที่ไม่ถูกต้องให้กับ BillingClient.launchBillingFlow อาจทำให้เกิดข้อผิดพลาดนี้

การแก้ไขที่เป็นไปได้

ตรวจสอบว่าคุณใช้การเรียกใช้ Play Billing Library ที่แตกต่างกันอย่างถูกต้อง นอกจากนี้ ให้ตรวจสอบข้อความแก้ไขข้อบกพร่องเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาด