addShortcut
优质
小牛编辑
124浏览
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)});