授权
更新时间:2021-09-26
授权
介绍 : 手机号、用户信息(用户名、账号)、定位、车辆信息、车控信息等用户使用需要申请宿主授权, 手机号授权请查看。
一、权限授权
部分接口需要经过用户授权同意才能调用。将这些接口按使用范围分成多个 scope,用户选择 scope 来进行授权,当授权给一个 scope 之后,其对应的所有接口都可以直接使用。
scope列表
scope | 对应接口 | 描述 |
---|---|---|
scope.userInfo | swan.getUserInfo | 用户信息 |
scope.userLocation | swan.getLocation swan.chooseLocation |
地理位置 |
scope.address | swan.chooseAddress | 收货地址 |
scope.plateNumber | swan.iovauto.getCarInfoDetails | 车牌号 |
scope.engine | swan.iovauto.getCarInfoDetails | 发动机号 |
scope.vin | swan.iovauto.getCarInfoDetails | VIN码 |
scope.plateColour | swan.iovauto.getCarInfoDetails | 车牌颜色 |
此类接口调用时需注意
如果用户未接受或拒绝过此权限,会弹窗询问用户,用户点击同意后方可调用接口;示例图:
1、如果用户之前已经同意授权,则不会出现弹窗,可直接调用接口;
2、如果用户之前已经拒绝,则再次调用也不会弹窗,会执行 fail 回调。请开发者兼容用户拒绝授权的场景。
3、车辆信息(车牌号、发动机号、VIN码和车牌颜色)可以组合授权,开发者可以同时申请上述四个权限中的其中几个,用”,”分开传入。
二、获取用户授权设置
1、开发者可以使用 swan.getSetting 获取用户的当前设置。
2、用户打开设置界面方法:
可以在小程序设置“标题栏 -> 更多-> 权限管理”中控制该小程序的授权状态。