lib_unity_purchase/Documentation~/IAPButton.md

2.2 KiB
Raw Permalink Blame History

IAP Button (Legacy)

IAP Button (Legacy) is obsolete. Please use IAP Button. This new button allows for more UI customization and new events such as OnProductFetched(Product).

IAP Button is a way to purchase or restore products without writing code.

Adding IAP Button to the Scene

To add an IAP Button to your Scene, in the Unity Editor, select Window > Unity IAP > Create IAP Button (Legacy).

Creating a Codeless IAP Button in the Unity Editor

Restore Button

Some app stores, including iTunes, require apps to have a Restore button. Codeless IAP provides an easy way to implement a restore button in your app.

To add a Restore button:

  1. Add an IAP Button to your Scene (Services > In-App Purchasing > Create IAP Button).
  2. With your IAP Button selected, locate its IAP Button (Script) component in the Inspector, then select Restore from the Button Type drop-down menu (most of the component's other fields will disappear from the Inspector view). Modifying an IAP Button to restore purchases
  3. (Optional) You can add a script by clicking the plus (+) button to add a script to the On Transactions Restored (Boolean, String).
  4. (Optional) Drag the GameObject with the restore transactions script onto the event field in the components Inspector, then select your function from the dropdown menu.

On Transactions Restored script example:

public void OnTransactionsRestored(bool success, string? error)
{
    Debug.Log($"TransactionsRestored: {success} {error}");
}

When a user selects this button at run time, the button calls the purchase restoration API for the current store. This functionality works on the iOS App Store, the Mac App Store and the Windows Store. You may want to hide the Restore button on other platforms.

Unity IAP will always invoke the On Transactions Restored (Boolean, String) function on the Restore IAP Button with the result and the associated error message if the restore fails. If the restore succeeds, Unity IAP invokes the On Purchase Complete (Product) function on the IAP Button associated with that Product.