diff --git a/tutorials/platform/android/android_in_app_purchases.rst b/tutorials/platform/android/android_in_app_purchases.rst index 696249472..7d5e906aa 100644 --- a/tutorials/platform/android/android_in_app_purchases.rst +++ b/tutorials/platform/android/android_in_app_purchases.rst @@ -22,8 +22,8 @@ Initialize the plugin To use the ``GodotGooglePlayBilling`` API: 1. Access the ``BillingClient`` autoload singleton, it's automatically added when the plugin is enabled. -2. Connect to its signals to receive billing results -3. Call ``start_connection`` +2. Connect to its signals to receive billing results. +3. Call ``start_connection``. Initialization example: @@ -58,7 +58,7 @@ Return values for ``get_connection_state()``: DISCONNECTED, # This client was not yet connected to billing service or was already closed. CONNECTING, # This client is currently in process of connecting to billing service. CONNECTED, # This client is currently connected to billing service. - CLOSED # This client was already closed and shouldn't be used again. + CLOSED, # This client was already closed and shouldn't be used again. } @@ -66,9 +66,9 @@ Query available items ~~~~~~~~~~~~~~~~~~~~~ Once the API has connected, query product IDs using `query_product_details()`. You must successfully complete -an product details query before calling the ``purchase()``, ``purchase_subscription()``, or ``update_subscription()`` functions, +a product details query before calling the ``purchase()``, ``purchase_subscription()``, or ``update_subscription()`` functions, or they will return an error. ``query_product_details()`` takes two parameters: an array -of product ID strings, and the type of product being queried. +of product ID strings and the type of product being queried. The product type should be ``BillingClient.ProductType.INAPP`` for normal in-app purchases or ``BillingClient.ProductType.SUBS`` for subscriptions. The ID strings in the array should match the product IDs defined in the Google Play Console entry for your app. @@ -78,7 +78,7 @@ Example use of ``query_product_details()``: :: func _on_connected(): - BillingClient.query_product_details(["my_iap_item"], BillingClient.ProductType.INAPP) # BillingClient.ProductType.SUBS for subscriptions + BillingClient.query_product_details(["my_iap_item"], BillingClient.ProductType.INAPP) # BillingClient.ProductType.SUBS for subscriptions. func _on_query_product_details_response(query_result: Dictionary): if query_result.response_code == BillingClient.BillingResponseCode.OK: @@ -98,7 +98,7 @@ a product type to query. The product type should be ``BillingClient.ProductType.INAPP`` for normal in-app purchases or ``BillingClient.ProductType.SUBS`` for subscriptions. The ``query_purchases_response`` signal is sent with the result. The signal has a single parameter: a :ref:`Dictionary ` with -a response code and either an array of purchases or debug message. +a response code and either an array of purchases or a debug message. Only active subscriptions and non-consumed one-time purchases are included in the purchase array. @@ -107,7 +107,7 @@ Example use of ``query_purchases()``: :: func _query_purchases(): - BillingClient.query_purchases(BillingClient.ProductType.INAPP) # Or BillingClient.ProductType.SUBS for subscriptions + BillingClient.query_purchases(BillingClient.ProductType.INAPP) # Or BillingClient.ProductType.SUBS for subscriptions. func _on_query_purchases_response(query_result: Dictionary): if query_result.response_code == BillingClient.BillingResponseCode.OK: @@ -132,7 +132,7 @@ offers are `personallised