 Monkey Documentation |
Class MonkeyStore
The MonkeyStore and Product classes allow apps to perform 'in app purchases' (IAP) on the ios, android and winrt(windows8.1) More...
| Methods: |
|
Detailed Discussion
The MonkeyStore and Product classes allow apps to perform 'in app purchases' (IAP) on the ios, android and winrt(windows8.1) targets.MonkeyStore only currently supports consumable and non-consumables products. Subscriptions and downloadable content are not supported.
The general process for using MonkeyStore in your apps is:
- Create a new MonkeyStore object inside your App's OnCreate method.
- Add products to the store using AddProducts.
- Open the store using OpenStoreAsync.
- Once the store is sucessfully open, buy products using BuyProductAsync.
- You can also enquire about products once the store is open using GetProduct or GetProducts.
- It is up to your app to keep track of purchased products, for example, in a file stored in monkey://internal/.
- If your app uses non-consumables, it can use GetOwnedProductsAsync to retreive a list of previously purchased non-consumables. This is for situations where the user may have reinstalled the app, or installed it on a different device. Note that on iOS, GetOwnedProductsAsync will cause an app store 'login' dialog to appear so it should only be used in response to a user interaction (eg: via clicking on a 'Restore Purchases' button).
- iOS apps that use non-consumables must provide a 'Restore Purchases' button or equivalent that restores previously purchased non-consumables, or they will fail app store requirements.
There's a bananas/mak/iaptest demo in the release, but it wont work 'as-is' - you'll need to add a keystore file for android; change the BundleID for ios; change the Product ID for winrt, and change the CONSUMABLES and NON_CONSUMABLES arrays to match your product ids.
Method Documentation
Adds multiple new products to the store.
Each element of ids is the Android or iOS 'product id' of the product to add.
type is the product type - consumable or non-consumable.
On iOS, you must ensure that type matches the product type selected in iTunes Connect, otherwise the results will be unpredictable!
On Android, the product type selected in the GooglePlay Developer Console must be 'managed' (MonkeyStore emulates consumable products on Android).
This method may only be called before OpenStoreAsync.
type must be one of:
| Type | Description |
|---|---|
| 1 | Consumable product |
| 2 | Non-consumable product |
Starts an async operation to buy a product.
When the operation completes, the OnBuyProductComplete method of the onComplete object is called.
Note that it is possible to buy the same non-consumable product multiple times, although the user will only be charged for the first purchase. It is up to your app to keep track of purchases and ensure the user is not presented with the option of repurchasing a non-consumable product.
This method may only be called after OpenStoreAsync successfully completes.
Starts an async operation to get an array of all non-consumable products owned by the user.
When the operation completes, the OnGetOwnedProductsComplete method of the onComplete object is called.
This method may only be called after OpenStoreAsync successfully completes.
On iOS, this method may cause an app store 'login' dialog to appear.
Gets the product corresponding to id, the iTunes connect or GooglePlay product identifier.
This method may only be called after OpenStoreAsync successfully completes.
Gets all products.
This method may only be called after OpenStoreAsync successfully completes.
Gets all products of the given type.
This method may only be called after OpenStoreAsync successfully completes.
type must be one of:
| Type | Description |
|---|---|
| 1 | Consumable product |
| 2 | Non-consumable product |
Starts an async operation to open the store.
When the operation completes, the OnOpenStoreComplete method of the onComplete object is called.