易验APP一键登录对接文档

易验APP一键登录对接文档

1. 能力申请

注意事项：

1.认证取号服务必须打开蜂窝数据流量，并且应用应有蜂窝数据权限；

2.取号请求过程需要消耗用户少量数据流量（国外漫游时可能会产生额外的费用）；

3.使用WiFi网络不会影响一键登录功能。

1.1 接入流程

1. 申请appid和appkey

根据《开发者接入流程文档》，联系易讯云商务人员按照文档要求创建开发者账号并申请appid和appkey，并提交应用名称、简介、类型、应用图标（256X256）、公钥1024bit pkcs#8格式）、调用“一键免密登录”能力 IP地址；安卓应用另提交登录页面类名、应用包名、应用签名，iOS应用另提交ios bundle ID。

2. 申请能力

应用创建完成后，联系商务人员申请开通“一键免密登录”能力。

2. Android开发流程

说明

Android sdk支持版本：Android4.0以上

本文档为一键登录SDK1.1版本开发文档

2.1 下载SDK及相关文档

请在相关官网下载最新的SDK集合包

2.2 搭建开发环境

1. 建立你的工程。

2. 将 .aar 拷贝到工程的libs目录下，如没有该目录，可新建。

3. 在build.gradle中添加依赖。

       abiFilters "armeabi"
     }
​
​
repositories {
   
    flatDir {
   
        dirs 'libs'
    }
}
dependencies {
   
//okHttp框架
 implementation 'com.squareup.okhttp3:okhttp:3.12.0'
 //添加易讯云一键登录sdk
 //Android 添加
 implementation name: 'YxAccountSdk-release-2.0.0', ext: 'aar'
 //Androidx 添加
 implementation name: 'YxAccountSdkx-release-2.0.0', ext: 'aar'
 //移动api
 implementation name: 'CMCCSSOSDK-release', ext: 'aar'
 //电信api
 implementation name: 'CTAccountSdk_HY_v3.7.0_armeabi', ext: 'aar'
}

4. 添加必要的权限

AndroidManifest.xml设置

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

权限	说明
INTERNET	允许应用程序联网，用于访问网关和认证服务器
READ_PHONE_STATE	获取imsi用于判断双卡和换卡
ACCESS_WIFI_STATE	允许程序访问WiFi网络状态信息
ACCESS_NETWORK_STATE	获取网络状态，判断是否数据、wifi等
CHANGE_NETWORK_STATE	允许程序改变网络连接状态

2.3 开始开发

1. 创建一个YxAuthnHelper实例

YxAuthnHelper是SDK的功能入口，所有的接口调用都得通过YxAuthnHelper进行调用。因此，调用SDK，首先需要创建一个YxAuthnHelper实例

方法原型：

public static YxAuthHelper getInstance(Context context)

参数说明：

参数	类型	说明
context	Context	调用者的上下文环境，其中activity中this即可以代表。

示例代码：

public void onCreate(Bundle savedInstanceState) {
   
super.onCreate(savedInstanceState)