交互流程图

合作方接入天翼账号免密功能，在免密登录成功后，天翼账号平台返回用户信息及token有效期内，合作方可以通过token获取用户信息。

注意：

“蓝色流程”由合作方实现对接，流程序号与本文标题序号章节相对应。                   

“绿色流程”由天翼账号实现，合作方可进行了解。

成功对接效果图：

1 接入SDK的工作配置

1.1 前期准备

接入方在天翼账号开放平台申请企业开发者、应用APPID、及免密登录权限，详见《接入流程》

SDK及SDK DEMO下载，详见《天翼账号登录相关资源》

1.2 导包

（1）将EAccountSDK文件夹（包括EAccountSDKArchive.framework）复制到自己的文件夹目录下；

（2）在工程中添加EAccountSDK文件（在工程名上点击右键弹出菜单后选择“Add Files to ‘xxxxxx’” 其中‘xxxxxx’为你的工程名字，如图1所示）

（3）弹出的窗口选择EAccountSDKArchive.framework文件,在选项“Copy items into destination group’s folder(if needed)”打钩，务必记得添加目标项目“Add to targets”选择你的目标工程，最后点击”Add”

（4）查询工程是否添加了EAccountSDKArchive.framework文件，（点击工程项目，点击目标TARGETS，选择Build Phases，展开Link Binary With Libraries，查看是否存在EAccountSDKArchive.framework文件，具体操作看图2。）如果工程没有添加EAccountSDKArchive.framework文件则需要手动添加（点击”+”按钮，如图3弹出选择框，选择“Add Other ...”按钮，在弹出的选择文件中，选择EAccountSDKArchive.framework，点击“Open”按钮）。

（5）增加动态库 

   libz.1.2.8.tbd

   libsqlite3.0.tbd

   libc++.1.tbd

（6）在项目的info.plist文件中添加Privacy - Camera Usage Description字段，值设置为NSCameraUsageDescription（iOS10适配）

在工程中引入静态库后，需要在编译时添加-force_load编译选项，避免静态库中加载不完全造成程序崩溃。(具体方法：点击TARGETS，点击“Build Settings”，搜索框内搜索Other Linker Flags,在“Other Linker Flags”选项后添加” -force_load”，添加-force_load和EAccountSDK.framework/EAccountSDKArchive 文件所在的路径，请根据自己文件的实际路径进行设置,如图4)

 1.4 添加相机和相册权限及FaceID权限

如下图：

Privacy - Photo Library Usage Description

Privacy - Camera Usage Description

Privacy - Face ID Usage Description

1.5 添加资源包

将HTMLResource.bundle添加到工程。

注意，这里要选择Create folder references

添加后的效果图。

接入方可以根据自己产品需要接入自己产品的Logo，如果不接入自己产品的Logo,将使用默认的天翼账号Logo。接入方添加自己应用的Logo的方法如下： 在添加好资源包的基础上，替换资源包里边默认的logo图（/images/topIcon/topIcon-logo.png文件）；

注意：目录结构和名称不能变，logo文件的名称必须为：topIcon-logo.png和topIcon-default.png; 图片尺寸都是240 * 240。

如下图：

1.7 关于bundleID的设定

（1）请确保工程的bundleID与申请appKey时所填的bundleID一致。

（2）如果需要使用企业证书重签名的bundleID进行测试，请添加+(void) settestBundleId,发布到App Stroe上的时候请确保没有该方法。

2 对接指引

2.1 在应用启动时初始化

接口调用说明：要使天翼账号SDK运行，需在调用任何其他方法前，先调用初始化方法；（如下图所示，在 AppDelegate 的 didFinishLaunchingWithOptions 函数中初始化SDK）。

注意：请确保工程设置的bundleID与申请appKey时所填的bundleID一致。

请求参数：

2.2 免密登录接口

接口定义：

接口调用说明：在用户点击登录按钮后，调用免密登录接口，调用方法如下：

请求参数：

登录配置模型属性列表：

响应参数：

登录回调的code

2.3 免密登录接口(迷你弹框)

接口定义：

在用户点击登录按钮时，调用弹框登录接口，SDK会在当前控制器上弹出登录框，调用方法如下图：

请求参数：

响应参数：

登录回调的code

3 免密登录后的流程

3.1 获取用户信息

通过获取用户信息接口，在用户登录后可以获取用户昵称、手机号码、头像等信息，需要对接获取用户信息接口，具体可到以下文档了解：

《获取用户信息》

3.2 刷新accessToken

accessToken是调用账号登录的调用凭证，accessToken有效期为1个月，在有效期内避免accessToken过期后，可以在用户打开应用时使用刷新accessToken接口进行刷新，具体可到以下文档了解：

《刷新accessToken》

4 附录及常见问题

4.1 登录错误返回码定义，可到以下文档了解：

 《登录返回码说明》

4.2 天翼账号SDK版本支持说明

天翼账号SDK支持IOS9及以上版本。

4.3 天翼账号SDK使用的第三方库说明

天翼账号SDK使用第三方类库包含SSZipArchive、UIWebView+TS_JavaScriptContext。