Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wolf-org/in-app-purchasing-unity
Support Unity IAP
https://github.com/wolf-org/in-app-purchasing-unity
iap in-app-purchase unity
Last synced: about 23 hours ago
JSON representation
Support Unity IAP
- Host: GitHub
- URL: https://github.com/wolf-org/in-app-purchasing-unity
- Owner: wolf-org
- License: mit
- Created: 2024-06-27T02:04:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-08-27T09:17:55.000Z (3 months ago)
- Last Synced: 2024-08-28T09:43:20.586Z (3 months ago)
- Topics: iap, in-app-purchase, unity
- Language: C#
- Homepage:
- Size: 85 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## What
### In-app-purchase support tool for unity games (Unity 2022.3)
## How To Install
### Add the line below to `Packages/manifest.json`
for version `1.0.7`
```csharp
"com.wolf-org.in-app-purchasing":"https://github.com/wolf-org/in-app-purchasing-unity.git#1.0.7",
```
dependency `extensions-unity-1.0.5`
```csharp
"com.wolf-org.extensions":"https://github.com/wolf-org/extensions-unity.git#1.0.5",
```
## Use
### Setup
- Use via MenuItem `Unity-Common` > `IapSettings` or shortcut `Ctrl + W / Command + W` to open `IapSettings`
- If you select `Runtime Auto Init` in `IapSettings` then `IapManager` will be created automatically after loading the scene. Otherwise you will have to attach `IapManager` to the scene to ensure purchases can be made
- Add data product to list (enter id and select product type), then click `Generate Product`
- Select `Validate Product` and enter `Google Play Store Key`, then click `Obfuscator Key`
- Don't forget add Define Symbol `VIRTUESKY_IAP`
- After clicking `Generate Product`, an `IapProduct.cs` script is generated in the following format
```csharp
public static class IapProduct
{
public const string ID_REMOVEADS = "com.test.removeads";
public static IapDataProduct PurchaseRemoveads()
{
return IapManager.PurchaseProduct(IapSettings.Instance.IapDataProducts[0]);
}
public static bool IsPurchasedRemoveads()
{
return IapManager.IsPurchasedProduct(IapSettings.Instance.IapDataProducts[0]);
}
public const string ID_1000GEM = "com.test.1000gem";
public static IapDataProduct Purchase1000Gem()
{
return IapManager.PurchaseProduct(IapSettings.Instance.IapDataProducts[1]);
}
public static bool IsPurchased1000Gem()
{
return IapManager.IsPurchasedProduct(IapSettings.Instance.IapDataProducts[1]);
}
}
```
### Handle purchase product
- Example 1:
```csharp
public Button buttonRemoveAds;
///
/// refresh ui button remove ads
/// disable buttonRemoveAds if RemoveAds product has been purchased
///
void RefreshUI()
{
buttonRemoveAds.gameObject.SetActive(!IapProduct.IsPurchasedRemoveads());
}
///
/// Buy remove ads iap
///
public void OnClickRemoveAds()
{
IapProduct.PurchaseRemoveads().OnCompleted(() =>
{
// handle purchase success
RefreshUI();
}).OnFailed(() =>
{
// handle purchase failed
});
}
```
- Example 2: You create a new script similar to the demo below. then attach it to LoadingScene
```csharp
public class HandlePurchaseIap : MonoBehaviour
{
private void Awake()
{
DontDestroyOnLoad(this.gameObject);
IapManager.OnPurchaseSucceedEvent += HandlePurchaseSuccess;
IapManager.OnPurchaseFailedEvent += HandlePurchaseFailed;
}
void HandlePurchaseSuccess(string id)
{
switch (id)
{
case IapProduct.ID_REMOVEADS:
// handle
break;
case IapProduct.ID_1000GEM:
// handle
break;
}
}
void HandlePurchaseFailed(string id)
{
switch (id)
{
case IapProduct.ID_REMOVEADS:
// handle
break;
case IapProduct.ID_1000GEM:
// handle
break;
}
}
}
```
- Note: Example 1 is typically used to handle the user interface after a successful or failed purchase and cannot handle restore purchase. Therefore, you should use example 2 to handle logic for tasks such as removing ads, unlocking skins,...
- Check to see if the product has been purchased (only applies to Non-Consumable items)
```csharp
public Button buttonRemoveAds;
private void OnEnable()
{
if (IapProduct.IsPurchasedRemoveads())
{
buttonRemoveAds.gameObject.SetActive(false);
}
}
```
### Restore purchase
Restore purchase only applies to Non-Consumable items
Restore Purchase is a mandatory feature on iOS to be able to be released to the store.
On Android when you successfully purchased RemoveAds. Then you uninstall your game and reinstall it. If you click buy remove ads again, google play system will report that you already own this item and can't buy it again, now the user has removed ads but the game still displays ads (incorrect). We will need to handle restore purchase of the user's purchased items so that the user avoids this situation.
On Android restore purchase will be called automatically when you reinstall the game via method `ConfirmPendingPurchase` call in `OnInitialized`. On ios you will need to create a restore purchase button for the user to click
When the restore is successful, it will automatically call the successful purchase callback of each item for further processing for the user
```csharp
public void OnClickRestorePurchase()
{
#if UNITY_IOS
IapManager.RestorePurchase();
#endif
}
```