6.1 基础API
6.1.5 定时器API
小程序有两种定时器
第一种是周期定时器。使用setInterval可以周期定时器,让小程序按照指定的时间周期不断地调用回调函数。使用clearInterval方法可以取消setInterval方法设置的定时器。使用方法如下:
// 设置一个周期定时器,每隔1500毫秒调用一次回调函数
const intervalID = setInterval(() => {
// do something
}, 1500)
// 取消由setInterval设置的定时器,取消时需要传入定时器ID
clearInterval(intervalID)
第二种是延时定时器。使用setTimeout方法设置,让小程序等待一段时间后再调用回调函数(只调用一次)。使用clearTimeout方法可以取消。使用方法如下:
// 设置一个延时定时器,等待3秒后调用一次回调函数 function
const timeoutID = setTimeout(() => {
// do something
}, 3000)
// 取消由setTimeout设置的定时器,取消时需要传入定时器ID
clearTimeout(timeoutID)
6.1.6 授权API
小程序部分接口需要用户授权同意才能调用。有些接口功能相近,这些接口按使用范围分成了多个scope,用户对scope进行授权。当授权给一个scope后,该scope对应的所有接口都可以直接使用。
当调用需要授权的API,如果用户已授权过,可以直接调用接口;如果未授权过,会弹窗询问用户,用户单击同意后方可调用接口;如果用户已拒绝授权,则不会出现弹窗,而是直接进入接口的fail回调。开发者需要兼容用户拒绝授权的场景。
使用wx.getSetting接口可获取该用户当前的授权情况,返回值会出现小程序已经向用户请求过的权限。
使用wx.openSetting接口可调起客户端小程序的设置界面,让用户重新设置权限授权,设置界面中只会出现小程序已经向用户请求过的权限。
这两个接口的示例代码如下:
wx.getSetting({
success(res) {
// 返回当前授权设置的状况
console.log(res.authSetting)
/** res.authSetting = {
* "scope.userInfo": true,
* "scope.userLocation": true
* }
* */
}
})
wx.openSetting({
success(res) {
// 返回的是用户设置的操作结果
console.log(res.authSetting)
}
})
开发者也可以使用wx.authorize接口,在调用需授权API之前提前向用户发起授权请求。调用该接口后会立刻弹窗,询问用户是否同意授权小程序使用某功能或获取用户的某数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。示例代码如下:
// 可以通过wx.getSetting先查询一下用户是否授权了"scope.record"这个scope
wx.getSetting({
success(res) {
if (!res.authSetting['scope.record']) {
wx.authorize({
scope: 'scope.record',
success() {
// 用户已经同意小程序使用录音功能,后续调用wx.startRecord接口不会弹窗询问
wx.startRecord()
}
})
}
console.log(res.authSetting)
}
})
网友评论