authorize
提前向用户发起指定 scope 的授权;scope.healthData 仅用于选择 iOS HealthKit 系统授权路径。
扫码预览
使用限制
WARNING
Android、iOS:传入 scope.payment 时被判为非法 scope 并直接失败;依赖 scope.payment 发起授权的调用无法成功。
支持版本
前端库版本不低于 0.0.18。
支持平台
支持场景
接入准备
权限要求
授权行为
- Android:非健康 scope 会发起应用插件及相应系统授权;当前不支持 scope.healthData。
- iOS:非健康 scope 会发起应用插件及相应系统授权;scope.healthData 仅可能展示 HealthKit 系统授权框。
前置条件
- Android:非健康 scope 需要在应用权限声明中配置;当前不支持 scope.healthData
- iOS:非健康 scope 需要在应用权限声明中配置;scope.healthData 不需要 manifest 声明
使用说明
- Android:非健康 scope 的授权状态可通过
getSetting查询;当前不支持 scope.healthData。 - iOS:非健康 scope 的授权状态可通过
getSetting查询;scope.healthData 的逐类型系统状态通过getAppAuthorizeSetting查询。 - iOS:HealthKit 授权成功表示系统授权流程已完成;Apple 不向应用公开每个读取类型是否被用户拒绝。
调用方式
异步 API
入参
调用示例
成功返回
无返回字段。
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- iOS:网络类失败会细分为 301/302/303/305,并可能返回 112;Android 的网络类失败统一返回 305。