授权

授权

介绍 : 手机号、用户信息(用户名、账号)、定位、车辆信息、车控信息等用户使用需要申请宿主授权, 手机号授权请查看。

一、权限授权

部分接口需要经过用户授权同意才能调用。将这些接口按使用范围分成多个 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 车牌颜色

此类接口调用时需注意

如果用户未接受或拒绝过此权限,会弹窗询问用户,用户点击同意后方可调用接口;示例图:

image.png

image.png

1、如果用户之前已经同意授权,则不会出现弹窗,可直接调用接口;

2、如果用户之前已经拒绝,则再次调用也不会弹窗,会执行 fail 回调。请开发者兼容用户拒绝授权的场景。

3、车辆信息(车牌号、发动机号、VIN码和车牌颜色)可以组合授权,开发者可以同时申请上述四个权限中的其中几个,用”,”分开传入。

二、获取用户授权设置

1、开发者可以使用 swan.getSetting 获取用户的当前设置。

2、用户打开设置界面方法:

可以在小程序设置“标题栏 -> 更多-> 权限管理”中控制该小程序的授权状态。

车载语音消息推送