道具索要功能接入指引

游戏内道具索要接入流程

道具索要目前只支持结合版

一、 接入流程

1.在游戏内点击"道具索要"按钮，调用平台提供的方法：mqq.ui.shareMessage(params, callback)，之后选择QQ好友发送索要链接：

参数说明

mqq.ui.shareMessage(params, callback)

名称 类型 描述
params Object 必选：是
说明：参数
callback(result) Function 必选：是
说明：注册回调

参数：params

名称 类型 必选 描述
type String 是 必填，值为'askforEquip',不能自行更改
name String 是 必填，道具名称，不能超过8个汉字。
price Number 是 必填，道具的价格，单位为星币（10星币=1人民币）
image_url String 是 必填，道具的图片地址
share_url String 是 必填，分享的url
id Number 是 必填，道具id
color Number 是 必填，道具弹框的颜色，有三个颜色可选： 1：蓝色，2:暗黄色，3：橘红色，默认为3：橘红色，可根据游戏的背景色自行选择

调用示例：

mqq.ui.shareMessage({
    type: 'askforEquip',
    name: '道具名称',
    price: '道具价格',
    image_url: '道具图片地址',
    color: 1,
    id: 12345
    }, function(result){
    console.log(result);
});

2.进入游戏，在window对象上定义方法__sendEquip,在该方法中完成以下步骤： 1.查星币余额 2.支付 3.换道具 4.发货 5.调用openapi通知玩吧后台发货完毕 具体逻辑如下：

定义示例：

    window.__sendEquip = function(){
        //查余额、（支付）、换道具、发货、调用openapi通知玩吧后台
    };

3.道具索要相关的参数定义在window.OPEN_DATA.equip对象上，equip对象只有在通过索要消息和赠送消息进入游戏时才存在，具体参数如下：

参数：window.OPEN_DATA.equip

名称 描述
askerName 索要者昵称
askerAvatar 索要者头像url地址
senderName 赠送者昵称
senderAvatar 赠送者头像url地址
name 道具名称
price 道具价格
id 道具id
imgUrl 道具图片url地址
color 索要弹框颜色
appName 游戏名称

二、 道具图片视觉规范：

三、 道具索要、赠送逻辑简介

1.道具索要
    索要用户点击游戏内“道具索要”按钮，从QQ好友中选择一个好友，发送索要消息
2.道具赠送
    被索要用户，点击索要消息进游戏支付，支付完成后游戏侧给索要者发道具并通知玩吧后台，完毕后平台侧在索要者的空间提示一条礼物到账的消息，索要者从该到账消息进入游戏可看到赠送成功的提示弹框