AndroidIAPP is a plugin for the Godot game engine. It provides an interface to work with Google Play Billing Library version 7. The plugin supports all public functions of the library, passes all error codes, and can work with different subscription plans.
- Connect to Google Play Billing.
- Query purchases.
- Query product details.
- Make purchases and subscriptions.
- Update purchases.
- Consume and acknowledge purchases.
-
Install the plugin using Godot Asset Library.
or
-
Download the plugin from GitHub.
-
And place the unpacked plugin folder in the
res://addons/directory of the project.
Note
Dont forget to enable the plugin in the project settings.
- Example of a script for working with a plugin
-
Google Play Billing uses these three types of purchases:
- Products that will be consumed ("inapp").
- Products that will be acknowledged ("inapp").
- Subscriptions that will be purchased and consumed ("subs").
And their IDs should be passed to the function as a list of String elements. Even if there is only one ID, it still needs to be wrapped in a list.
-
All public methods and values returned by Google Play Billing are presented as a typed Godot dictionary. All dictionary keys represent the names of public methods written in snake_case style.
- getProductId ->
product_id - getSubscriptionOfferDetails ->
subscription_offer_details
See the variant of response here
- getProductId ->
-
The plugin also includes all standard BillingResponseCode messages as a key in the dictionary called
response_code. Additionally, it adds adebug_messagekey if the code indicates an error.
Returns a String value.
helloResponse: Emitted when a response to a hello message is received.
Does not return anything.
startConnection: Emitted when the connection to Google Play Billing starts.
connected: Emitted when successfully connected to Google Play Billing.
disconnected: Emitted when disconnected from Google Play Billing.
Returns a Dictionary of Godot type.
query_purchases: Emitted when a query for purchases is successful.
Returns a dictionary with purchases or subscriptions.
query_purchases_error: Emitted when there is an error querying purchases.
Returns a dictionary with error codes and debug message.
query_product_details: Emitted when a query for product details is successful.
Returns a dictionary with product or subscription details.
query_product_details_error: Emitted when there is an error querying product details.
Returns a dictionary with error codes and debug message.
purchase_error: Emitted when there is an error during the purchase process.
Returns a dictionary with error codes and debug message.
purchase_updated: Emitted when the purchase information is updated.
Returns a dictionary with purchases or subscriptions.
purchase_cancelled: Emitted when a purchase is cancelled.
Returns a dictionary with error codes and debug message.
purchase_update_error: Emitted when there is an error updating the purchase information.
Returns a dictionary with error codes and debug message.
purchase_consumed: Emitted when a purchase is successfully consumed.
Returns a dictionary with confirmation message.
purchase_consumed_error: Emitted when there is an error consuming the purchase.
Returns a dictionary with error codes and debug message.
purchase_acknowledged: Emitted when a purchase is successfully acknowledged.
Returns a dictionary with confirmation message.
purchase_acknowledged_error: Emitted when there is an error acknowledging the purchase.
Returns a dictionary with error codes and debug message.
startConnection(): Starts the connection to Google Play Billing, emit signals:
startConnectionsignal when connection is started.connectedsignal if connection is successful.
isReady(): Checks if the connection to Google Play Billing is ready and returns a boolean value.
sayHello() : Sends a hello message from the plugin.
For testing purposes, not recommended in production.
- Emit
helloResponsesignal - Sending Log.v message to the console
- Display a system toast.
queryPurchases(productType: String)
productType: "inapp" for products or "subs" for subscriptions.
Handling purchases made outside your app.
Note
I recommend calling it every time you establish a connection with the billing service.
Emit signals:
query_purchases: if a query for purchases is successful.query_purchases_error: if there is an error querying purchases.
queryProductDetails(productId: List<String>, productType: String): This function queries product of subscriptions details from Google Play Billing.
productId: ID of the product or subscription wrapped in a list.
productType: "inapp" for products or "subs" for subscriptions.
Note
You must pass the product type as a parameter. If you pass the wrong product type with the product IDs, like using subscription IDs with "inapp", it won't work and the function will return an error.
Emit signals:
query_product_details: If a query for product details is successful.query_product_details_error: If error :)
See an example of product details answer or subscription.
Note
This is where the biggest difference from the official plugin begins. If you have never used the old plugin before, you don't need to worry. But if you are planning to switch to this version, you should know that I have implemented two separate functions for buying products and subscribing to plans.
purchase(product_id: List<String>, is_personalized: bool): purchase a product from Google Play Billing.
product_id: ID of the product wrapped in a list.is_personalized: This is to ensure compliance with the EU directive, you can clarify this here, but if you don't understand why, just set it tofalse.
Emit signals:
purchase_updated: Emitted when the purchase information is updated. The purchase process was successful. Example of response
query_product_details_error: If an error occurred while receiving information about the product being purchased.purchase_error: If there is an error during the purchase process.purchase_cancelled: If a purchase is cancelled by the user.purchase_update_error: If there is an error updating the purchase information.
Important
Do not forget consume or acknowledge the purchase.
subscribe(subscription_id: List<String>, base_plan_id: List<String>, is_personalized: bool): subscribe to a subscription plan from Google Play Billing.
subscription_id: ID of the subscription wrapped in a list.base_plan_id: ID of the base subscription plan wrapped in a list.is_personalized: This is to ensure compliance with the EU directive, you can clarify this here, but if you don't understand why, just set it tofalse.
Emit signals:
purchase_updated: Emitted when the purchase information is updated. The purchase process was successful.query_product_details_error: If an error occurred while receiving information about the subscription being purchased.purchase_error: If there is an error during the purchase process.purchase_cancelled: If a purchase is cancelled by the user.purchase_update_error: If there is an error updating the purchase information.
Important
Do not forget acknowledge the subscription.
consumePurchase(purchase["purchase_token"]: consume a purchase from Google Play Billing.
purchase["purchase_token"]: Purchase token from purchase updated response.
Emit signals:
purchase_consumed: If a purchase is successfully consumed.purchase_consumed_error: If there is an error consuming the purchase.
acknowledgePurchase(purchase["purchase_token"]): acknowledge a purchase from Google Play Billing.
purchase["purchase_token"]: Purchase token from purchase updated response.
Emit signals:
purchase_acknowledged: If a purchase is successfully acknowledged.purchase_acknowledged_error: If there is an error acknowledging the purchase.
