# 彩签

小游戏支持两种添加彩签方式:

  1. 添加彩签:qq.addColorSign
  2. 添加当前小游戏到最近浏览彩签 qq.addRecentColorSign

两者区别:

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

# qq.addColorSign

添加彩签,基础库 1.10.0 开始支持。

# 参数

# Object object

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

# 示例代码

qq.addColorSign()
1

# qq.isColorSignExistSync

判断是否已在彩签内,基础库 1.16.0 开始支持。只支持 qq.addColorSign 添加的彩签,不支持 qq.addRecentColorSign 添加的最近浏览彩签

# 返回值

# boolean

表示当前小游戏是否已在彩签内

# 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