部分接口需要经过用户授权同意才能调用。我们把这些接口按使用范围分成多个 scope
,用户选择对 scope
来进行授权,当授权给一个 scope
之后,其对应的所有接口都可以直接使用。
部分接口需要获得用户授权同意后才能调用。此类接口调用时:
开发者可以使用 qq.getSetting 获取用户当前的授权状态。
用户可以在小程序设置界面(「右上角」 - 「关于」 - 「右上角」 - 「设置」)中控制对该小程序的授权状态。
开发者可以调用 qq.openSetting 打开设置界面,引导用户开启授权。
开发者可以使用 qq.authorize 在调用需授权 API 之前,提前向用户发起授权请求。
scope | 对应接口 | 描述 |
---|---|---|
scope.userInfo | qq.getUserInfo | 用户信息 |
scope.userLocation | qq.getLocation | 地理位置 |
scope.qqrun | qq.getQQRunData | QQ运动步数 |
scope.writePhotosAlbum | qq.saveImageToPhotosAlbum | 保存到相册 |
setting.appMsgSubscribed | qq.subscribeAppMsg | 订阅消息(833以下版本使用scope.appMsgSubscribed,833及以上版本使用setting.appMsgSubscribed) |
setting.addFriend | 主动调用 qq.authorize 接口进行授权 | 允许被添加好友 |
scope.recentColorSign | 主动调用 qq.authorize 接口进行授权 | 允许 添加最近浏览彩签 |
qq.authorize({scope: "scope.userInfo"})
,不会弹出授权窗口,请使用 qq.createUserInfoButtonscope.userLocation
时必须配置地理位置用途说明。