OneLogin (一键登录)

/**
 向SDK注册AppID
 
 @discussion `AppID`通过后台注册获得，从极验后台获取该AppID，AppID需与bundleID配套

 @param appID 产品ID
 */
+ (void)registerWithAppID:(NSString *)appID;

- (void)viewDidLoad {
    [super viewDidLoad];    
    // 设置AppId，AppID通过后台注册获得，从极验后台获取该AppID，AppID需与bundleID配套
    [OneLogin registerWithAppID:GTOneLoginAppId];
}

/**
 预取号接口
 
 @discussion 调用限制说明
 
 在调用该方法后, 未回调之前, 再次调用该方法时, 方法会直接跳出, 不执行预取号逻辑。
 
 @discussion 预取号成功后存在的有效期
 
 有效期内需要调用 `requestTokenWithViewController:viewModel:completion:`,
 否则需要重新访问 `preGetTokenWithCompletion:`。 其中中国移动和中国电信有效期为 1 小时,
 中国联通为 10 分钟。

 @param completion 处理回调
 */
+ (void)preGetTokenWithCompletion:(void(^)(NSDictionary *sender))completion;

/**
 进行用户认证授权, 获取网关 token 。
 
 @discussion 调用限制说明
 
 为避免授权页面多次弹出, 在调用该方法后, 授权页面弹出, 再次调用该方法时,
 该方法会直接跳出, 不执行授权逻辑。
 
 @discussion 需要用户在弹出的页面上同意服务意条款后, 才会进行免密认证。

 @param viewController  present 认证页面控制器的 vc
 @param viewModel       自定义授权页面的视图模型
 @param completion      结果处理回调
 
 @seealso OLAuthViewModel
 
 */
+ (void)requestTokenWithViewController:(nullable UIViewController *)viewController
                             viewModel:(nullable OLAuthViewModel *)viewModel
                            completion:(void(^)(NSDictionary * _Nullable result))completion;

- (IBAction)normalLoginAction:(UIButton *)sender {
    OLAuthViewModel *viewModel = [OLAuthViewModel new];
    [OneLogin requestTokenWithViewController:self viewModel:viewModel completion:^(NSDictionary * _Nullable result) {
        NSLog(@"OneLogin requestTokenWithViewController result: %@", result);
    }];
}

/**
 @abstract 关闭当前的授权页面
 
 @param animated 是否需要动画
 @param completion 关闭页面后的回调
 
 @discussion
 请不要使用其他方式关闭授权页面, 否则可能导致 OneLogin 无法再次调起
 */
+ (void)dismissAuthViewController:(BOOL)animated completion:(void (^ __nullable)(void))completion;

- (void)dismissAuthVC {
    [OneLogin dismissAuthViewController:nil];
}

/**
 * @abstract 预取号拿到的token是否还在有效期
 *
 * @return YES - 还在有效期，可直接调用requestTokenWithViewController方法进行取号
 *         NO  - 已失效，需重新调用preGetTokenWithCompletion进行预取号之后再调用requestTokenWithViewController方法进行取号
 */
+ (BOOL)isPreGettedTokenValidate;

// 根据SDK的方法判断当前预取号结果是否有效，若当前预取号结果有效，则直接调用requestTokenWithViewController方法拉起授权页面，否则，先调用预取号方法进行预取号，预取号成功后再拉起授权页面
__weak typeof(self) wself = self;
if ([OneLogin isPreGettedTokenValidate]) {
    [OneLogin requestTokenWithViewController:self viewModel:viewModel completion:^(NSDictionary * _Nullable result) {
        NSLog(@"requestTokenWithViewController result: %@", result);
    }];
} else {
    [GTProgressHUD showLoadingHUDWithMessage:nil];
    [OneLogin preGetTokenWithCompletion:^(NSDictionary * _Nonnull preResult) {
        [GTProgressHUD hideAllHUD];
        NSLog(@"preGetTokenWithCompletion result: %@", preResult);
        if (preResult.count > 0 && preResult[@"status"] && 200 == [preResult[@"status"] integerValue]) {
            [OneLogin requestTokenWithViewController:wself viewModel:viewModel completion:^(NSDictionary * _Nullable result) {
                NSLog(@"requestTokenWithViewController result: %@", result);
                // 自定义授权页面点击登录按钮之后的loading时，调用此方法会触发stopLoadingViewBlock回调，可以在此回调中停止自定义的loading
                [OneLogin stopLoading];
                [wself finishRequestingToken:result];
            }];
        } else {    // 预取号失败
            [GTProgressHUD showToastWithMessage:preResult[@"msg"]?:@"预取号失败"];
        }
    }];
}

/**
 分别设置预取号和取号请求超时时长。默认时长8s。

 @param preGetTokenTimeout 预取号超时时长
 @param requestTokenTimeout 取号超时时长
 */
+ (void)setRequestTimeout:(NSTimeInterval)preGetTokenTimeout requestTokenTimeout:(NSTimeInterval)requestTokenTimeout;

/**
 /**
  @abstract 设置服务条款左边复选框勾选状态
  @param isChecked 是否勾选
 */
+ (void)setProtocolCheckState:(BOOL)isChecked;

/**
 * @abstract 开始取号
 */
+ (void)startRequestToken;