微信小程序权限接口

微信小程序权限接口

• ​​1、权限接口​​

• ​​1.1 用户授权接口`wx.authorize(Object object)`​​
• ​​1.2 获取用户权限设置接口`wx.getSetting(Object object)`​​
• ​​1.3 打开用户权限设置接口`wx.openSetting(Object object)`​​

• ​​2、授权案例​​

1、权限接口

  部分接口需要经过用户授权统一才能调用。我们把这些接口按使用范围分成多个scope，用户选择对scope进行授权，当授权给一个scope之后，其对应的所有接口都可以直接使用，此类接口调用时：

• 如果用户未接受或拒绝此权限，会弹窗询问用户，用户单击统一后方可调用接口。
• 如果用户已授权，可以直接调用接口。
• 如果用户已拒绝授权，则不会出现弹窗，而会直接进入接口fail回调。

  此类接口再权限中的对象scope的字段和接口的对应关系如下表所示。

  小程序提供了三组接口对接口权限进行相应的操作：​​wx.getSetting()​​​获取用户当前的授权状态；​​wx.openSetting()​​​打开设置界面以引导用户开启授权；​​wx.authorize()​​改变授权状态。

1.1 用户授权接口wx.authorize(Object object)

  提前向用户发起授权请求。该接口调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据，但不会实际调用对应接口。如果用户之前已经同意授权，则不会出现弹窗，直接返回成功。属性如下表所示。

  官网的示例代码：

// 可以通过 wx.getSetting 先查询一下用户是否授权了 "scope.record" 这个 scope
wx.getSetting({
  success(res) {
    if (!res.authSetting['scope.record']) {
      wx.authorize({
        scope: 'scope.record',
        success () {
          // 用户已经同意小程序使用录音功能，后续调用 wx.startRecord 接口不会弹窗询问
          wx.startRecord()
        }
      })
    }
  }
})

1.2 获取用户权限设置接口wx.getSetting(Object object)

  该接口获取用户的当前设置。返回值中只会出现小程序已经向用户请求过的权限。属性如下：

object.success回调函数如下：

  官网示例代码：

wx.getSetting({
  success (res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

1.3 打开用户权限设置接口wx.openSetting(Object object)

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

object.success回调函数如下:

• 注意：​​2.3.0​​ 版本开始，用户发生点击行为后，才可以跳转打开设置页，管理授权信息。

  官网示例代码：

wx.openSetting({
  success (res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

2、授权案例

  本例使用获取地理位置接口​​wx.getLocation()​​​和开始录音接口​​wx.startRecord()​​进行相关操作，而这两个接口都需要设置操作权限。

Setting.wxml代码如下：

<!--index.wxml-->
<view class="body" bindtap="location1">
获取地理位置
</view>
<view  class="body">{{context}}</view>



<view class="body" bindtap="location2">
开始录音
</view>

Setting.js代码如下：

//index.js
//获取应用实例
const app = getApp()

Page({
  data: {
   
  },
  
  onLoad: function () {
    context:''
  },
  location1:function(){ //获取地理位置
    var that=this
    wx.getSetting({ //获取用户权限设置接口
      success(res) {
        console.log(res)
        if (!res.authSetting['scope.userLocation']) {
          wx.authorize({    //授权
            scope: 'scope.userLocation',  //地理位置权限，看线上面的scope对应的参数
            success() {
              wx.getLocation({    //获取当前的地理位置
                success: function(res) {
                 console.log(res)
                  that.setData({ context: "你所在的经度是" + res.latitude+"你所在的纬度是"+res.longitude})
                },
              })
            }
          })
        }
      }
    })
  },
 
  location2: function () {      //录音
    var that = this
  
        wx.getSetting({
          success(res) {
            console.log(res.authSetting)
            if (!res.authSetting['scope.record']) {
              wx.openSetting({    //打开用户权限设置界面
                success(res) {
                  console.log(res)
                  wx.startRecord({    //开始录音
                    success(res) {
                      const tempFilePath = res.tempFilePath
                      console.log("录音结束")
                    }
              })
            } 
        })
        }}
        })
  }
})

location()1函数实现获取地理位置的功能，该函数先调用​​wx.getSetting()​​​接口获取权限状态，然后调用​​wx.authorize()​​​接口修改地理位置权限​​scope.userLocation​​​。location2()函数实现录音功能，该函数先调用​​wx.getSetting()​​​接口获取权限状态，然后调用​​wx.openSetting()​​​接口打开录音权限设置界面来修改录音权限。从本例可以看出设置权限的时候应该先调用​​wx.getSetting()​​​接口来修改权限状态，在没有权限打开的情况下可以调用​​wx.authorize()​​​接口或者​​wx.openSetting()​​​接口来修改权限状态，​​wx.authorize()​​​接口不出现修改权限的操作权限，而​​wx.openSetting()​​接口会出现修改权限的操作界面。

  案例效果如下：

  点击获取地理位置：

  点击允许之后会显示当前所在的经纬度。

  点击开始录音按钮出现麦克风授权：

演示完毕，谢谢大家阅读。