一键登录接入指南
一、概述与资源
本产品为 App 实现机主身份验证功能,包含运营商短信验证,本机号一键登录,本机号校验功能。 本机号一键登录是我们的主打推荐产品,为客户提供便捷快速登录操作,短信验证码为一键登录辅助功能。
【说明】: 风控评估能力仅在 V2.3.2 新版本中才可使用。如需使用需开通申请需求。其中风控详细说明见 SDK 中的风控说明文档。
您需要在APP中集成SDK,并在服务端完成API对接。全流程主要分为四个步骤:
· JniLibs : libCtaApiLib.so(含:arm64-v8a,armeabi,armeabi-v7a,x86,x86_64);
· res-umc : sdk所需资源文件及activity布局文件(anim, drawable, drawable-xxhdpi, layout, values文件);
· layout:新增activity_oauth.xml、activity_oauth_ctc.xml,不可缺,v2.3.0新增;注意AndroidX与support包的区别
· assets: uniaccount_classez.jar与 联通认证classes资源包,不可缺,v2.2.0新增;
· assets:新增cucc/host_cucc.properties,增加联通通道,不可缺,v2.3.0新增;
. 将 *.jar 拷贝到工程的libs目录下,如没有该目录,可新建。
. 将sdk所需要的资源文件(anim, drawable, drawable-xxhdpi, layout, values文件)从demo工程 res-umc 目录下的文件添加到项目工程中。
. 将uniaccount_classez.jar包 和cucc/host_cucc.properties添加到 assets 目录下,如没有该目录,可在main目录下新建。
. build.gradle文件下新增对应的配置,配置如下:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
. AndroidManifest.xml 文件中添加对应的权限
. 配置Android 9.0对Http的支持 : 目前移动取号部分接口暂未支持https,需要配置http协议支持。
|
方式二 : 在资源文件新建xml目录,新建文件 network_security_config.xml, 在清单文件中配置
|
|
|
|
|
|
|
|
|
|
|
android:networkSecurityConfig="@xml/network_security_config" |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
注意:使用微信开源混淆工具的小伙伴,需要在build.gradle文件下额外配置相关的资源过滤规则(白名单),否则会导致UI空白、闪退等问题。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
三、一键登录
初始化SDK, 注意:请勿多次调用 ,V2.3.2版本可使用Application 进行初始化;建议使用Activity进行初始化
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
public static int init(Context context, OxRequestParam param, OxNotifier pNotifier) { |
|
|
|
|
|
|
|
|
|
|
|
|
* TODO 默认5000 ms.单个请求也可在oxRequestParam 中设置'OxRequestParam.setTimeout(int)' |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
return OxClientEntry.init(pInitContext, pInitParam, new MyNotifier()); |
|
|
|
|
|
|
|
|
|
使用预取号后,可快速拉起授权页,需要开发者在 SDK 初始化完成 后 中的预取号操作 , 如果不做 预取号操作 ,直接调用获取 登录 accessToken,会影响每次拉起授权页 的 等待时间。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
成功是返回access_token,用于从平台服务器获取手机号信息。获取用户信息API请查看服务端API文档。有效期为2分钟, |
||||
|
|
|
|
|
|
|
|
|
|
|