向系統(tǒng)請求某個或多個權限。為幫助您更好的使用該接口，論壇維護了一個示例。

對于iOS平臺，第一次請求權限時會彈出權限選擇框，如果用戶選擇了不允許，那么再次請求權限時將不會再彈出選擇框（定位權限如果用戶選擇了下次詢問，則會再次彈出），而是直接跳轉到系統(tǒng)設置中該應用的設置界面。

對于Android平臺，只要用戶沒有選擇“不再提示”，那么再次請求權限時都將繼續(xù)彈出權限選擇框；如果用戶選擇了“不再提示”，那么再次請求權限時將不會再彈出選擇框，而是直接跳轉到系統(tǒng)設置的該應用權限設置界面。

requestPermission({params}, callback(ret,err))

params

list：

• 類型：字符串數(shù)組
• 默認值：無
• 描述：權限列表。
• 取值范圍：

camera               //相機/拍照/錄像
contacts             //聯(lián)系人讀取/寫入
contacts-r           //僅聯(lián)系人讀取。iOS中等同于contacts。
contacts-w           //僅聯(lián)系人寫入。iOS中等同于contacts。
microphone           //使用麥克風錄制音頻
photos               //訪問相冊|本地存儲空間。Android上等同于storage。
photos-w             //僅寫入相冊|本地存儲空間。Android上等同于storage-w。
location             //定位
locationAlways       //后臺定位，只支持iOS
locationFullAccuracy //臨時精確定位，請求時需傳入purposeKey參數(shù)，申請的臨時精確定位只在App生命周期內(nèi)有效。注意：僅當location、locationAlways權限返回的reducedAccuracy字段為true時才請求臨時精確定位，若用戶繼續(xù)選擇關閉精確定位時回調方法不會被執(zhí)行，所以此權限應和其它權限分開進行請求。只支持iOS 14及以上系統(tǒng)。
notification         //狀態(tài)欄通知
calendar             //日歷讀取/寫入。只支持Android
calendar-r           //僅日歷讀取
calendar-w           //僅日歷寫入
phone                //直接撥打電話/獲取手機號碼|IMEI。只支持Android
phone-call           //僅直接撥打電話
phone-r              //僅獲取手機號碼|IMEI
phone-r-log          //讀取通話記錄
phone-w-log          //寫入通話記錄
sensor               //傳感器.只支持Android
sms                  //讀取短信/后臺發(fā)送短信。只支持Android
sms-s                //僅后臺發(fā)送短信
sms-r                //僅讀取短信
storage              //讀取/寫入|相冊|多媒體|本地存儲空間。只支持Android
storage-r            //僅讀取|相冊|多媒體|文件|本地存儲空間
storage-w            //僅寫入|相冊|多媒體|文件|本地存儲空間

code：

• 類型：數(shù)字
• 默認值：無
• 描述：請求跟蹤碼，用于回調結果，只支持Android。

purposeKey：

• 類型：字符串
• 默認值：無
• 描述：請求locationFullAccuracy權限的意圖字段，在云編譯界面添加“精確定位（臨時）”權限時輸入purposeKey及對應的權限使用描述，系統(tǒng)通過purposeKey找到對應的權限使用描述，然后在開啟精確定位的彈框中將描述語展示給用戶。

callback

ret:

• 類型：JSON對象
• 內(nèi)部字段：

{
    list:[{
        name:              //權限名，字符串類型
        granted:           //是否允許，布爾類型
    }],
    never:                 //用戶是否選擇了“不再提示“，只支持Android，布爾類型
    code:                  //請求跟蹤碼，只支持Android，數(shù)字類型。
}

示例代碼

var permission = 'camera';
var resultList = api.hasPermission({
    list: [permission]
});
if (resultList[0].granted) {
    // 已授權，可以繼續(xù)下一步操作
    api.alert({
        msg: '已授權'
    });
} else {
    api.confirm({
        msg: '應用需要您的授權才能訪問相機',
        buttons: ['取消', '去設置']
    }, function(ret) {
        if (ret.buttonIndex == 2) {
            api.requestPermission({
                list: [permission],
            }, function(res) {
                if (res.list[0].granted) {
                    // 已授權，可以繼續(xù)下一步操作
                    api.alert({
                        msg: '已授權'
                    });
                }
            });
        }
    });
}

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.2.76及更高版本