qq.openSetting

qq.openSetting(Object object)

调起客户端小程序设置界面，返回用户设置的操作结果。设置界面只会出现小程序已经向用户请求过的权限。

参数

Object object
属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）
object.success 回调函数

参数

Object res

属性类型说明
authSettingAuthSetting用户授权结果

示例代码

  1. qq.openSetting({
  2.   success(res) {
  3.     console.log(res.authSetting)
  4.     // res.authSetting = {
  5.     //   "scope.userInfo": true,
  6.     //   "scope.userLocation": true
  7.     // }
  8.   }
  9. })

qq.getSetting

qq.getSetting(Object object)

获取用户的当前设置。返回值中只会出现小程序已经向用户请求过的权限。

参数

Object object
属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）
object.success 回调函数

参数

Object res

属性类型说明
authSettingAuthSetting用户授权结果

示例代码

  1. qq.getSetting({
  2.   success(res) {
  3.     console.log(res.authSetting)
  4.     // res.authSetting = {
  5.     //   "scope.userInfo": true,
  6.     //   "scope.userLocation": true
  7.     // }
  8.   }
  9. })

qq.createOpenSettingButton

OpenSettingButton qq.createOpenSettingButton(Object object)

创建打开设置页面的按钮

参数

Object object
属性类型默认值必填说明
typestring是按钮的类型
textstring否按钮上的文本，仅当 type 为 text 时有效
imagestring否按钮的背景图片，仅当 type 为 image 时有效
styleObject是按钮的样式

type 的合法值

值说明
text可以设置背景色和文本的按钮
image只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高

style 的结构

属性类型默认值必填说明
leftnumber是左上角横坐标
topnumber是左上角纵坐标
widthnumber是宽度
heightnumber是高度
backgroundColorstring是背景颜色。格式为 6位/8位 16进制数。
borderColorstring是边框颜色。格式为 6位/8位 16进制数。
borderWidthnumber是边框宽度
borderRadiusnumber是边框圆角
colorstring是文本的颜色。格式为 6位 16进制数。
textAlignstring是文本的水平居中方式
fontSizenumber是字号
lineHeightnumber是文本的行高

style.textAlign 的合法值

值说明
left居左
center居中
right居右

返回值

OpenSettingButton

示例代码

  1. const button = qq.createOpenSettingButton({
  2.   type: 'text',
  3.   text: '打开设置页面',
  4.   style: {
  5.     left: 10,
  6.     top: 76,
  7.     width: 200,
  8.     height: 40,
  9.     lineHeight: 40,
  10.     backgroundColor: '#ff0000',
  11.     color: '#ffffff',
  12.     textAlign: 'center',
  13.     fontSize: 16,
  14.     borderRadius: 4
  15.   }
  16. })

AuthSetting

用户授权设置信息，详情参考权限

属性

boolean scope.userInfo

是否授权用户信息，对应接口 qq.getUserInfo

boolean scope.userLocation

是否授权地理位置，对应接口 qq.getLocation

boolean scope.werun

是否授权QQ运动步数，对应接口 qq.getWeRunData

boolean scope.writePhotosAlbum

是否授权保存到相册 qq.saveImageToPhotosAlbum

OpenSettingButton

用户点击后打开设置页面的按钮

属性

string type

按钮的类型

type 的合法值

值说明
text可以设置背景色和文本的按钮
image只能设置背景贴图的按钮，背景贴图会直接拉伸到按钮的宽高
string text

按钮上的文本，仅当 type 为 text 时有效

string image

按钮的背景图片，仅当 type 为 image 时有效

Object style

按钮的样式

属性类型说明
leftnumber左上角横坐标
topnumber左上角纵坐标
widthnumber宽度
heightnumber高度
backgroundColorstring背景颜色。格式为 6位/8位 16进制数。
borderColorstring边框颜色。格式为 6位/8位 16进制数。
borderWidthnumber边框宽度
borderRadiusnumber边框圆角
colorstring文本的颜色。格式为 6位 16进制数。
textAlignstring文本的水平居中方式
fontSizenumber字号
lineHeightnumber文本的行高

style.textAlign 的合法值

值说明
left居左
center居中
right居右

方法

OpenSettingButton.show()

显示打开设置页面按钮

OpenSettingButton.hide()

隐藏打开设置页面按钮。

OpenSettingButton.destroy()

销毁打开设置页面按钮

OpenSettingButton.onTap(function callback)

监听设置页面按钮的点击事件

OpenSettingButton.offTap(function callback)

取消监听设置页面按钮的点击事件

.destroy

OpenSettingButton.destroy()

销毁打开设置页面按钮

.hide

OpenSettingButton.hide()

隐藏打开设置页面按钮。

.offTap

OpenSettingButton.offTap(function callback)

取消监听设置页面按钮的点击事件

参数

function callback

设置页面按钮的点击事件的回调函数

.onTap

OpenSettingButton.onTap(function callback)

监听设置页面按钮的点击事件

参数

function callback

设置页面按钮的点击事件的回调函数

.show

OpenSettingButton.show()

显示打开设置页面按钮