微信小程序API 在設(shè)置界面中修改對(duì)該小程序的授權(quán)信息

2022-05-10 15:59 更新

wx.authorize(OBJECT)


基礎(chǔ)庫 1.2.0 開始支持,低版本需做兼容處理

部分接口需要獲得同意后才能調(diào)用。此類接口調(diào)用時(shí),如果用戶未授權(quán)過,會(huì)彈窗詢問用戶,用戶點(diǎn)擊同意后方可調(diào)用接口。如果用戶點(diǎn)了拒絕,則短期內(nèi)調(diào)用不會(huì)出現(xiàn)彈窗,而是直接進(jìn)入 fail 回調(diào)。用戶可以在小程序設(shè)置界面中修改對(duì)該小程序的授權(quán)信息。本接口用于提前向用戶發(fā)起授權(quán),調(diào)用后會(huì)立刻彈窗詢問用戶是否同意小程序使用某項(xiàng)功能或獲取用戶的某些數(shù)據(jù),但不會(huì)實(shí)際調(diào)用接口。如果用戶之前已經(jīng)同意,則不會(huì)出現(xiàn)彈窗,直接返回成功。

OBJECT參數(shù)說明:

參數(shù)名類型必填說明
scopeString需要獲取權(quán)限的scope,詳見 scope 列表
successFunction接口調(diào)用成功的回調(diào)函數(shù)
failFunction接口調(diào)用失敗的回調(diào)函數(shù)
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

success返回參數(shù)說明:

參數(shù)名類型說明
errMsgString調(diào)用結(jié)果

示例代碼:

// 可以通過 wx.getSetting 先查詢一下用戶是否授權(quán)了 "scope.record" 這個(gè) scope
wx.getSetting({
    success(res) {
        if (!res.authSetting['scope.record']) {
            wx.authorize({
                scope: 'scope.record',
                success() {
                    // 用戶已經(jīng)同意小程序使用錄音功能,后續(xù)調(diào)用 wx.startRecord 接口不會(huì)彈窗詢問
                    wx.startRecord()
                }
            })
        }
    }
})

scope 列表

scope對(duì)應(yīng)接口描述
scope.userInfowx.getUserInfo用戶信息
scope.userLocationwx.getLocation, wx.chooseLocation地理位置
scope.addresswx.chooseAddress通訊地址
scope.recordwx.startRecord錄音功能
scope.writePhotosAlbumwx.saveImageToPhotosAlbum, wx.saveVideoToPhotosAlbum保存到相冊(cè)
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)