# 授权

为保障小游戏用户隐私安全,平台部分接口需要经过用户授权同意才能向开发者返回相关数据。平台把这些接口按使用范围分成多个 scope ,开发者选择对需要的 scope 进行授权,当一个 scope 成功经过用户授权后,其对应的所有接口都可以直接使用。

使用授权接口时:

  • 如果用户未接受或拒绝过此权限,会弹窗请求用户授权。
  • 如果用户已授权,可以直接调用接口。
  • 如果用户已拒绝授权,则不会出现弹窗,而是直接回调 fail。开发者需要处理用户拒绝授权的场景。

# 获取用户授权设置

开发者可以使用 ks.getSetting 异步获取用户当前的授权设置。

# 授权申请

开发者可以使用 ks.authorize 向用户发起授权请求。

# scope 取值

scope的合法值

说明 最低版本
scope.userInfo 用户信息
scope.writePhotosAlbum 保存到相册权限

# 授权有效期

一旦用户明确同意或拒绝过授权,其授权关系会记录在后台,直到用户主动删除小游戏。

# 相关API

接口 功能说明
ks.authorize 向用户发起授权请求
ks.getSetting 异步获取当前用户的权限设置