游戏内道具索要接入流程

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

一、 接入流程

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.道具赠送
    被索要用户,点击索要消息进游戏支付,支付完成后游戏侧给索要者发道具并通知玩吧后台,完毕后平台侧在索要者的空间提示一条礼物到账的消息,索要者从该到账消息进入游戏可看到赠送成功的提示弹框