空间H5游戏-客户端接口
mqq.ui.addShortcut
>= IOS 4.5>= android 5.8
使用说明
生成桌面快捷方式图标
注意 :
1. IOS不支持回调
2. 部分android定制ROM不支持创建快捷方式，icon一定要传一张可以访问的图片，否则创建快捷方式失败无任何提示，最好直接使用OPEN_DATA.appicon
3. 安卓机器有对生成桌面快捷方式做权限限制，如生成失败，可先检查是否开启权限
参数说明
mqq.ui.addShortcut(params)
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| params | Object | 是 | 调用参数 |
参数
params
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| action | String | 是 | 点击桌面快捷方式后，是用什么动作响应操作，目前只支持web打开方式。 |
| title | String | 是 | 标题，缺省的话就取当前页面的title |
| icon | String | 是 | 快捷方式图标，可以缺省，使用手Q默认icon |
| url | String | 是 | 点击快捷方式跳转的目标url，不可缺省 |
| callback(argus) | Function | 否 | 回调web端用到的关键字 |
| extras | Object|String | 否 | 需要透传给web端的数据，可缺省 |
回调
callback(argus)IOS not support>= android 5.8
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| argus | Object | 是 | 返回值 |
返回值
argus
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| result | Number | 是 | 设置结果 |
| resultData | Object|String | 是 | extras透传的数据 |
| message | String | 是 | 错误提示 |
设置结果
result
| 名称 | 类型 | 描述 |
|---|---|---|
| 0 | Number | 创建桌面快捷方式成功 |
| -1 | Number | url字段为空 |
| -2 | Number | 终端拿到的json格式解析出错 |
| -3 | Number | icon字段下载到的数据为空，或者下载到的不是图片数据 |
Example
mqq.ui.addShortcut({
action: 'web',
title: 'H5应用',
icon: 'http://i.gtimg.cn/open/app_icon/05/58/35/77/1105583577_100_m.png',
url: window.OPEN_DATA.jumpurl,
callback: function(ret){}
});