shortcutCreator

立即使用

概述

该模块实现了android端app快捷方式的创建

注意

该模块创建快捷方式之前需要允许创建快捷方式的权限,请引导用户进入app权限设置页面进行设置

模块接口

createShortcut

创建快捷方式

createShortcut(callback(ret))

params

name:

  • 类型:字符串
  • 描述:快捷方式的名称

icon:

  • 类型:字符串
  • 描述:图标路径(支持 widget, fs, box及android本地路径)

url:

  • 类型:字符串
  • 描述:快捷方式需要打开的url地址

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
  status:true,           //布尔类型;是否成功;注意:该参数返回true只表明该操作成功执行,不代表成功创建快捷方式,如果没有创建成功需要引导用户打开权限页面打开权限
}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg: '错误信息'  // 字符串类型;错误信息
}

示例代码

var shortcutCreator = api.require('shortcutCreator');
shortcutCreator.createShortcut({
        name:'shortcut',
        icon:'widget://image/shortcut.png',
        url:'https://www.yonyou.com'
},function(ret, err) {
    api.alert({ msg:JSON.stringify(ret)});
});

可用性

Android系统

可提供的 1.0.0 及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/11/18