创建桌面快捷方式

综述

该功能用于在手机桌面创建App功能的快捷方式。(请调用者注意:受限于Android各厂商系统的限制和碎片化,本接口在一些Android手机内成功概率不是很高,不保证绝对的创建成功

接口定义和调用方式

创建桌面快捷方式

一、综述

该功能用于在手机桌面创建App功能的快捷方式。(请调用者注意:受限于Android各厂商系统的限制和碎片化,本接口在一些Android手机内成功概率不是很高,不保证绝对的创建成功


强调说明:7.3.0以上版本才支持此接口,低于7.3.0的旧版本不支持此接口。
cmblapi接口调用方法请参考
cmblapi调用方法(新)


接口名

createShortcut

参数

属性类型默认值必填说明最低版本
shortcutNamestring

快捷方式名称,最长8个字节,不允许为空
iconUrlstring
快捷方式的图标地址,图片尺寸180*180px,PNG格式,大小建议不超过30KB
urlstring
唤醒App的快捷链接url,仅支持 cmbmobilebank:// 开头的链接

如果是需要打开手机银行小程序,请用cmbmobilebank://cmbls/functionjump?action=gocorpno&corpno=123456形式的url,其中corpno是小程序商户号

descriptionstring
客户端弹框提示用户的描述信息,如果为空客户端显示默认提示信息
successfunction
接口调用成功的回调函数
failfunction
接口调用失败的回调函数


fail返回值

属性类型说明
errCodenumber错误码
errMsgstring错误信息


示例代码

  1. //跳转到生活频道

  2. cmblapi.createShortcut({

  3.  shortcutName:'生活频道',

  4.  iconUrl:'https://static.m.cmbchina.com/MStatic/Res/client/images/account.png',

  5.  url:'cmbmobilebank://cmbls/functionjump?action=gochannel&channelname=life',

  6.  success:function(){

  7. },

  8.  fail:function(res){

  9.      console.log(res);

  10. }

  11. })

  12. <br>

  1. //跳转到具体的商户/小程序页面

  2. cmblapi.createShortcut({

  3.  shortcutName:'生活频道',

  4.  iconUrl:'https://static.m.cmbchina.com/MStatic/Res/client/images/account.png',

  5.  url:'cmbmobilebank://cmbls/functionjump?action=gocorpno&corpno=123456',

  6.  success:function(){

  7. },

  8.  fail:function(res){

  9.      console.log(res);

  10. }

  11. })


其他说明

1、上线前请在测试环境和测试客户端进行测试,测试验证通过后方可上线。

2、测试过程中需要关注,添加桌面快捷方式后,图标在桌面上能否正常显示,是否美观。