概述
JSAPI 部分接口的使用需得到用户的授权同意。我们将这些接口按照使用范畴进行了分类,划分成多个scope
。用户可以选择对某个scope
进行授权,一旦授权成功,其对应的所有接口都可以直接使用。
在调用此类接口时,有下列几种情况:
- 如果用户尚未允许应用使用该权限,系统会弹出提示框询问用户,用户需点击同意后才能调用接口。
- 用户未作出选择时,接口会处于pending状态,此时不会有成功或失败回调。
- 如果用户点击拒绝,则会触发接口的失败回调,并返回相应错误码。
- 如果用户已授予权限,接口将直接可用。

授权弹窗
授权状态列表
用户可以在小程序的设置界面(路径为「右上角"..."图标」-「更多菜单Header」-「设置」)中管理对网页应用的授权状态。

授权弹窗状态列表
授权有效期
用户一旦明确同意或拒绝过授权,其授权关系将被记录在后台,直至用户在授权状态列表中手动关闭。
Scope 清单
Scope | 描述 |
---|---|
microphone | 麦克风 |
camera | 相机 |
location | 地理位置 |
album | 相册 |
access-storage | 本地文件 |
注意事项
在使用授权接口时,请务必遵守WPS协作的平台规则和用户隐私政策,合理并安全地使用用户数据。