梦网统一认证SDK(iOS)接口文档

1.初始化SDK

接口说明

- (void)initWithAppId:(NSNumber *)appId appKey:(NSString*_Nonnull)appKey;

本方法用于发起初始化一键免密登录（或本机号码校验）能力，SDK完成网络请求并根据运营商类型自动选择配置信息。应用使用SDK功能时首先调用该方法。

接口参数

• 示例

  [[MWUniLoginSDK shareInstance] initWithAppId:MyAppId appKey:MyAppKey];
  

2.一键登录预取号

接口说明

- (void)getAccessCodeFinishBlock:(MWReturnBlock _Nonnull )complete;

预取号码信息，获取AccessCode。建议在APP登录页初始化时调用，提高后续授权页的打开速度。不要在APP启动初始化时调用，避免接口调用资源浪费。

接口参数

• 示例

   [[MWUniLoginSDK shareInstance] getAccessCodeFinishBlock:^(NSDictionary *_Nullable resultDic) {
    }];
  

3.一键登录唤起授权页并获取token

接口说明

 - (void)authLoginWithBlock:(MWReturnBlock _Nonnull )complete;

唤起一键登录授权页，在用户授权后获取一键登录的token。为了提高安全性，本SDK不直接提供获取手机号明文的功能。应用服务端可以使用此token访问梦网服务端接口，获取具体的手机号码信息。

接口参数

• 示例

  [[MWUniLoginSDK shareInstance] authLoginWithBlock:^(NSDictionary * _Nonnull resultDic) {
        NSLog(@"%@", resultDic);
    }];
  

4.获取本机号码校验token

接口说明

- (void)requestPhoneTokenWithBlock:(MWReturnBlock _Nonnull)complete;

返回token，用于手机号码校验。为了提高安全性，本SDK不直接提供号码校验功能，应用服务端可以使用此token和待校验的手机号码访问梦网服务端接口，确定待校验号码是否为本机号码。

接口参数

• 示例

  [[MWUniLoginSDK shareInstance] requestPhoneTokenWithBlock:^(NSDictionary * _Nonnull resultDic) {
        self.verifyToken = resultDic[@"token"];
    }];
  

5.授权页UI个性化定制

接口说明

[[MWUniLoginSDK shareInstance] setAuthViewModel:self.authViewModel];

根据应用UI风格可以个性化定制授权页UI显示效果，以保持应用统一的风格。

接口参数

AuthViewModel配置参数说明

5.1.导航栏

• authViewBlock示例

   __weak typeof(self) weakSelf = self;
        //自定义视图在这里面添加到customView上
        _authViewModel.authViewBlock = ^(UIView *customView, CGRect numberFrame, CGRect loginBtnFrame, CGRect checkBoxFrame, CGRect privacyFrame) {
            __strong typeof(weakSelf) strongSelf = weakSelf;
            [strongSelf addSubviewsIntoCustomView:customView withNumberFrame:numberFrame loginBtnFrame:loginBtnFrame checkBoxFrame:checkBoxFrame privacyFrame:privacyFrame];
        };
  
  //给授权界面添加自定义UI
  - (void)addSubviewsIntoCustomView:(UIView *)customView withNumberFrame:(CGRect)numberFrame loginBtnFrame:(CGRect)loginBtnFrame checkBoxFrame:(CGRect)checkBoxFrame privacyFrame:(CGRect)privacyFrame
  {
  
    CGFloat top = Height_StatusBar;
    CGFloat height = Height_NavBar;
    if (_authViewModel.authWindow) {
        top = 0;
        height = 44;
      }
    
    UIButton *backButton = [UIButton buttonWithType:UIButtonTypeSystem];
    backButton.frame = CGRectMake(10, top, 40, 40);
    backButton.tintColor = [UIColor whiteColor];
    [backButton setImage:[UIImage imageNamed:@"titlebar_icon_back"] forState:UIControlStateNormal];
    [backButton addTarget:self action:@selector(backButtonAction) forControlEvents:UIControlEventTouchUpInside];
    
    UIView *navView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, customView.frame.size.width, height)];
    navView.backgroundColor = ThemeColor;
    [customView addSubview:navView];
  
    UILabel *titleLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, top, customView.frame.size.width, 44)];
    titleLabel.font = [UIFont systemFontOfSize:17];
    titleLabel.textColor = [UIColor whiteColor];
    titleLabel.textAlignment = NSTextAlignmentCenter;
    titleLabel.text = @"一键登录";
    [navView addSubview:titleLabel];
  
    [navView addSubview:backButton];
  }
  

5.2.号码栏

5.3.登录按钮

5.4.隐私栏

5.5.自定义布局

5.6.转场动画

5.7.弹窗模式

• 示例

   _authViewModel.authWindow = YES;
   _authViewModel.modalTransitionStyle = UIModalTransitionStyleFlipHorizontal;
  

6.退出授权页界面

在authViewBlock返回的customView里添加Button并绑定点击事件

- (void)addSubviewsIntoCustomView:(UIView *)customView withNumberFrame:(CGRect)numberFrame loginBtnFrame:(CGRect)loginBtnFrame checkBoxFrame:(CGRect)checkBoxFrame privacyFrame:(CGRect)privacyFrame
{

    CGFloat top = Height_StatusBar;
    CGFloat height = Height_NavBar;
    if (_authViewModel.authWindow) {
        top = 0;
        height = 44;
    }
    
    UIButton *backButton = [UIButton buttonWithType:UIButtonTypeSystem];
    backButton.frame = CGRectMake(10, top, 40, 40);
    backButton.tintColor = [UIColor whiteColor];
    [backButton setImage:[UIImage imageNamed:@"titlebar_icon_back"] forState:UIControlStateNormal];
    [backButton addTarget:self action:@selector(backButtonAction) forControlEvents:UIControlEventTouchUpInside];
    
    UIView *navView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, customView.frame.size.width, height)];
    navView.backgroundColor = ThemeColor;
    [customView addSubview:navView];

    UILabel *titleLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, top, customView.frame.size.width, 44)];
    titleLabel.font = [UIFont systemFontOfSize:17];
    titleLabel.textColor = [UIColor whiteColor];
    titleLabel.textAlignment = NSTextAlignmentCenter;
    titleLabel.text = @"一键登录";
    [navView addSubview:titleLabel];

    [navView addSubview:backButton];
}
- (void)backButtonAction {
     NSNumber *type = [[MWUniLoginSDK shareInstance] getOperatorType];
    //移动卡直接退出
       if ([type intValue] == 1) {
           [self dismissViewControllerAnimated:YES completion:nil];
       } else {
           //联通、电信卡则发送以下通知
           [[NSNotificationCenter defaultCenter] postNotificationName:@"authViewDisMissKey" object:nil];
       }
}

SDK一键登录完成回调后，不会立即关闭授权页面，需要开发者主动调用此方法去完成页面的关闭。授权页的退出完全由APP控制，注意需要在主线程调用此函数。

7.获取当前SIM卡的运营商

接口说明

- (NSNumber*_Nonnull)getOperatorType;

返回值