虚拟货币
运行机制
虚拟货币是用于购买及销售虚拟商品的电子货币。根据用途不同，虚拟货币可能影响游戏帐户余额或与应用的营收关联。
主要功能：
- 销售任意数量的虚拟货币或包含固定数量虚拟货币的单独套餐。
- 销售硬货币。
- 以真实货币或虚拟货币定价的形式销售虚拟货币或虚拟货币套餐。
- 限制虚拟货币套餐可购买的数量。
- 限制虚拟货币和虚拟货币套餐在商店中的显示时间。
- 免费商品。
注：
注意
在折扣促销活动、促销码或优惠券促销活动中，必须使用虚拟货币套餐。非固定数量的虚拟货币只能用在奖励促销活动中。
货币销售方案
虚拟货币有如下销售方案：销售任意数量的虚拟货币
销售用户指定数量的虚拟货币。请实现在应用程序客户端输入要购买的虚拟货币数量的请求。销售虚拟货币套餐
以预定义的固定数量为单位销售虚拟货币。此功能允许您以套餐形式销售游戏内货币，套餐的价格可以比单独购买相同数量的货币更低。
示例：您可以为套餐定义一个特殊价格，该价格不等于单独购买套餐内相同数量货币的价格。例如：1个虚拟币 = 1美元，500个虚拟币 = 450美元。
限制：
- 只能在套餐中添加一种虚拟货币。
- 可以在不指定真实或虚拟货币价格的情况下创建货币套餐。如此类商品在商店中显示，则对用户以免费形式提供。
- 虚拟货币的数量只能指定为整数值。
货币交付
现有交付方式：- 直接交付至艾克索拉物品库（默认方式）。交付之前，虚拟货币套餐会解开，其中的货币将发放至玩家物品库。
- 交付至PlayFab（如果配置了该集成）。
注：
如果游戏内商店逻辑在您自己的服务器上实现，则可配置购买Webhook。
硬货币
硬货币是与购买平台关联的货币，只能使用真实货币购买。
限制：
- 只能在初始设置中将货币的状态指定为硬货币。
- 包含硬虚拟货币的虚拟货币套餐只能使用真实货币购买。
要单独在其他平台上存储硬货币：
- 将付费虚拟货币开关设置为开。
- 调用物品库管理的API端点时，请将购买平台字符串传入
platform字段。
示例
Copy
- html
"platform": “playstation_network”
限制虚拟货币套餐可购买的数量
您可以限制虚拟货币套餐的购买次数。例如可以限制：
- 单个用户可购的虚拟货币套餐数量
- 仅可购买一次的新人虚拟货币套餐
如果用户已达到指定的数量限制，该虚拟货币套餐将不在目录中显示。
您可以显示套餐的最大可购数量以及该用户的剩余套餐可购数量。
要在发布商帐户中创建虚拟货币套餐时设置购买数量限制，请将限制单个用户可购买套餐的次数开关设置为开，并指定套餐的可购次数。
您可以使用虚拟物品和货币方法组中的目录子部分下的方法获取虚拟货币套餐的信息。
在响应中，除虚拟货币套餐的信息之外，还将收到以下信息：
- 单个用户虚拟货币套餐的最大可购数量
- 该用户的剩余虚拟货币套餐可购数量
关于如何设置或更新限制的更多信息，请参阅用户限制说明。
注：
Copy
- json
{
"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
}
]
}
注：
艾克索拉会确保不超过购买限制数并阻止用户购买超过设定限制的虚拟货币套餐。
打开支付界面并支付某个套餐后，所有包含该套餐的未支付订单将失效。
示例：假设某个套餐有购买数量限制，在下单之前，用户可以在多个浏览器选项卡中打开该套餐的支付表单。这样会自动为同一个套餐创建多个订单。在某个选项卡中购买了该套餐后，艾克索拉将自动让该套餐的所有其他未付订单失效。
限制虚拟货币和虚拟货币套餐在商店中的显示时间
您可以设置虚拟货币和虚拟货币套餐在商店中的显示时间，以实现以下目的：- 保持目录与某段时间的相关性，例如节假日促销期间
- 提前创建虚拟货币和虚拟货币套餐但不在目录中显示
- 通过在商品旁边显示计时器，激励用户购买虚拟货币和虚拟货币套餐
注：
使用建站器创建目录界面时，会自动显示计时器。在自己的界面中创建目录时，需实现计时器的显示。
适用对象
如何获取
前提条件
- 注册艾克索拉发布商帐户。
- 打开您的项目。
设置虚拟货币
可通过以下方式之一设置虚拟货币：在发布商帐户中设置虚拟货币
通过API调用设置虚拟货币
请使用虚拟物品和货币API端点管理子部分下的API调用。本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
