账号及用户 SDK
更新时间:2018-09-10 14:42:59
概述
账号和用户 SDK,提供账号能力,包括注册,登录,登出,获取账号,会话管理,人机校验等功能。同时提供 UI 定制的能力。
在初始化账号和用户SDK之前,必须要先初始化API通道SDK,请参见 API 通道 - 初始化。
依赖SDK | 概述 |
---|---|
API 通道 | 提供API通道能力 |
初始化
SDK 运行前,需要首先初始化SDK,常见初始化代码片段如下:
//如果com.aliyun.iot.aep.sdk:account 为0.0.2以及以上,请使用如下代码完成初始化
OALoginAdapter adapter = new OALoginAdapter(application);
//如果需要切换到海外环境,请执行下面setDefaultOAHost方法,默认为大陆环境
//adapter.setDefaultOAHost("sgp-sdk.openaccount.aliyun.com");
adapter.init("online","114d");
LoginBusiness.init(application, loginAdapter, "online");
//如果com.aliyun.iot.aep.sdk:account 为0.0.2以下,请使用如下代码完成初始化
OALoginAdapter adapter = new OALoginAdapter(application);
LoginBusiness.init(application,adatper,true,"online");
如果要使用原生的OpenAccountSDK 提供的接口,请参见 API Doc
使用方式
如果自定义实现ILoginAdapter时,请务必注意登录状态状态变化通知的方式(无论使用内置账号体系,还是三方自有账号体系),因为其他基础SDK会根据登录状态的变更做特殊业务逻辑处理。
关于如何将登录状态变更的消息通知出去,可以参考OALoginAdapter.OALoginCallback中,对mLoginStatusChangeListenerList的处理过程。
登录
LoginBusiness.login(new ILoginCallback() {
@Override
public void onLoginSuccess() {
Log.i(TAG,"登录成功");
}
@Override
public void onLoginFailed(int code, String error) {
Log.i(TAG,"登录失败");
}
});
退出登陆
LoginBusiness.logout(new ILogoutCallback() {
@Override
public void onLogoutSuccess() {
Log.i(TAG,"登出成功");
}
@Override
public void onLogoutFailed(int code, String error) {
Log.i(TAG,"登出失败");
}
});
刷新会话
LoginBusiness.refreshSession(true, new IRefreshSessionCallback() {
@Override
public void onRefreshSuccess() {
Log.i(TAG,"刷新Session成功");
}
@Override
public void onRefreshFailed() {
Log.i(TAG,"刷新Session失败");
}
});
获取会话ID
LoginBusiness.getSessionId();
获取用户信息
LoginBusiness.getUserInfo();
三方自有账号接入
注意在对接三方自有账号时,必须首先完成SDK的初始化。
强烈建议,在对接三方自有账号之前,请先确认默认的账号页面(内置账号体系)可以正常注册,登录。
可以选择自由账号通过OAuth2.0协议接入,前提需要做好配置,流程参考 账号及用户服务配置
//authCode 是三方登录成功之后,返回的三方code
OpenAccountService service = OpenAccountSDK.getService(OpenAccountService.class);
service.authCodeLogin(OALoginActivity.this, authCode, new LoginCallback() {
@Override
public void onSuccess(OpenAccountSession openAccountSession) {
Toast.makeText(getApplicationContext(), "auth 授权登录 成功 ", Toast.LENGTH_SHORT).show();
}
@Override
public void onFailure(int code, String msg) {
Toast.makeText(getApplicationContext(), "auth授权登录 失败 code = " + code + " message = " + msg, Toast.LENGTH_SHORT).show();
}
});
自定义UI
请参考 UI界面自定义 一文
混淆配置
-keep class com.alibaba.sdk.android.*
登录常见问题:
问题1 : 执行登录或者注册时,提示“亲,您的手机网络不太顺畅哦~”
排查步骤:
确认手机时间是否设置正确,如果有偏差,会被安全监测拦截导致无法登录
确认安全图片是否在src/drawable目录下,如果在在初始化代码中设置了图片后缀为“114d”,请务必保证安全图片的名称为yw_1222_114d;
//设置图片后缀 ConfigManager.getInstance().setSecGuardImagePostfix("114d");
确认初始化中是否有抛出异常
- 其中ErrorCode=110的异常码可以忽略
- 以下几种Warn可以忽略(用来检查社交账号SDK)
W/oa_Oauth: [] : Umeng is not available, Umeng Oauth Service Provider is disabled W/oa_Oauth: [] : Taobao MemberSDK is not available, Taobao 3rd Oauth Service Provider is disabled W/oa_Oauth: [] : Taobao login4android SDK is not available, Taobao 2nd Oauth Service Provider is disabled W/oa_Oauth: [] : Alipay sdk is not available, Alipay Oauth Service Provider is disabled
如果是用Demo中提供的OALoginAdapter,下面异常日志可以忽略
java.lang.NullPointerException: Attempt to invoke virtual method 'long java.lang.Long.longValue()' on a null object reference at com.aliyun.iot.aep.sdk.login.oa.OALoginAdapter.a(OALoginAdapter.java:343)
问题2 : 无法打开登录页面
排查步骤:
- 确认日志中是否有以下异常输出
init failed code = 10010 message = 发生错误,消息为 null, 请使用 LogCat 查看更多细节 或者 Failed resolution of: Lcom/ut/mini/UTHitBuilders@UTCustomHitBuilder
说明主工程缺少UT SDK的依赖,请在主工程里增加如下两个依赖,或者在平台上重新下载SDK依赖文件:
compile 'com.aliyun.ams:alicloud-android-utdid:1.1.5.4' compile 'com.aliyun.ams:alicloud-android-ut:5.1.0'