添加到桌面|侧边栏

qh.isOnDesktopSync

解释: 获取小程序是否被添加到桌面。从1.9.3开始支持。

返回值说明

参数类型说明
isOnDesktopnumber1已添加,0未添加

示例

  1. Page({
  2. methods: {
  3. isOnDesktopSync() {
  4. const result = qh.isOnDesktopSync();
  5. console.log('isOnDesktopSync', result);
  6. }
  7. }
  8. });

qh.addAppToDesktop

解释: 添加小程序到桌面。请先调用qh.isOnDesktopSync判断是否已被添加到桌面,再调用此接口,弹出询问框,用户点击确认后添加成功。从1.9.3开始支持。

object参数说明

参数名类型必填默认值说明
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数

参数类型说明
datanumber0添加成功,1失败(点击取消按钮),2失败(Esc退出),3失败(点击关闭按钮)

fail返回参数:Object Object

参数名类型描述
errCodeInteger错误类型
errMsgString错误原因

complete返回参数:Number Number || Object Object

当调用成功时候,返回Number,返回Object时候的结构为:

参数名类型描述
errCodeInteger错误类型
errMsgString错误原因

示例

  1. Page({
  2. methods: {
  3. addAppToDesktop(e) {
  4. if (!qh.isOnDesktopSync()) {
  5. qh.addAppToDesktop({
  6. success: data => {
  7. if (data === 0) {
  8. console.log("success")
  9. }
  10. },
  11. fail: err => {
  12. console.log(err);
  13. },
  14. complete: res => {
  15. console.log(res)
  16. }
  17. });
  18. }
  19. }
  20. }
  21. });

qh.isOnSidebarSync

解释: 获取小程序是否被添加到侧边栏。从1.9.3开始支持。

返回值说明

参数类型说明
isOnSidebarnumber1已添加,0未添加

示例

  1. Page({
  2. methods: {
  3. isOnSidebarSync() {
  4. const result = qh.isOnSidebarSync();
  5. console.log('isOnSidebarSync', result);
  6. }
  7. }
  8. });

qh.addAppToSidebar

解释: 添加小程序到侧边栏。请先调用qh.isOnSidebarSync判断是否已被添加到侧边栏,再调用此接口,弹出询问框,用户点击确认后添加成功。从1.9.3开始支持。

object参数说明

参数名类型必填默认值说明
successFunction-接口调用成功的回调函数
failFunction-接口调用失败的回调函数
completeFunction-接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数

参数类型说明
datanumber0添加成功,1失败(点击取消按钮),2失败(Esc退出),3失败(点击关闭按钮)

fail返回参数:Object Object

参数名类型描述
errCodeInteger错误类型
errMsgString错误原因

complete返回参数:Number Number || Object Object

当调用成功时候,返回Number,返回Object时候的结构为:

参数名类型描述
errCodeInteger错误类型
errMsgString错误原因

示例

  1. Page({
  2. methods: {
  3. addAppToSidebar(e) {
  4. if(!qh.isOnSidebarSync()) {
  5. qh.addAppToSidebar({
  6. success: data => {
  7. if (data === 0) {
  8. console.log("success")
  9. }
  10. },
  11. fail: err => {
  12. console.log(err);
  13. },
  14. complete: res => {
  15. console.log(res)
  16. }
  17. });
  18. }
  19. }
  20. }
  21. });