Store(Virtual Items)
This page contains details about retrieving of ids and purchase of Virtual Items

Virtual-Items

Virtual items are game items, that can be purchased using game currency or can be rewarded as completing certain threshold using Achievements
For example In
  • Racing Game : It can be different type of cars.
  • Puzzle game: It can be bunch of hints pack.
  • Match3 game: There can be different types of power ups.
  • Shooting Game: Different type of guns, Ammos etc
Virtual Items can be added in RGN Dev Dashboard. In order to retrieve list of virtual-items you can use following API.

Get Virtual Items

It retrieve the list of available Virtual items in RGN Dev Dashboard.
For this, you need to add a StoreModule in Initialization. Refer Initialize the RGN SDK
RGNCoreBuilder.AddModule(new StoreModule());

API call:

This needs to be called only once at start and you can cache this value of virtualItems in a variable.
StoreModule storeModule = RGNCoreBuilder.I.GetModule<StoreModule>();
RGNVirtualItems virtualItems = await storeModule.GetVirtualItems();
You will get list of RGNVirtualItem
public class RGNVirtualItem
{
public string name;
public string description;
public string itemId; // unique id
public string currency; // Currency name. i.e. coin, rgn-coin etc.
public int price; //price amount
public string category; // category i.e Game
public string subCategory;
public string purchasableRGNAppId;
// NFT parameter
public bool isNFT;
public int purchasedQuantity; // Already purchased quantity of NFT items
public int totalQuantity; // Total number of NFT items
}
For sample implementation, refer to the StoreTestPopUp Panel in our demo scene.

Purchase Virtual Item

In order to buy an Item, It requires to call the following function by passing Items’s unique id (string) as a parameter. (Before calling PurchaseVirtualItem, you can check the current available quantity of currency and required currency. )

API call:

StoreModule storeModule = RGNCoreBuilder.I.GetModule<StoreModule>();
RGNBuyItemData buyItemData = await storeModule.PurchaseVirtualItem(id);
Here is RGNBuyItemData, that you received in response of call. You will also get updated currencies(with deducted amount of item's price)
public class RGNBuyItemData
{
public bool isSuccess; //FALSE, Not have enough currencies
public string message;
public List<RGNCurrency> currencies = new List<RGNCurrency> ();
}
Copy link
On this page
Virtual-Items
Get Virtual Items
Purchase Virtual Item