HarmonyOS_SDK接口说明
1.登录接口(Promise)
/**
* 授权登录
* @param reqOptions 授权相关参数
*/
login(context: UIContext, reqOptions:AuthReqOptions): Promise<AuthResult>
参数 AuthReqOptions 详细说明
字段 | 说明 | 传值 |
scope | 申请授权权限列表 | 默认值为"all" |
forceWebLogin | 是否强制使用网页登录 | 默认 false |
useQrCode | 是否使用扫码登录(仅在使用 H5 授权时生效,App 授权不支持) | 默认 false |
networkTimeout | 配置sdk内部WebView网页加载超时时长(单位ms,仅在 >0 时生效,如传入<=0 则sdk内部会使用默认值 5000ms) | 默认 5000 |
回调结果 AuthResult 说明
字段 | 说明 |
type | 授权结果,值范围为枚举AuthResultType{Success = 1,Cancel=2,Error=3} |
message | 授权结果消息 |
detail | 授权结果详细信息 |
authResponse | 授权 code 数据类,业务关注 authCode 即可 |
2.登录接口(Callback)
/**
* 授权登录
* @param reqOptions 授权相关参数
* @param apiCallback 授权登录回调监听
*/
login(context: UIContext, reqOptions:AuthReqOptions, apiCallback: ApiCallback<AuthResponse>): void
备注:
1、AuthReqOptions、AuthResponse 与 4.1接口中的一致
2、用户授权鸿蒙app登录成功后,后台会派发临时票据code(短期且仅一次有效)。
3、业务获取code后,业务需通过code+应用秘钥(只能存后台,客户端泄露风险高),在业务后台获取openid+access_token+refresh_token。具体参考:code换access_token接口
4、refresh_token有效期大于access_token,通过刷新可获取新的access_token+refresh_token,历史票据自动失效,因此,业务需要保存、刷新使用最新票据。
3.判断 QQ 是否安装
isQQInstalled(): boolean
4.注册日志类
sdk输出日志,业务可将日志记录到业务日志文件中,方便后续排查问题
/**
* 向sdk注册 日志接收类
* @param iLogger
*/
IQQOpenApi.addCustomLogger(iLogger: ILogger): void;