BillingClient.Builder
public final class BillingClient.Builder
Builder to configure and create a BillingClient instance.
All methods in the class can be called from any thread, and results will be posted to the same thread.
Summary
Public methods |
|
|---|---|
BillingClient |
build()Creates a Billing client instance. |
BillingClient.Builder |
Enables the ability to offer alternative billing without user choice to use Google Play billing. |
BillingClient.Builder |
Enables automatic reconnection to the billing service in case of a disconnection. |
BillingClient.Builder |
Enables the ability to offer a given billing program. |
BillingClient.Builder |
enableBillingProgram(int program)Enables the ability to offer a given billing program. |
BillingClient.Builder |
This method is deprecated. Use |
BillingClient.Builder |
enablePendingPurchases(PendingPurchasesParams pendingPurchasesParams)Enables pending purchase support. |
BillingClient.Builder |
enableUserChoiceBilling(Enables the ability for users to select an alternative billing option during the purchase flow and registers a listener. |
BillingClient.Builder |
setListener(PurchasesUpdatedListener listener)Specifies a valid listener for |
Public methods
build
public BillingClient build()
Creates a Billing client instance.
After creation, it will not yet be ready to use. You must initiate setup by calling startConnection and wait for setup to complete.
| Returns | |
|---|---|
BillingClient |
BillingClient instance |
| Throws | |
|---|---|
java.lang.IllegalArgumentException |
if Context or PurchasesUpdatedListener were not set. |
enableAlternativeBillingOnly
public BillingClient.Builder enableAlternativeBillingOnly()
Enables the ability to offer alternative billing without user choice to use Google Play billing.
enableAutoServiceReconnection
public BillingClient.Builder enableAutoServiceReconnection()
Enables automatic reconnection to the billing service in case of a disconnection.
enableBillingProgram
public BillingClient.Builder enableBillingProgram(EnableBillingProgramParams params)
Enables the ability to offer a given billing program.
Calling this method multiple times with different billing programs will enable all of them.
enableBillingProgram
public BillingClient.Builder enableBillingProgram(int program)
Enables the ability to offer a given billing program.
Calling this method multiple times with different billing programs will enable all of them.
enableExternalOffer
public BillingClient.BuilderenableExternalOffer()
Enables provision of an external offer.
enablePendingPurchases
public BillingClient.Builder enablePendingPurchases(PendingPurchasesParams pendingPurchasesParams)
Enables pending purchase support.
Call this method to enable pending purchases in your application. Pending purchases aren’t automatically enabled to ensure that entitlements aren't granted until the payment is secured. For more information on how to handle pending transactions see the Pending purchases section in the integration guide.
| Parameters | |
|---|---|
PendingPurchasesParams pendingPurchasesParams |
Params to specify the type of pending purchase. |
enableUserChoiceBilling
public BillingClient.Builder enableUserChoiceBilling(
UserChoiceBillingListener userChoiceBillingListener
)
Enables the ability for users to select an alternative billing option during the purchase flow and registers a listener.
| Parameters | |
|---|---|
UserChoiceBillingListener userChoiceBillingListener |
The listener for the result of the user choice billing operation returned asynchronously through the callback. |
setListener
public BillingClient.Builder setListener(PurchasesUpdatedListener listener)
Specifies a valid listener for PurchasesUpdatedListener.onPurchasesUpdated events.
| Parameters | |
|---|---|
PurchasesUpdatedListener listener |
Your listener for app initiated and Play Store initiated purchases. |