空间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
    });