WeChat アプレットの権限インターフェイスを要約して整理する-ミニプログラム開発-php.cn

この記事では、WeChat ミニプログラムに関する関連問題を紹介します。主に、ユーザー認証インターフェイスやユーザー権限設定の取得など、WeChat ミニプログラムの権限インターフェイスの関連コンテンツを紹介します。インターフェイス、ユーザーを開く権限設定インターフェースなど、一緒に見ていきましょう。

WeChat アプレットの権限インターフェイスを要約して整理する

【関連学習推奨事項: 小プログラム学習チュートリアル】

1. 権限インターフェイス

一部のインターフェイスは必須ユーザーの承認後にのみ呼び出すことができます。これらのインターフェイスは、使用範囲に応じて複数のスコープに分割されます。ユーザーはスコープを承認することを選択します。スコープを承認した後は、それに対応するすべてのインターフェイスを直接使用できます。そのようなインターフェイスが呼び出されるとき:

ユーザーが承認されている場合、インターフェイスを直接呼び出すことができます。
ユーザーが認証を拒否した場合、ポップアップウィンドウは表示されず、インターフェイス失敗コールバックに直接入ります。

■このタイプのインターフェースの権限のオブジェクトスコープフィールドとインターフェースの対応関係は次の表のとおりです。

#スコープスコープ.userLocation#scope.userLocationBackgroundscope.recordscope.camerascope.bluetoothscope.writePhotosAlbum#scope.addPhoneContactwx.wx.addPhoneContact連絡先に追加wx.addPhoneRepeatCalendar、wx.addPhoneCalendarwx.getWeRunDatawx.chooseAddresswx.chooseInvoiceTitlewx.chooseInvoicewx.getUserInfo

対応するインターフェイス説明

wx.getLocation, wx.chooseLocation, wx.startLocationUpdate Geolocation

wx.startLocationUpdateBackground バックグラウンドの場所

wx.startRecord、wx.joinVoIPChat、RecorderManager.start Microphone

カメラコンポーネント、wx.createVKSession Camera

wx.openBluetoothAdapter、wx.createBLEPeripheralServer Bluetooth

wx.saveImageToPhotosAlbum、wx.saveVideoToPhotosAlbum Addアルバムへ

#scope .addPhoneCalendar

カレンダーに追加 scope.werun

WeChat の演習手順 scope.address

対応アドレス (承認はキャンセルされました。直接電話をかけることができます)対応するインターフェース) scope.invoiceTitle

Invoice ヘッダー (承認はキャンセルされました。対応するインターフェースを直接呼び出すことができます) scope.invoice

請求書を取得します (承認はキャンセルされました。対応するインターフェイスを直接呼び出すことができます) scope.userInfo

ユーザー情報 (ミニプログラムは再利用されました。アバターのニックネームを入力してください。ミニゲームは続行できます)呼ばれます)

ミニプログラムは、インターフェイスのアクセス許可に対して対応する操作を実行するための 3 つのインターフェイスセットを提供します: wx.getSetting()ユーザーの現在の承認ステータスを取得します; wx.openSetting()Open設定インターフェイス認証を有効にするようにユーザーをガイドします; wx.authorize()認証ステータスを変更します。

1.1 ユーザー認可インターフェース`wx.authorize(Object object)`

ユーザーに対して事前に認可リクエストを開始します。このインターフェイスを呼び出した後、ポップアップウィンドウがすぐにユーザーに、アプレットによる特定の機能の使用またはユーザーデータの一部の取得を許可するかどうかを尋ねますが、対応するインターフェイスは実際には呼び出されません。ユーザーが以前に承認に同意していた場合、ポップアップウィンドウは表示されず、成功が直接返されます。プロパティを次の表に示します。

#属性タイプデフォルト値必須説明scope#string は、が取得する必要があるスコープです。詳細についてはスコープリストを参照してください#successfunctionNoインターフェイス呼び出しは成功しましたコールバック関数failfunction#complete# 公式 Web サイトのサンプルコード:




	##No	コールバックインターフェースの呼び出しに失敗した関数
function	No	インターフェイス呼び出しを終了するコールバック関数 (call 成功、失敗の両方が実行されます)

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

ログイン後にコピー

1.2 Get user権限設定インターフェース

wx.getSetting(Object object)

このインターフェースは、ユーザーの現在の設定を取得します。アプレットがユーザーに要求した権限のみが戻り値に表示されます。属性は次のとおりです。

#AttributeTypeDefault valueRequired説明最小バージョン##withSubscriptionsブール値##2.10.1#関数#インターフェイス呼び出しが成功した場合のコールバック関数 failfunction No失敗したインターフェイス呼び出しに対するコールバック関数インターフェイス呼び出し終了時のコールバック関数 (呼び出しが成功または失敗した場合に実行されます)AttributeDescription


false	No	ユーザーの購読メッセージの購読ステータスを同時に取得するかどうかですが、デフォルトでは取得されません。注: withSubscriptions は、ユーザーがサブスクリプションパネルで [常に上記の選択を保持し、再度質問しない] をチェックしたサブスクリプションメッセージのみを返します。		#成功

		##complete	function		No
		object.success コールバック関数は次のとおりです:			Type

最小バージョン

subscriptionsSettingSubscriptionsSetting ユーザーサブスクリプションメッセージ設定。インターフェイスパラメーターは、値が # の場合にのみ返されます。＃＃真実＃＃＃。

官网示例代码：

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

ログイン後にコピー

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

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

authSetting	AuthSetting	ユーザー認証結果
		withSubscriptions	2.10.1
miniprogramAuthSetting	AuthSetting	プラグインで呼び出されるとき、現在のホストアプレット

属性	类型	默认值	必填	说明	最低版本
withSubscriptions	Boolean	false	否	是否同时获取用户订阅消息的订阅状态，默认不获取。注意：withSubscriptions 只返回用户勾选过订阅面板中的“总是保持以上选择，不再询问”的订阅消息。	2.10.3
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success回调函数如下:

属性	类型	说明	最低版本
authSetting	AuthSetting	用户授权结果
subscriptionsSetting	SubscriptionsSetting	用户订阅消息设置，接口参数`withSubscriptions`值为`true`时才会返回。	2.10.3

注意：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代码如下：

1	`<!--index.wxml--><view>获取地理位置</view><view>{{context}}</view><view>开始录音</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()接口会出现修改权限的操作界面。

案例效果如下：

WeChat アプレットの権限インターフェイスを要約して整理する