# 权限
为保障小游戏用户隐私安全,平台部分接口需要经过用户授权同意才能向开发者返回相关数据。平台把这些接口按使用范围分成多个 scope ,开发者选择对需要的 scope 进行授权,当一个 scope 成功经过用户授权后,其对应的所有接口都可以直接使用。
使用授权受限接口时:
- 如果用户未接受或拒绝过此权限,会弹窗请求用户授权。
- 如果用户已授权,可以直接调用接口。
- 如果用户已拒绝授权,则不会出现弹窗,而是直接回调 fail。开发者需要处理用户拒绝授权的场景。
# 获取用户授权设置
开发者可以使用 ks.getSetting 获取用户当前的授权状态。
# 打开设置界面
用户可以在小游戏设置界面(「右上角」 - 「关于」 - 「右上角」 - 「设置」)中控制对该小游戏的授权状态。
# 提前发起授权请求
开发者可以使用 ks.authorize 在调用需授权 API 之前,提前向用户发起授权请求。
# scope 列表
scope | 对应接口 | 描述 |
---|---|---|
scope.userInfo | ks.getUserInfo | 用户信息 |
scope.writePhotosAlbum | ks.saveImageToPhotosAlbum | 保存到系统相册 |
# 最佳实践
在真正需要使用授权受限数据时时,才向用户发起授权申请。处理用户拒绝授权场景,不阻塞游戏主流程。