支付宝小程序API 权限引导
my.showAuthGuide
通过权限引导模块以图文等形式向用户弹出 Dialog,引导用户打开相应的权限。权限引导的核心是引导而非权限判断,调用时机应该在业务方确认所需权限被限制的时候;此外权限引导弹框受疲劳度等因素控制。
示例代码
// API-DEMO page/API/show-auth-guide/show-auth-guide.json
{
"defaultTitle": "权限引导"
}
<!-- API-DEMO page/API/show-auth-guide/show-auth-guide.axml-->
<view class="page">
<view class="page-description">权限引导 API</view>
<view class="page-section">
<view class="page-section-title">my.showAuthGuide</view>
<view class="page-section-demo">
<button type="primary" onTap="showAuthGuide">权限引导</button>
</view>
</view>
</view>
// API-DEMO page/API/show-auth-guide/show-auth-guide.js
Page({
showAuthGuide() {
my.showAuthGuide({
authType:'LBS',
success:(res)=>{
//shown为true时表示会显示权限引导弹窗,为false时表示用户已经授权
my.alert({content: '调用成功:'+JSON.stringify(res), });
},
fail:(error)=>{
my.alert({content: '调用失败:'+JSON.stringify(error), });
},
});
},
});
入参
入参为 Object 类型,属性如下:
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
authType | String | 是 | 引导的权限标识,用于标识该权限类型(如 LBS)。 |
success | Function | 否 | 调用成功的回调函数。 |
fail | Function | 否 | 调用失败的回调函数。 |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行)。 |
支持的 authType
权限名称 | 权限码 | 支持平台 |
---|---|---|
后台保活权限 | BACKGROUNDER | Android |
桌面快捷权限 | SHORTCUT | Android |
麦克风权限 | MICROPHONE | iOS |
通讯录权限 | ADDRESSBOOK | iOS |
相机权限 | CAMERA | iOS |
照片权限 | PHOTO | iOS |
push通知栏权限 | NOTIFICATION | Android |
自启动权限 | SELFSTARTING | Android |
lbs总开关 | LBSSERVICE | iOS |
lbs开关(app) | LBS | iOS |