易验,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'
}
- 添加必要的权限
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)