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

Kongregate 道具收费客户端API

在道具收费客户端API允许你打开标准Kongregate结算界面,使用户能够购买你游戏中的虚拟物品。

安装

为了使用这个API,你的游戏必须由管理员授予特殊权限。这将允许您通过添加/items到你游戏网址的末尾进入到项目管理工具:
http://www.kongregate.com/games/BenV/mygame/items
您还应该审查执行一般Kongregate API的过程,因为本文档假定您可以获得Kongregate API对象。 API一旦加载,您可以从API上的mtx对象进入道具收费函数,例如kongregate.mtx.purchaseItems等

API函数

要求物品购买

你可以通过调用道具收费服务实例中的purchaceItems函数调出一个“购买物品”的对话框。该函数可以接受两种参数:1)物品标识数组,或者 2)标识./元对象数组,同时该函数可以传入一个回调函数用来接受购买结果,如下所示:
purchaseItems(items:Array, callback:Function):void
  • 项目:阵列 - 对项目或项目标识字符串数组/元数据对象。
  • 回调:函数 - 回调函数。

回调将被传入一个领域的单独对象参数:

  • •成功:Boolean - True,如果用户成功购买的物品

例如: 不使用元数据购买一把“剑”与一个“盾”,然后使用元数据购买一把“剑“等于"+1str"

// 不用元数据购买物品:
kongregate.mtx.purchaseItems(["sword","shield"], onPurchaseResult );

// 用元数据购买物品:
var items:Array=[{identifier:"sword",data:"+1str"}];
kongregate.mtx.purchaseItems(items, onPurchaseResult);

// 购买回调
function onPurchaseResult(result:Object){
  trace("Purchase success:" + result.success);
}
第二次调用显示如何连接字符串的元数据到物品实例,之后你可以从服务器检索。重要的是要注意,客户可以使用的浏览器插件轻而易举地改变这个数据,因此将这个字符串模糊是个好办法,以及验证其有效性,因为它与你的游戏相关。

请求用户物品实例

清单上的任何用户可以请求使用requestUserItemList方法。此函数将一个用户名字符串作为第一个参数,但你可以输入null或空字符串使它作为当前用户的清单。第二个参数是回调函数当检索完成时调用。
requestUserItemList(username:String,callback:Function):void
  • •用户名:字符串 - 输入用户名或null(空字符串)使它作为当前用户的清单
  • c• 回调:函数 - 回调函数

回调将被传入一个单独对象参数,它有两个领域:

  • •成功:Boolean - True 如果成功的话
  • • 数据:阵列 – 物品实例对象名单(如果成功的话):
    • id:编号 - 数据库的物品实例ID
    • 标识符:字符串 - 物品标识符字符串
    • 数据:字符串 - 物品数据(附于结算时间)
    • 剩余使用:数 - 剩余使用次数

例如: 为当前玩家提供清单

// 为当前玩家提供清单
kongregate.mtx.requestUserItemList(null, onUserItems);

// 回调函数
function onUserItems(result:Object):void{
  trace("User item list received, success: " + result.success);
  if( result.success ){
    for( var i:int = 0; i < result.data.length; i++ ){
      var item:Object = result.data[i];
      trace((i+1) + ". " + item.identifier + ", " + item.id + "," + item.data);
    }
  }
}

处理访客用户

既然Kongregate上的访客用户不允许购买物品,您必须决定要如何在你的游戏中处理它们。一般来说,每当访客用户要购买一件物品,显示一条消息让他们知道他们必须登录或注册才可以购买是个不错的办法,然后显示登录亮框。此过程更详细的文档可以在这里找到。