addShortcut
优质
小牛编辑
118浏览
2023-12-01
>= IOS 4.5 >= android 5.8
使用说明 : 生成桌面快捷方式图标
注意 : IOS不支持回调
参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| 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: 'http://1105583577.urlshare.cn/?_proxy=1&_wv=16778245'
})
H5应用demo
window.mqq.invoke('ui','setOnAddShortcutHandler', {'callback':mqq.callback(function(){
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){}
});
}, false,true)});