空间H5游戏-客户端接口
mqq.ui.shareArkMessage
结合版
>= IOS 7.2.5
>=android 7.2.5
注意:本接口只适用于于结合版。如果手Q版本低于7.2.5,会自动降级为旧版的shareMessage接口。
使用说明
调用客户端的大图分享接口,分享内容给QQ好友,调用后会弹出联系人选择列表。 使用接口之前,需要在管理端配置好游戏分享的图片,否则调用后分享的是空白图。
参数说明
mqq.ui.shareArkMessage(params, callback)
名称 | 类型 | 描述 |
---|---|---|
params | Object | 必选:是 说明:参数 |
callback(result) | Function | 必选:是 说明:注册回调 |
参数:
params
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
title | String | 是 | 必填,消息标题,最长8字节,建议为游戏名称。 |
desc | String | 是 | 必填,消息摘要,最长24字节。 |
share_url | String | 是 | 点击消息后的跳转url,最长120字节。 |
image_url | String | 是 | 消息左侧缩略图url。图片推荐使用正方形,宽高不够时等比例撑满,不会变形。建议为游戏logo。 |
bg_url | String | 否 | 消息底部大图url。图片规格446*350,png,80K内。必须上传到管理端才能使用。如果不带,则默认使用管理端配置的第一张图。 |
back | Boolean | 是 | >= IOS 7.2.5 >= android 7.2.5 发送消息之后是否返回到web页面,默认false,直接到AIO。 |
toUin | String | 否 | >= IOS 7.2.5 >= android 7.2.5 分享给指定的好友或群,如果存在这个参数,则不拉起好友选择界面 (针对分享给好友) |
uinType | String | 否 | >= IOS 7.2.5 >= android 7.2.5 分享给指定的好友或群的uin类型: 0:好友; 1:群 (针对分享给好友) |
1、与setOnShareHandler一起使用时,安卓客户端有bug,有一个loading页没有消除。这个问题会在手Q的755版本解决。
2、如果与mqq.ui.setOnShareHandler一起使用的话,需要判断share_type为0(分享给QQ好友)才能调用shareArkMessage。
3、因为安全风险,bg_url不要用自己CDN的图片链接,建议都把图片上传到管理端,再拷贝下来使用。如果使用自己的链接会被屏蔽,展示一张灰底默认图。
回调:
callback(result)
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
result | Object | 是 | 返回对象 |
回调参数
result
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
retCode | Number | 是 | 返回码 |
返回码
retCode
- 0 -- 用户点击发送,完成整个分享流程
- 1 -- 用户点击取消,中断分享流程
Example
mqq.ui.shareArkMessage({
title: '自定义的分享标题',
desc: '自定义的分享描述',
share_url: window.OPEN_DATA.shareurl,
image_url: 'http://i.gtimg.cn/open/app_icon/05/58/35/77/1105583577_100_m.png',
back: true
},function(result){
//result
});