交互流程

1、接入说明

 （1）接入前请先确认

   A.   已申请appId、appSecret。

   B.   正确配置包名与签名(签名指纹MD5值)。

（2）选择SDK包，SDK 含有so库,请根据您项目的so目录（若有），选择包含对应ABI目录的aar包。

   A.  CTAccountSdk_HY_v3.7.x_armeabi.aar ，只包含了armeabi的so库（若您项目无so库或只有armeabi目录，建议使用该aar包）;

   B.  CTAccountSdk_HY_v3.7.x_all.aar，包含多个so库目录(分别armeabi，armeabi-v7a,arm64-v8a,x86,x86_64，请根据您项目so库目录，过滤多余的so库)

2、导入aar包

（1）将AAR包导入到libs目录下

（ 2 ）在build.gradle配置aar依赖

dependencies {

       //name为libs目录下.aar文件名称，ext为.aar的扩展名

     compile(name: 'CTAccountSdk_v3.6.0_armeabi', ext: 'aar')

}

3、配置权限清单             

（1） 在AndroidManifest.xml配置权限

<uses-permission android:name="android.permission.INTERNET" />

<uses-permission android:name="android.permission.CHANGE_NETWORK_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.WRITE_SETTINGS" />

<uses-permission android:name="android.permission.GET_TASKS" />

（2）配置权限说明

（3）Activity组建配置

<activity

    android:name="cn.com.chinatelecom.account.sdk.ui.AuthActivity"

    android:exported="false"

    android:theme="@style/authActivityTheme"

    android:screenOrientation="portrait" />

<activity

    android:name="cn.com.chinatelecom.account.sdk.ui.PrivacyWebviewActivity"

    android:exported="false"

    android:theme="@style/authActivityTheme"

    android:screenOrientation="portrait" />

4、配置混淆规则    

在混淆配置文件末尾添加如下：

-keep class cn.com.chinatelecom.account.**{*;}

5、SDK接口调用说明

 5.1 初始化SDK

    【接口说明】

      在使用天翼账号SDK接口之前，必须先调用初始化方法。建议在Application或Activity的onCreate()调用。

    【调用示例】

CtAuth.getInstance().init(context, APPID , APPSECRET, false);

    【请求参数】

   【响应参数】

     无 

 5.2 预登录接口

   【接口说明】

     使用SDK登录前，需要提前调用预登录接口，获取预登录结果、过期时间戳、运营商类型等信息，其中预登录结果默认有效期为10分钟。

   【调用示例】

CtAuth.getInstance().requestPreLogin (null ,new ResultListener() {

    @Override

    public void onResult(String result) {

        Log.i(TAG, "requestPreLogin ---> result : " + result);

    }

});

   【请求参数】  

   【响应参数】

     返回结果result的json格式说明：

     data格式说明：   

 5.3 打开登录界面

   【接口说明】

     使用该接口前，必须先完成调用初始化和预登录接口。该接口用于打开登录界面，用户点击一键登录按钮，将返回登录结果。

   （注意：打开登录界面后，需确保该Activity在屏幕的最顶部，由用户点击授权一键登录）

   【调用示例】

CtAuth.getInstance().openAuthActivity(context ,authPageConfig,new ResultListener() {

    @Override

    public void onResult(String result) {

         Log.i(TAG, "login ---> result : " + result);

    }

});

   【请求参数】  

   【响应参数】

     返回结果result的json格式说明：

     data格式说明：   

 5.4 关闭登录界面

   【接口说明】

     当返回登录结果后，合作方APP可以调用该接口关闭登录界面。

   【调用示例】

CtAuth.getInstance().finishAuthActivity();

   【请求参数】

     无 

   【响应参数】

     无