• 下载
  • 社区

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({ 
        bizType:'AppletPG',
        authType:'LBS',
        success:(res)=>{
            //shown为true时表示会显示权限引导弹窗,为false时表示用户已经授权
            my.alert({content: '调用成功:'+JSON.stringify(res), });
        },
        fail:(error)=>{
            my.alert({content: '调用失败:'+JSON.stringify(error), });
        },
    });
  },
});


入参

String 类型,属性如下:

属性

类型

必填

描述

authType

String

引导的权限标识,用于标识该权限类型(如 LBS)


支持的 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