虚拟货币

运行机制
适用对象
如何获取

运行机制

虚拟货币是用于购买及销售虚拟商品的电子货币。根据用途不同，虚拟货币可能影响游戏帐户余额或与应用的营收关联。

主要功能：

销售任意数量的虚拟货币或包含固定数量虚拟货币的单独套餐。
销售硬货币。
以真实货币或虚拟货币定价的形式销售虚拟货币或虚拟货币套餐。
将货币交付至玩家物品库。
限制虚拟货币套餐可购买的数量。
免费商品。

如果要创建价格为0的虚拟货币或虚拟货币套餐，请联系您的帐户经理。

货币销售方案

虚拟货币有如下销售方案：

销售任意数量的虚拟货币
销售虚拟货币套餐

销售任意数量的虚拟货币

销售用户指定数量的虚拟货币。请实现在应用程序客户端输入要购买的虚拟货币数量的请求。

销售虚拟货币套餐

以预定义的固定数量为单位销售虚拟货币。此功能允许您以套餐形式销售游戏内货币，套餐的价格可以比单独购买相同数量的货币更低。

示例：您可以为套餐定义一个特殊价格，该价格不等于单独购买套餐内相同数量货币的价格。例如：1个虚拟币 = 1美元，500个虚拟币 = 450美元。

限制：

只能在套餐中添加一种虚拟货币。
可以在不指定真实或虚拟货币价格的情况下创建货币套餐。如此类商品在商店中显示，则对用户以免费形式提供。
虚拟货币的数量只能指定为整数值。

货币交付

现有交付方式：

直接交付至艾克索拉物品库（默认方式）。交付之前，虚拟货币套餐会解开，其中的货币将发放至玩家物品库。
交付至PlayFab（如果配置了该集成）。

如果游戏内商店逻辑在您自己的服务器上实现，则可配置购买Webhook。

硬货币

硬货币是与购买平台关联的货币，只能使用真实货币购买。

限制：

只能在初始设置中将货币的状态指定为硬货币。
包含硬虚拟货币的虚拟货币套餐只能使用真实货币购买。

要单独在其他平台上存储硬货币：

将付费虚拟货币开关设置为开。

调用物品库管理的API端点时，请将购买平台字符串传入platform字段。

示例

Copy

Full screen

Small screen

"platform": “playstation_network”

限制虚拟货币套餐可购买的数量

您可以限制虚拟货币套餐的购买次数。例如可以限制：

单个用户可购的虚拟货币套餐数量
仅可购买一次的新人虚拟货币套餐

如果用户已达到指定的数量限制，该虚拟货币套餐将不在目录中显示。

您可以显示套餐的最大可购数量以及该用户的剩余套餐可购数量。

要在发布商帐户中创建虚拟货币套餐时设置购买数量限制，请将限制单个用户可购买套餐的次数开关设置为开，并指定套餐的可购次数。

您可以使用虚拟物品和货币方法组中的目录子部分下的方法获取虚拟货币套餐的信息。

在响应中，除虚拟货币套餐的信息之外，还将收到以下信息：

单个用户虚拟货币套餐的最大可购数量
该用户的剩余虚拟货币套餐可购数量

对于未授权用户，将始终显示其可购买的最大虚拟货币套餐数量。要显示用户剩余可购买的虚拟货币套餐数量（取决于当前限制），使用虚拟物品和货币方法组目录子部分下的方法请求虚拟货币套餐目录时，请传入用户授权数据。

要正确显示用户可购的虚拟货币套餐数量，需配置身份认证。

响应示例：

Copy

Full screen

Small screen

{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}