开发环境要求
应用平台 | 适用版本 |
iOS | iOS 10.0及以上系统 当前framework 基于Obiective-C编写 |
项目配置
添加pod依赖
pod 'AFNetworking', '~> 4.0.1' pod 'Masonry', '~> 1.1.0' pod 'MBProgressHUD', '~> 1.1.0' pod 'SDWebImage', '~> 5.0.4'
SDK资源文件引入
将EsignSDKRes.bundle 和EsignSDK.framework 引入项目中。
注：资源包在【移动端SDK】文档说明中最下方资源下载里。
SDK激活设置
1. 使用开放平台中获取的LicenseKey替换EsignSDK.plist中的licenseKey
2. License文件内字符串替换EsignSDKRes.bundle中的license
3. Bundle Id 确保和申请license时填写的应用包名一致
三者对应才能通过激活认证
权限配置
在info.plist文件中进行系统权限配置，如下：
<!-- 相机 --> <key>NSCameraUsageDescription</key> <string>需要您的同意,APP才能访问相机</string> <!-- 麦克风 --> <key>NSMicrophoneUsageDescription</key> <string>需要您的同意,APP才能访问麦克风</string> <!-- 相册 --> <key>NSPhotoLibraryUsageDescription</key> <string>需要您的同意,APP才能访问相册</string> <!-- 网络服务 模拟环境中允许http --> <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> <true/> </dict>
SDK接口说明
SDK加载H5页面
原型：+ (void)esignCtrlWithUrl:(NSString *)_url ctrl:(UIViewController *)_ctrl esignProtocol:(id<EsignProtocol>)_esignProtocol;
说明：刷脸 SDK 处理 e 签宝 H5 入口
请求参数:
请求参数 | 类型 | 必填 | 参数描述 |
_url | NSString | 是 | api 获取的业务 H5 |
_ctrl | UIViewController | 是 | ⽤于进⾏⻚⾯切换 |
_esignProtocol | EsignProtocol | 是 | 业务节点代理 |
回调处理
原型 ：- (void)businessNode:(id)pramas;
说明：业务节点回调 (签署成功、实名成功、意愿成功)
回调参数：
参数名称 | 必填 | 参数说明 | 回调示例 |
pramas | 是 | 节点回调 | 1、实名 {key:realName,res:success} 2、意愿 {key:will,res:success} 3、签署 {key:sign,res:success} |
支付宝刷脸回跳APP处理
原型：+ (void) handleAppUrl:(NSURL *)_url schemeArr:(NSArray *)_schemeArr;
说明：在 AppDelegate 的 application:(UIApplication *)app openURL:(NSURL *)url 中进行支付宝跳转回来的回调处理
请求参数:
请求参数 | 类型 | 必填 | 参数描述 |
_url | NSString | 是 | Application url |
_schemeArr | NSArray | 是 | 回跳 scheme |
AppDelegate.m 中需要添加回跳APP处理
e签宝刷脸页自定义颜色
closeColor: 关闭按钮文字颜色
progressColor：e签宝刷脸相机录制时progress颜色
confirmBackColor：开始录制按钮背景色
confirmDisabledBackColor：开始录制按钮disble背景色
confirmTextColor：开始录制按钮文字颜色
confirmDisabledTextColor：开始录制按钮disable文字颜色
我要纠错