Android

1.引入Jar包

直接导入下载的jar包

implementation files('libs/quick-login-v<最新版>.jar')

2. 权限声明

    <!-- 必要的权限 -->
    <!-- 允许应用程序联网，用于访问网关和认证服务器 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- 获取网络状态，判断是否数据、wifi等 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 允许程序改变网络连接状态 -->
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

    <!-- 非必要权限 -->
    <!-- 允许程序访问WiFi网络状态信息 -->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 用于判断双卡和换卡 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

3.初始化SDK

接口

/**
 * 初始化
 *
 * @param context Application Context
 * @param key 分配的key
 */
public static LoginHelper getInstance(Context context, String key)

参数说明

参数	类型	说明
context	Context	Application Context
key	String	分配的Key

示例

LoginHelper loginHelper = LoginHelper.getInstance(getApplicationContext(), "分配的key");

4.获取accessCode

接口

/**
 * 获取token
 *
 * @param tokenListener TokenListener 回调监听
 * @param timeout 请求超时时间
 */
public void getToken(TokenListener tokenListener, int timeout)

参数说明

参数	类型	说明
tokenListener	TokenListener	Application Context
timeout	int	请求超时时间

TokenListener

public interface TokenListener {
 /**
     * 成功时回调
     *
     * @param tokenInfo 运营商结果信息
     */
void onTokenSuccess(TokenInfo tokenInfo);

/**
   * 失败时回调
   *
   * @param tokenInfo 失败信息
   */
void onTokenFail(TokenInfo tokenInfo);

参数说明

参数	类型	说明
tokenInfo	TokenInfo	结果对象

TokenInfo对象说明：

参数	类型	是否回传服务器	说明
resultCode	int	否	获取结果，0：成功 其他状态码：失败
msg	string	否	结果信息
operatorType	string	是	成功时返回，运营商类型 CM：中国移动 CU：中国联通 CT：中国电信
accessCode	string	是	成功时返回，用于置换手机号的accessCode
authCode	String	是	电信校验code
traceId	string	是	成功时返回，追踪ID
mobile	string	否	脱敏手机号

示例

loginHelper.getToken(new TokenListener() {
@Override
    public void onTokenSuccess(final TokenInfo tokenInfo) {
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                resp.setText("resultCode:" + tokenInfo.getResultCode() + ",msg:" + tokenInfo.getMsg() + ",operatorType:" + tokenInfo.getOperatorType() + ",accessCode:" + tokenInfo.getAccessCode() + ",traceId:" + tokenInfo.getTraceId() + ",mobile:" + tokenInfo.getMobile());

            }
        });
    }

@Override
    public void onTokenFail(final TokenInfo tokenInfo) {
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                resp.setText("code=" + tokenInfo.getResultCode() + ",msg=" + tokenInfo.getMsg());
            }
        });
    }
}, 5000);

5. 打印日志

loginHelper.setDebug();

6.释放资源

如果置换手机信息成功后，调用以下方法释放资源

loginHelper.destroy();