擷取使用者對當前小程式的授權狀態,並與wv.authorize介面搭配使用。
入參
Object類型,參數如下:
參數 | 類型 | 必填 | 描述 |
success | Function | 否 | 查詢成功的回呼函數。 |
fail | Function | 否 | 查詢失敗的回呼函數。 |
出參
success回呼函數會收到一個Object類型的對象,其中key為scope值,value為Boolean值,表示使用者是否允許授權,其屬性如下:
屬性 | 類型 | 描述 |
authSetting | Object | 使用者授權結果,其中key為scope值,value為Boolean值,表示使用者是否允許授權。 |
authSetting屬性描述如下:
屬性 | 類型 | 描述 |
location | Boolean | 地理位置:未授權返回false,對應介面: WVLocation.getLocation;WVLocation.searchLocation |
camera | Boolean | 網路攝影機:未授權返回false,對應介面:WVScan.scan |
bluetooth | Boolean | 藍芽:未授權返回false,對應介面:WVBluetooth涉及所有方法 |
album | Boolean | 相簿:未授權返回false,對應介面:WVVideo.chooseVideo;WVCamera.takePhoto |
contacts | Boolean | 通訊錄:未授權返回false,對應介面:WVContacts涉及所有方法 |
microphone | Boolean | 麥克風:未授權返回false,對應介面:WVMotion.listenBlow;WVMotion.stopListenBlow |
file | Boolean | 檔案:未授權返回false,對應介面:WVFile涉及所有方法 WVVideo.saveVideoToPhotosAlbum;WVImage.saveImage |
call | Boolean | 打電話:未授權返回false,對應介面:WVCall.dial;WVCall.call |
vibrate | Boolean | 震動:未授權返回false,對應介面:WVMotion.vibrate |
screen | Boolean | 截屏:未授權返回false,對應介面:WVScreenCapture.capture |
fail回呼函數會收到一個Object類型的對象,msg為錯誤資訊:
錯誤資訊 | 錯誤說明 | 解決方案 |
You need to configure the authorization switch to apply for authorization | 需要開啟授權開關 | 檢查容器初始化是否配置授權開關。 |
User not bound | 容器註冊使用者資訊UserId未註冊 | 檢查容器註冊使用者資訊,userId是否傳入。 |
範例程式碼
window.WindVane.call('wv', 'getSetting', {}, function(res) {
const { camera = false, location = false } = res.authSetting;
}, function(e) {
alert('failure:' + JSON.stringify(e));
});