android 平台接口文档,开放平台-文档

3、配置权限清单

(1) 在AndroidManifest.xml配置权限

(2)配置权限说明

权限用途INTERNET允许应用程序联网

CHANGE_NETWORK_STATE允许程序改变网络连接状态

ACCESS_WIFI_STATE允许程序访问WiFi网络状态信息

ACCESS_NETWORK_STATE允许程序访问联网状态，区分用户设备是移动网络或WiFi

WRITE_SETTINGS允许读写系统设置项

GET_TASKS允许访问task

(3)Activity组建配置

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

android:exported="false"

android:theme="@style/authActivityTheme"

android:screenOrientation="portrait" />

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);

【请求参数】参数名类型必填说明contextContext是上下文环境

appIdString是向天翼账号平台申请的应用ID

appSecretString是向天翼账号平台申请的应用密钥

isDebugModeboolean是调试模式(上线前需置为false)

false：不输出SDK日志true：输出SDK日志

【响应参数】

无

5.2 预登录接口

【接口说明】

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

【调用示例】CtAuth.getInstance().requestPreLogin (null ,new ResultListener() {

@Override

public void onResult(String result) {

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

}

});

【请求参数】参数名类型必填说明ctSettingCtSetting否超时时间设置,可传null。

也可传入自定义的ctSetting。传null默认为

CtSetting ctSetting =CtSetting(3000,3000 ,1000);三个参数分别为连接超时时间、读取超时时间、总超时时间。

resultListenerResultListener是预登录回调接口，接口方法onResult(String result)用于接收请求结果。其中result为返回结果json格式字符串。

【响应参数】

返回结果result的json格式说明：参数名类型字段含义说明resultint结果码返回参数结果码，0表示成功

msgString结果说明结果码对应详细说明

dataString响应数据json格式的响应数据

data格式说明：参数名类型字段含义说明operatorTypeString运营商标识CT电信，CU联通，CM移动，UN其他

expiredTimeint预登录结果失效时间预登录结果失效时间

accessCodeString授权码天翼账号授权码(可用于登录/校验，一次性有效，有效期60min)

5.3 打开登录界面

【接口说明】

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

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

【调用示例】CtAuth.getInstance().openAuthActivity(context ,authPageConfig,new ResultListener() {

@Override

public void onResult(String result) {

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

}

});

【请求参数】参数名类型必填说明contextContext是上下文环境

authPageConfigAuthPageConfig是AuthPageConfig为登录界面配置类，用于设置登录界面的布局文件及控件ID，并传入SDK。 详细说明见Demo

resultListenerResultListener是登录回调接口，接口方法onResult(String result)用于接收请求结果。其中result为返回结果json格式字符串。

【响应参数】

返回结果result的json格式说明：参数名类型字段含义说明resultint结果码返回参数结果码，0表示成功

msgString结果说明结果码对应详细说明

dataString响应数据json格式的响应数据

data格式说明：参数名类型字段含义说明accessCodeString授权码天翼账号授权码，用于获取信息接口传参，默认时效性10分钟

authCodeString校验码天翼账号校验码，用于获取信息接口传参

operatorTypeString运营商标识CT电信，CU联通，CM移动，UN其他

expiredTimeint失效时间预登录结果失效时间戳

5.4 关闭登录界面

【接口说明】

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

【调用示例】CtAuth.getInstance().finishAuthActivity();

【请求参数】

无

【响应参数】

无