注意:此功能目前在封闭测试阶段,它将无法正常工作,除非你的游戏是在测试计划中。如果你觉得你是一个很好的测试此功能的候选人,那么请告诉我们

概览

这份文件将向你简要概述Kongregate的道具收费服务是怎样工作的,以及如何使用它来出售你游戏的虚拟物品。这是针对拥有自己后端的开发商,并且可以实现安全的服务器到服务器的交易。

Kongregate玩家可以购买Kreds和使用它们做各种事情比如给游戏开发商小费,购买Kongai卡,以及购买游戏中的虚拟物品。将虚拟物品添加到您的游戏是一个简单的过程,也是为您的游戏增加收入的一个好办法。

服务器API是用于查询Kongregate服务器上关于物品信息和玩家库存的,而客户端API使您可以进入标准的购物车用户界面来购买虚拟物品。

安装

为了使用道具收费,你的游戏必须由管理员授予特殊权限。这将允许您通过添加items到您游戏网址的结尾访问,例如:

http://www.kongregate.com/games/BenV/mygame/items

物品消耗

对于连接Kongregate的道具收费系统的第一步是思考你想在你的游戏里出售什么。我们发现,一般来说,出售游戏内部货币,如金币,信用,或点数非常有效。通常,开发人员将以一定数额的Kreds“打包”出售这个货币,给大包以折扣。随后您的游戏可以检查玩家的库存,消耗的包装,并奖励你自己的游戏内部货币给玩家。一旦包装在我们的终端上已被使用/消耗,当你请求玩家的库存时将不再显示。玩家可以使用奖励的货币购买你游戏里的物品。

Kongregate支持通过我们所说的“限制使用”的物品的交易形式。当您定义您的物品时,您可以正在从玩家的库存中移除前设置它可“使用”或“消耗”的次数。通常你会希望将此值设置为1,这意味着一旦使用该物品后,它便会从Kongregate数据库中删除。

例如,假设你有一个游戏,出售物品是金币。您可能设置一个物品是500金币一包。当用户购买其中一包时,你提出服务器到服务器请求问Kongregate该用户的库存有哪些物品。服务器响应说,用户的库存里有一个“500金币”。您的服务器然后应该通过向Kongregate发出一个网络请求“使用”该物品,如果这是成功的,玩家应该在你的游戏获得500金币。如果你立即再次从Kongregate请求玩家的库存,这将是空的,因为该物品已被成功地消耗。

我们推荐这个“消耗”的方法是由于它的简单性和灵活性。它可以减少你在Kongregate上需要管理的物品数量,因为你通常只有少数货币包让你出售。它使你无需在我们终端做任何改变就可以自由地在你的游戏客户端添加新的可出售的物品。如果你恰好有需要管理你的游戏多道具收费系统,它还允许更高等级的抽象。

创建你的物品

为了创建您的物品,您只需添加/items到您的游戏网址结尾(如果_preview字符串先删除)。这会把你带到物品创建用户界面。使用这个界面您可以添加,修改并为你游戏的物品贴标签。一旦您创建了一个物品,它可立即使用。

物品有和它们相联系的几条数据:

  • Identifier:该物品的标识符字符串。用户不会看不到这个,但你可以使用它来存储关于物品的信息,如“gold-500”
  • Name:可见的物品名称,用户将看到终端。
  • Description:对该物品的描述。显示在购物车上。
  • Price:在Kreds上物品的价格
  • Uses:您可以给物品多个标签
  • Tags:在从玩家的库存里删除之前,该物品可使用的次数

购买物品

您可以使用道具收费客户端API,以此进入标准购物车用户界面。在这一点上,我们将提示用户购买Kreds如果他们没有。当登出窗口关闭时客户端API可以让你注册一个回调,此时你可以让你的游戏服务器知道玩家的库存需要进行检查。

库存失效

当一个用户购买一个物品,这在他们的库存中显示无效。当发生这种情况时,您的服务器需要请求我们从后端的更新库存。这可以使用道具收费网络服务API。如果玩家的库存里有有限使用的物品,你需要重复更新然后使用每个物品。每次成功使用物品后,有关物品或货币应该通过你的游戏服务器奖励给玩家。

我们强烈建议您在您的服务器逻辑创建一个简单的invalidateInventory函数为此类玩家执行这个步骤。此函数应在用户进行身份验证后以及每当用户购买一个物品时立即被调用。当一名玩家的库存进行一次购买需要检查后游戏客户端可以通知服务器,你也可以使用网络服务回调

补充

要开始,请继续阅读客户端API服务器API 文件。

Edit | Translate | Destroy