分享到 :

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;
返回顶部