GameAPI.InviteBox

1.功能说明

弹出好友选择器，发送大厅feed以及Tips以邀请好友进行游戏，前端JS接口。

Tips含游戏大厅Tips和QQTips，当大厅和QQ同时在线时，会优先发送大厅Tips；当大厅不在线时，会发送QQTips；QQ也不在线时，会保存为离线QQTips，在目标QQ下次登录时会显示。

接入Tips功能或者Feed功能时，游戏侧需要提交申请至qqgame产品接口人，接口人配置后方可接入。

2.调用说明

（1）调用本前端接口前，应用中应该部署GameAPI的脚本文件等，请参阅：Web前端接口GameAPI文档。

（2）请先向QQGame平台提供应用定义邀请字符串（不超过60中文字符）及应用邀请图片，通过审核后更新配置即可使用。如：

欢迎进入xx世界。。。

并提供一张74*74链接图片URL（注：建议图片格式为png/jpg/gif）

Tips的图片，尺寸规格为80*90（注：图片格式为静态gif）

（3）被邀请者接受邀请会启动游戏。游戏启动链接中会包含如下信息：

&invitor=OPENID&invkey=INVKEY¶m=GAMEPARA，其中:

invitor为邀请发起者的openid

invkey为邀请验证字段，后续会提供api验证该invkey的正确性

param为应用自定义参数（长度上限256bytes）

GameAPI.InviteBox.show(appid, opt, close_cb, invite_cb);

opt具体内容

参数名称	参数含义	可选/必选
title	组件标题	可选
intro	组件内容简介	可选
tabid	组件打开时默认展示的tab，0为"全部好友"，1为"蓝钻好友"，2为"玩过这个游戏的好友"	可选
gamepara	自定义参数，字符串类型，长度上限为128bytes，不能包含'\|'、'&'、'\\'、'='、'%'字符	可选
tips_id	取值：1~10 邀请组件提供推送qq tips功能(该功能需要联系qqgame产品开启)，本功能支持应用自定义邀请tips文本内容及tips图片，本字段为自定义tips的标识，由(由qqgame产品给到)，该字段为空，则发送默认内容	可选

function close_cb(result)

{

alert(result['resultstr']);

}

function invite_cb(result)

{

alert(result['resultstr']);

}

var param = {'title':'here is title', 'intro': 'here is your instroducton', 'tabid':0, 'gamepara':'hellogame','tips_id':1};

GameAPI.InviteBox.show(

10001,

param,

close_cb,

invite_cb

);

回调函数的传入参数result举例：{'result':0, 'resultstr':'success!', 'invnum':5}，应用可按此解析

好友选择器如下：

邀请成功后大厅feed展示：