芝麻认证1.0.2
芝麻认证SDK ZMCertification
v1.0.1
变更和修订历史记录
目录
芝麻认证SDK (1)
ZMCertification (1)
v1.0.1 (1)
目录 (2)
1芝麻认证简介 (4)
1.1芝麻认证SDK (4)
1.2芝麻认证逻辑 (4)
2SDK接口 (4)
2.1Android接口 (4)
2.1.1类ZMCertification (4)
2.1.2ZMCertification.getInstance (4)
2.1.3ZMCertification.getVersion (4)
2.1.4ZMCertification.setZMCertificationListener (5)
2.1.5ZMCertification.startCertification (5)
2.1.6ZMCertification的ErrorCode (5)
2.1.7接口ZMCertificationListener (6)
2.1.8ZMCertificationListener.onFinish (6)
2.2iOS接口 (6)
2.2.1类ZMCertification (6)
2.2.2ZMCertification.startCertification (6)
2.2.3ZMCertification.getVersion (7)
2.2.4ZMCertification的回调函数 (7)
2.2.5枚举ZMStatusErrorType (8)
3SDK集成 (10)
3.1Android集成 (10)
3.1.1Android Studio（aar） (10)
3.1.2Eclipse（Project Library） (11)
3.2iOS集成 (11)
3.2.1将ZMCert.framework 文件添加进入项目 (11)
3.2.2引入所需的系统库 (12)
3.2.3环境配置 (12)
3.2.4引入.bundle 资源文件 (12)
3.2.5引入头文件 (12)
3.2.6一份简单的示例代码 (12)
4FAQ (12)
4.1SDK使用需要那些设备权限？ (12)
4.2SDK 支持哪些手机，支持什么操作系统，对设备有什么要求？ (13)
4.3Android SDK一直不释放我的listener导致有内存泄露怎么办？ (13)
4.4Android程序只需要使用armv7a的so库，不需要使用arm64的so库 (13)
4.5Android程序有一些特殊的布局需求 (13)
1芝麻认证简介
1.1芝麻认证SDK
芝麻认证SDK是由蚂蚁金服及Face++|旷视公司一同开发的，基于生物特征的身份验证SDK。芝麻认证SDK 对接方便，易于集成，使用简单，同时支持Android和iOS双平台，服务于大中小各类互联网企业。
1.2芝麻认证逻辑
芝麻认证逻辑大致分为三步：
1.调用芝麻验证WebAPI，获取bizNO（业务串号）以及merchantID（商户号）；
2.使用bizNO和merchantID完成SDK初始化，进入认证页面；
3.用户通过认证流程后，返回商户界面，并通过回调告知结果。
2SDK接口
2.1Android接口
2.1.1类ZMCertification
ZMCertification类是管理芝麻认证的类，此类不可以初始化，只能通过getInstance获得其单例。
2.1.2ZMCertification.getInstance
2.1.3ZMCertification.getVersion
2.1.4ZMCertification.setZMCertificationListener
2.1.5ZMCertification.startCertification
2.1.6ZMCertification的ErrorCode
2.1.7
接口ZMCertificationListener
ZMCertificationListener 是一个回调接口，当完成芝麻认证逻辑后，会调用此接口。
2.1.8 ZMCertificationListener.onFinish
2.2 iOS 接口
2.2.1 类ZMCertification
ZMCertification 类是管理芝麻认证的类，此类使用默认的构造函数初始化即可。
2.2.2 ZMCertification.startCertification
2.2.3ZMCertification.getVersion
2.2.4ZMCertification的回调函数
2.2.5枚举ZMStatusErrorType
3SDK集成
3.1Android集成
3.1.1Android Studio（aar）
●把arr文件复制进入libs文件夹中（图1）
图1
●在APP的gradle中加入（图2）
repositories {
flatDir{
dirs 'libs'
}
}
并在dependencies 中加入compile(name:'ZMCert_SDK', ext:'aar')
图2
●点击Rebuild Project即可
3.1.2Eclipse（ProjectLibrary）
●打开Eclipse的Package Explorer
●鼠标右键选择new然后点击右侧的Project...。弹出对话框后打开Android文件夹然后双
击Android Project from Existing Code选项会弹出新的对话框。再点击Browse按钮去选择刚刚下载好的demo，选择好后点击确定。这时会弹出新的对话框，里面会有两个工程被选择一个lib和一个project.再点击下面的finish按钮就回把两个工程导入Eclipse 中。
●把两个工程导入eclipse后，鼠标放在lib工程上右键鼠标选择Properties点击打开，弹
出对话框后选择Android选项。然后把右边的进度条拉到最底部，点击选中IS Library 选择框。然后点击Apply按钮最后点击ok按钮退出。
●再把鼠标移到project工程上右键鼠标选择Properties点击打开，弹出对话框后选择
Android选项。然后把右边的进度条拉到最底部，点击add按钮这时会弹出对话框选择刚刚的lib点击OK按钮。然后点击Apply按钮最后点击ok按钮退出。
●集成完毕（可以clean一下你的工程）
3.2iOS集成
3.2.1将ZMCert.framework文件添加进入项目
在TARGETS->Build Phases-> Link Binary With Libaries中点击“+”按钮，在弹出的窗口中点击“Add Other”按钮，选择ZMCert.framework添加到工程中。
注: 静态库中采用Objective-C++实现，因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将任意一个.m后缀的文件改名为.mm)，或者在工程属性中指定编译方式，即在Xcode的Project -> Edit Active Target -> Build Setting 中找到Compile Sources As，并将其设置为"Objective-C++"
3.2.2引入所需的系统库
需要在您的Xcode工程中引入CoreMoton.framework和WebKit.framework、A VFoundation.framework、CoreMedia.framework、CoreGraphics.framework。
3.2.3环境配置
在TARGETS->Build Settings->Other Linker Flags 中添加-ObjC。
3.2.4引入.bundle 资源文件
选中工程名，在右键菜单中选择Add Files to “工程名”…，从ZMCert.framework文件中选择ZMCert.bundle文件，并勾选“Copy items if needed”复选框，单击“Add”按钮，将资源文件添加到工程中。
3.2.5引入头文件
#import
3.2.6一份简单的示例代码
ZMCertification *manager = [[ZMCertificationalloc] init];
[managerstartWithBizNO:https://www.sodocs.net/doc/aa2668387.html,TextView.text
merchantID:self.merchantView.text
extParams:nil
viewController:self
onFinish:^(BOOL isCanceled, BOOL isPassed, ZMStatusErrorTypeerrorCode) {
if (isCanceled) {
NSLog(@"用户取消了认证");
}else{
if (isPassed) {
NSLog(@"认证成功");
}else{
NSLog(@"认证失败了 %zi", errorCode);
}
}
}];
4FAQ
4.1SDK使用需要那些设备权限？
SDK 的使用需要用到手机的网络、前置摄像头以及重力传感器，如果用户关闭了相关权限，则验证流程会失败并返回对应错误。
4.2SDK 支持哪些手机，支持什么操作系统，对设备有什么
要求？
SDK 支持Android 4.0 及iOS 8.0 以上的设备，要求设备有前置摄像头以及重力传感器。目前SDK 经过了以下手机的测试：
●iPhone4s
●iPhone5
●iPhone6
●iPhone6 Plus
●iPhone6s
●华为荣耀7i
●华为c199s
●OPPO N511
●OPPO R9M
●VIVO X7
●REDMI NOTE3
●LE X620
●OPPO A59M
●XIAOMI 5
●SAMSUNGNote3
●SAMSUNGs6
●Nexus5X
●Nexus5
4.3Android SDK一直不释放我的listener导致有内存泄露
怎么办？
Android SDK使用的是单例，所以会一直握有listener指针，您可以在完成芝麻认证操作后，调用setListener函数将其置为空。
4.4Android程序只需要使用armv7a的so库，不需要使用
arm64的so库
您可以使用Eclipse版本的Android SDK，并手动删除arm64的so库。芝麻认证SDK 不支持armeabi架构，如果您需要在此架构上使用SDK，也建议您在Eclipse版本的SDK上手动创建armeabi文件夹，并将armv7a的so库拷贝进去。
4.5Android程序有一些特殊的布局需求
您可以使用Eclipse版本的Android SDK，并手动修改ZhiMaSDKLib工程中的AndroidManifest.xml文件，选择您需要的布局。