夢網(wǎng)統(tǒng)一認證SDK(iOS)接口文檔

1.初始化SDK

接口說明

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

本方法用于發(fā)起初始化一鍵免密登錄（或本機號碼校驗）能力，SDK完成網(wǎng)絡請求并根據(jù)運營商類型自動選擇配置信息。應用使用SDK功能時首先調(diào)用該方法。

接口參數(shù)

• 示例

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

2.一鍵登錄預取號

接口說明

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

預取號碼信息，獲取AccessCode。建議在APP登錄頁初始化時調(diào)用，提高后續(xù)授權(quán)頁的打開速度。不要在APP啟動初始化時調(diào)用，避免接口調(diào)用資源浪費。

接口參數(shù)

• 示例

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

3.一鍵登錄喚起授權(quán)頁并獲取token

接口說明

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

喚起一鍵登錄授權(quán)頁，在用戶授權(quán)后獲取一鍵登錄的token。為了提高安全性，本SDK不直接提供獲取手機號明文的功能。應用服務端可以使用此token訪問夢網(wǎng)服務端接口，獲取具體的手機號碼信息。

接口參數(shù)

• 示例

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

4.獲取本機號碼校驗token

接口說明

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

返回token，用于手機號碼校驗。為了提高安全性，本SDK不直接提供號碼校驗功能，應用服務端可以使用此token和待校驗的手機號碼訪問夢網(wǎng)服務端接口，確定待校驗號碼是否為本機號碼。

接口參數(shù)

• 示例

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

5.授權(quán)頁UI個性化定制

接口說明

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

根據(jù)應用UI風格可以個性化定制授權(quán)頁UI顯示效果，以保持應用統(tǒng)一的風格。

接口參數(shù)

AuthViewModel配置參數(shù)說明

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];
        };
  
  //給授權(quán)界面添加自定義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.轉(zhuǎn)場動畫

5.7.彈窗模式

• 示例

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

6.退出授權(quán)頁界面

在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 {
           //聯(lián)通、電信卡則發(fā)送以下通知
           [[NSNotificationCenter defaultCenter] postNotificationName:@"authViewDisMissKey" object:nil];
       }
}

SDK一鍵登錄完成回調(diào)后，不會立即關(guān)閉授權(quán)頁面，需要開發(fā)者主動調(diào)用此方法去完成頁面的關(guān)閉。授權(quán)頁的退出完全由APP控制，注意需要在主線程調(diào)用此函數(shù)。

7.獲取當前SIM卡的運營商

接口說明

- (NSNumber*_Nonnull)getOperatorType;

返回值