# tap.createHomeScreenWidget(Object object)

相关文档: 桌面文件夹

# 功能描述

在桌面文件夹的快捷启动中新增对应游戏

# 参数

# Object object

属性	类型	默认值	必填	说明
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

# 错误

错误码	错误信息	说明
1518001	createHomeScreenWidget:fail app id is null or empty	appId 无效
1518002	createHomeScreenWidget:fail this game has been added before	重复添加
1518003	createHomeScreenWidget:fail this operation is not permitted by user	用户未授权在桌面添加快捷方式
1518004	createHomeScreenWidget:fail get remote service error	获取主进程服务失败
1518005	createHomeScreenWidget:fail unknown error	未知错误

# 示例代码

tap.createHomeScreenWidget({
  success: ({errMsg, errno}) => {
    /* 创建桌面小组件并把本小游戏放在桌面小组件列表的第一个 执行成功
    * @param errMsg 错误信息 
    * @param errno 错误码
    */
  },
  fail: ({errMsg, errno}) => {
 /* 创建桌面小组件并把本小游戏放在桌面小组件列表的第一个 执行失败
    * @param errMsg 错误信息 
    * @param errno 错误码
    */  
   },
  complete: ({errMsg, errno}) => {
    /* 创建桌面小组件并把本小游戏放在桌面小组件列表的第一个 执行完成
    * @param errMsg 错误信息 
    * @param errno 错误码
    */  
  }
})

« tap.authorize

tap.hasHomeScreenWidgetAndPinned »