# 彩签

小程序支持两种添加彩签方式:

  1. 添加普通彩签(button 方式<button open-type="addColorSign">打开授权设置页</button>
  2. 添加最近浏览彩签 qq.addRecentColorSign

两者区别:

  1. 添加普通彩签不需要授权,添加最近浏览彩签需要授权;
  2. 添加普通彩签无法编辑 query 参数,添加最近浏览彩签可以编辑 query 参数(小程序页面启动参数)。
  3. 普通彩签:每个小程序可以添加一个,不同小程序之间添加普通彩签互不影响,手 Q 中可以同时出现多个普通彩签;最近浏览彩签:手 Q 中只会有一个,不同小程序或其他应用添加的最近浏览彩签会被相互覆盖,只显示最近添加的最近浏览彩签。

# qq.addRecentColorSign

调用前需要进行 用户授权:scope.recentColorSign

添加当前小程序页面到最近浏览彩签,需要授权基础库 1.20.0 开始支持。

提示:在手 Q 8.9.0 前的版本,当系统未授予手 Q 悬浮穿权限时,每次调用该接口都会弹出系统授权窗口。自手 Q 8.9.0 起交互调整如下:

  1. 系统没有授予手 Q 悬浮窗权限时,接口执行 fail 回调函数并附带 ”No floating window permission“的错误信息,开发者可针对此信息在业务代码里弹窗提示用户手动授予手 Q 悬浮窗权限。
  2. 安卓系统部分机型存在获取悬浮窗权限不准确情况。

# 参数

# Object object

属性 类型 必填 默认值 说明
query String 当前页面的查询参数 做为点击最近彩签打开的小程序页面的启动参数,如 a=1&b=2
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例代码

qq.addRecentColorSign({
  query: 'a=1&b=2',
  success(res) {
    console.log('addRecentColorSign success: ', res)
  },
  fail(err) {
    console.log('addRecentColorSign fail: ', err)
  },
  complete(res) {
    console.log('addRecentColorSign complete: ', res)
  },
})
1
2
3
4
5
6
7
8
9
10
11
12