最近公司要求接入移动认证SDK,实现手机号一键授权登录功能,虽然官网也有demo,但我感觉官网demo比较复杂,在此自己写个demo。如有侵权,请联系删除,谢谢。
集成版本号:SDK5.7.1版本
注意事项:
1. 一键登录服务必须打开蜂窝数据流量并且手机操作系统给予应用蜂窝数据权限才能使用
2. 取号请求过程需要消耗用户少量数据流量(国外漫游时可能会产生额外的费用)
3. 一键登录服务目前支持中国移动2/3/4G(2,3G因为无线网络环境问题,时延和成功率会比4G低)和中国电信4G(如有更新会在技术沟通QQ群上通知)
4. (新增)建议全部SDK方法由主线程发起调用,因为SDK的数据容器就是在主线程进行读写操作的,如果外部发起调用SDK方法的线程不是主线程可能会导致多线程对数据容器读写导致崩溃
5. (新增)SDK不建议嵌套和并发调用,即在上一次请求未结束(未有回调)马上发起下一次请求时,第二次请求将不会有回调,成功率将无法得到保证。
接入流程:
1.申请appid和appkey,前往中国移动开发者社区(dev.10086.cn),创建开发者账号并申请appid和appkey,并填写应用的包名(bundle ID)。
2.申请能力
应用创建完成后,在页面左侧选择一键登录能力,配置应用服务器出口IP地址(注意IP地址不能随意写,否则会报错)及验签方式。
集成步骤:
1. xcode版本需使用9.0以上,否则会报错
2. 导入认证SDK的framework,直接将移动认证TYRZSDK.framework拖到项目中
3. 在Xcode中找到TARGETS-->Build Setting-->Linking-->Other Linker Flags在这选项中需要添加-ObjC
4. 注意:如果以上操作仍然出现unrecognized selector sent to instance找不到方法的报错,则添加更改为_all_load
5. 资源文件:在Xcode中务必导入TYRZResource.bundle到项目中,否则授权界面显示异常(不显示默认图片) TARGETS-->Build Phases-->Copy Bundle Resources-> 点击 "+" --> Add Other --> TYRZSDK.frameWork --> TYRZResource.bundle -->Open
6. 导入sdk语句:#import <TYRZSDK/TYRZSDK.h>,导入后才能调用SDK的方法
7. 在info.plist 文件中添加一个子项目App Transport Security Settings,然后在其中添加一个key:Allow Arbitrary Loads,其值为YES。修改后其他运营商才能使用一键登录。
SDK使用
初始化SDK
//初始化SDK
[UASDKLogin.shareLogin registerAppId:appId AppKey:appKey];
//开启日志打印
[UASDKLogin.shareLogin printConsoleEnable:YES];
获取网络类型
/*
获取网络类型
本方法用于获取用户当前的网络环境和运营商(双卡下,获取上网卡的运营商)
*/
-(NSDictionary *)getNetInfo{
return [UASDKLogin.shareLogin networkInfo];
}
预取号
/*
预取号
本方法用于发起取号请求,SDK完成网络判断、蜂窝数据网络切换等操作并缓存凭证scrip。
*/
-(void)getPhoneNumber{
[UASDKLogin.shareLogin getPhoneNumberCompletion:^(NSDictionary * _Nonnull sender) {
NSString *resultCode = sender[@"resultCode"];
NSMutableDictionary *result = [NSMutableDictionary dictionaryWithDictionary:sender];
if ([resultCode isEqualToString:@"103000"]) {
NSLog(@"预取号成功");
} else {
NSLog(@"预取号失败");
}
NSLog(@"%@", result);
[self showInfo:result];
}];
}
拉起授权页面
/*
获取token拉起授权页面
应用调用本方法时,SDK将拉起用户授权页面,用户确认授权后,SDK将返回token给应用客户端。可通过返回码200087监听授权页是否成功拉起。
*/
-(void)getAuthorization{
UACustomModel * model = [[UACustomModel alloc] init];
model.currentVC = self;
// model.authPageBackgroundImage = [UIImage imageNamed:@"IMG_2924"];
[UASDKLogin.shareLogin getAuthorizationWithModel:model complete:^(id _Nonnull sender) {
NSMutableDictionary *result = [NSMutableDictionary dictionaryWithDictionary:sender];
NSLog(@"%@", result);
NSString *resultCode = sender[@"resultCode"];
if ([resultCode isEqualToString:@"200087"]) {
NSLog(@"拉起授权页面");
}else if ([resultCode isEqualToString:@"103000"]) {
NSLog(@"授权完毕");
//一下两种方法都可行
//系统原方法
// [self dismissViewControllerAnimated:YES completion:nil];
//SDK提供的方法
[UASDKLogin.shareLogin ua_dismissViewControllerAnimated:YES completion:nil];
}else{
[self showInfo:result];
}
}];
}
本机号码校验
/*
本机号码校验
开发者可以在应用内部任意页面调用本方法,获取本机号码校验的接口调用凭证(token)
*/
-(void)mobileAuth{
[UASDKLogin.shareLogin mobileAuthCompletion:^(NSDictionary * _Nonnull result) {
NSLog(@"%@", result);
NSString *resultCode = result[@"resultCode"];
if ([resultCode isEqualToString:@"103000"]) {
NSLog(@"校验成功");
}else{
NSLog(@"校验失败:resultCode:%@",resultCode);
}
[self showInfo:result];
}];
}
删除临时取号凭证
/*
删除临时取号凭证
本方法用于删除取号方法getPhoneNumberCompletion成功后返回的取号凭证scrip
*/
-(BOOL)delectScrip{
return [UASDKLogin.shareLogin delectScrip];
}
自定义请求超时设置
/*
自定义请求超时设置
本方法用于设置取号、一键登录、本机号码校验请求的超时时间(默认8000,单位毫秒)
*/
- (void)setTimeoutInterval:(NSTimeInterval)timeout{
[UASDKLogin.shareLogin setTimeoutInterval:timeout];
}