iOS client integration

Download the SDK

Log on to the Phone Number Verification Service console. On the Overview page, find the API & SDK section on the right and click Download Now. Follow the on-screen instructions to download the required SDK.

Authentication scheme

For more information, see Create an authentication scheme and obtain the scheme Code.

Interaction flow

For details, see one-click logon interaction process.

SDK methods

Get shared instance (sharedInstance)

/**
 * Returns the singleton instance.
 */
+ (instancetype _Nonnull )sharedInstance;

Example

TXCommonHandler *handler = [TXCommonHandler sharedInstance];

Required: Set SDK key (setAuthSDKInfo)

/**
 *  Initializes the SDK. Call this method only once during the app's lifecycle.
 *  @param  info The key for your app.
 *  @param  complete An asynchronous callback that executes on the main thread. On success, the `resultDic` is @{resultCode:600000, msg:...}. For other `resultCode` values, refer to `PNSReturnCode`.
 */
- (void)setAuthSDKInfo:(NSString * _Nonnull)info complete:(void(^_Nullable)(NSDictionary * _Nonnull resultDic))complete;

Example

    [[TXCommonHandler sharedInstance] setAuthSDKInfo:@"xxxx"
        complete:^(NSDictionary * _Nonnull resultDic) {
        NSLog(@"setAuthSDKInfo result: %@", resultDic);
    }];

Get one-click login token (getLoginTokenWithTimeout)

/**
 *  Gets a token for one-click login. This API presents an authorization page and returns a token after the user taps the login button.
 *  @warning If the `accelerateLoginPageWithTimeout:complete:` API was not previously called, this API calls it internally. The authorization page is presented only after this pre-warming call succeeds, which can cause a noticeable delay.
 *  @param  timeout The API timeout in seconds. The default value is 3.0.
 *  @param  controller The controller that presents the custom authorization page. The SDK validates this controller to ensure it meets requirements.
 *  @param  model A model object for customizing the authorization page. If `nil`, the SDK uses the default authorization page. For details, see the `TXCustomModel.h` file.
 *  @param  complete An asynchronous callback executed on the main thread. For information about the `resultCode` value in `resultDic`, see `PNSReturnCode`. Possible codes include:
 *
 *          Authorization page UI events:
 *          - 700000: The user taps the back button.
 *          - 700001: The user taps the button to switch to a different login method.
 *          - 700002: The user taps the login button. The `isChecked` field in the returned dictionary indicates whether the checkbox is selected. A token is retrieved only when this value is true.
 *          - 700003: The user taps the checkbox.
 *          - 700004: The user taps the agreement's rich text.
 *
 *          Other API callback events:
 *          - 600001: Authorization page presented successfully.
 *          - 600002: Failed to present authorization page.
 *          - 600000: Token retrieved successfully.
 *          - 600011: Failed to retrieve token.
 *          - 600015: Token retrieval timed out.
 *          - 600013: Service unavailable due to carrier maintenance or an upgrade.
 *          - 600014: Call limit reached due to carrier maintenance or an upgrade.
 */
- (void)getLoginTokenWithTimeout:(NSTimeInterval)timeout controller:(UIViewController *_Nonnull)controller model:(TXCustomModel *_Nullable)model complete:(void (^_Nullable)(NSDictionary * _Nonnull resultDic))complete;

Example

  [[TXCommonHandler sharedInstance] getLoginTokenWithTimeout:3.0
                                                    controller:self
                                                         model:model
                                                      complete:^(NSDictionary * _Nonnull resultDic) {
                                                      NSLog(@"One-click login result: %@", resultDic);
                                                      }];

Cancel login (cancelLoginVCAnimated)

/**
 *  Dismisses the authorization page. Use this method to ensure that SIM card authorization data is cleared upon dismissal.
 *  @param flag Specifies whether to use an animation.
 *  @param complete The callback executed after the page is dismissed.
 */
- (void)cancelLoginVCAnimated:(BOOL)flag complete:(void (^_Nullable)(void))complete;

Examples

  [[TXCommonHandler sharedInstance] cancelLoginVCAnimated:YES complete:nil];

Pre-fetching for one-click login (accelerateLoginPageWithTimeout)

/**
 *  Accelerates the presentation of the one-click login authorization page to prevent long delays when calling methods like `getLoginTokenWithTimeout:controller:model:complete:`.
 *  @param  timeout The timeout for the API call, in seconds. The default value is 3.0.
 *  @param  complete An asynchronous callback executed on the main thread. On success, the `resultDic` is `@{resultCode:600000, msg:...}`. For other `resultCode` values, see `PNSReturnCode`.
 */
- (void)accelerateLoginPageWithTimeout:(NSTimeInterval)timeout complete:(void (^_Nullable)(NSDictionary * _Nonnull resultDic))complete;

Usage example

    [[TXCommonHandler sharedInstance] accelerateLoginPageWithTimeout:3.0 complete:^(NSDictionary * _Nonnull resultDic) {
        NSLog(@"Pre-accelerating the authorization page launch. Acceleration result: %@", resultDic);
    }];

/**
 *  Returns the current SDK version number.
 *  @return The SDK version number.
 */
- (NSString *_Nonnull)getVersion;

NSString *version = [[TXCommonHandler sharedInstance] getVersion];

/**
 *  Checks whether the current environment supports one-click login or phone number authentication. A `PNSCodeSuccess` result indicates that the environment is supported.
 *  @param  authType The service type. `PNSAuthTypeVerifyToken` for the local phone number verification flow, `PNSAuthTypeLoginToken` for the one-click login flow.
 *  @param  complete An asynchronous callback that runs on the main thread. On success, `resultDic` contains @{resultCode:600000, msg:...}. For other "resultCode" values, see PNSReturnCode. Ensure this check succeeds before making other API calls.
 */
- (void)checkEnvAvailableWithAuthType:(PNSAuthType)authType complete:(void (^_Nullable)(NSDictionary * _Nullable resultDic))complete;

[[TXCommonHandler sharedInstance] checkEnvAvailableWithAuthType:PNSAuthTypeVerifyToken complete:^(NSDictionary * _Nullable resultDic) {
        NSLog(@"Environment check result: %@",resultDic);
}];

/**
 *  Sets the checked state of the checkbox after the authorization page is displayed. This setting has no effect if the checkbox is hidden.
 */
- (void)setCheckboxIsChecked:(BOOL)isChecked;

[[TXCommonHandler sharedInstance] setCheckboxIsChecked:YES];

/**
 *  By default, the loading animation is hidden automatically. Call this method to hide it manually if you set the `autoHideLoginLoading` property of the `TXCustomModel` instance to `NO`.
 */
- (void)hideLoginLoading;

[[TXCommonHandler sharedInstance] hideLoginLoading];

/**
 * Closes the privacy alert.
 */
- (void)closePrivactAlertView;

[[TXCommonHandler sharedInstance] closePrivactAlertView];

// Step 1: Create a dynamic UIColor that adapts to the system's appearance mode.
UIColor *buttonColor = [[UIColor alloc] initWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * 
    _Nonnull traitCollection) {
    if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
        return [UIColor redColor]; // Color for dark mode
    } else {
        return [UIColor blueColor]; // Color for light mode
    }
}];
// Step 2: Create an attributed string using the dynamic color for the button text.
NSDictionary *buttonAttributes = @{
    NSForegroundColorAttributeName : buttonColor, // Use the dynamic color
    NSFontAttributeName : [UIFont systemFontOfSize:20.0] // Set the font size
};
model.loginBtnText = [[NSAttributedString alloc] initWithString:@"One-click login button test"
                                                     attributes:buttonAttributes];

/**
 *  Gets the reporter object for managing logs and tracking.
 */
- (PNSReporter * _Nonnull)getReporter;

PNSReporter *reporter = [[TXCommonHandler sharedInstance] getReporter];

/**
 *  Toggles console log output. If enabled, logs prefixed with `PNS_LOGGER` are printed to the console. Important: Disable this in release mode.
 *  @param enable Specifies whether to enable console logging. Defaults to `NO`.
 */
- (void)setConsolePrintLoggerEnable:(BOOL)enable;

PNSReporter *reporter = [[TXCommonHandler sharedInstance] getReporter];
[reporter setConsolePrintLoggerEnable:YES];

/**
 *  Enables or disables log and tracking data uploads. This does not affect custom upload methods implemented with the `setupUploader:` method.
 *  @param  enable Specifies whether to enable uploads. Defaults to `YES`.
 */
- (void)setUploadEnable:(BOOL)enable;

PNSReporter *reporter = [[TXCommonHandler sharedInstance] getReporter];
[reporter setUploadEnable:YES];

/**
 Checks if the device's cellular data network (e.g., 3G or 4G) is enabled.
 @return YES if the cellular data network is enabled; otherwise, NO.
 */
+ (BOOL)checkDeviceCellularDataEnable;

/**
Checks if the carrier of the current SIM card is China Unicom.
@return YES if the carrier is China Unicom; otherwise, NO.
*/
+ (BOOL)isChinaUnicom;

/**
Checks if the carrier of the current SIM card is China Mobile.
@return YES if the carrier is China Mobile; otherwise, NO.
*/
+ (BOOL)isChinaMobile;

/**
Checks if the carrier of the current SIM card is China Telecom.
@return YES if the carrier is China Telecom; otherwise, NO.
*/
+ (BOOL)isChinaTelecom;

/**
Gets the name of the current SIM card's carrier, such as China Mobile, China Telecom, or China Unicom.
@return The name of the carrier.
*/
+ (NSString *)getCurrentCarrierName;

/**
Gets the current network type, such as Wi-Fi or 4G.
@return The current network type.
*/
+ (NSString *)getNetworktype;

/**
Checks if the current device has a SIM card.
@return YES if the device has a SIM card; otherwise, NO.
*/
+ (BOOL)simSupportedIsOK;

/**
 Checks if the cellular network is enabled. This is determined by checking the p0 network interface and works both with and without a Wi-Fi connection.
 @return YES if the cellular network is enabled; otherwise, NO.
 */
+ (BOOL)isWWANOpen;

/**
 Checks if the device is connected to a cellular network and not to Wi-Fi.
 @return YES if connected via a cellular network and not Wi-Fi; otherwise, NO.
 */
+ (BOOL)reachableViaWWAN;

/**
 Gets the device's current private IP address.
 @return The private IP address, or `nil` if not available.
 */
+ (NSString *)getMobilePrivateIPAddress:(BOOL)preferIPv4;

/**
 Gets the unique identifier for the current device. This is used for precise lookups in tracking points.
 @return The unique identifier for the device.
 */
+ (NSString *)getUniqueID;

/**
Generates an image from a color. Supports setting a corner radius, for example, for a one-click login button's background image.
@param color The color of the image.
@param size The size of the image.
@param isRounded YES to apply a corner radius; otherwise, NO.
@param radius The corner radius value.
@return The generated image.
*/
+ (UIImage *)imageWithColor:(UIColor *)color size:(CGSize)size isRoundedCorner:(BOOL )isRounded radius:(CGFloat)radius;

UI page API

Full-screen authorization page

Pop-up authorization page

For the design of other sections, refer to the Full-screen Authorization Page Design Specification.

Authorization page

// 1. Set the SDK parameters. Call only once during the app lifecycle.
NSString *info = @"Your secret key string";
__weak typeof(self) weakSelf = self;
// Set the SDK parameters. Call only once during the app lifecycle.
[[TXCommonHandler sharedInstance] setAuthSDKInfo:info complete:^(NSDictionary * _Nonnull resultDic) {
    [weakSelf showResult:resultDic];
}];
// 2. Check if the current environment supports one-click login.
__block BOOL support = YES;
[[TXCommonHandler sharedInstance] checkEnvAvailableWithAuthType:PNSAuthTypeLoginToken complete:^(NSDictionary * _Nullable resultDic) {
    support = [PNSCodeSuccess isEqualToString:[resultDic objectForKey:@"resultCode"]];
}];	
// 3. Start the one-click login flow.
// 3.1 Accelerate authorization page launch by pre-fetching parameters.
[[TXCommonHandler sharedInstance] accelerateLoginPageWithTimeout:timeout complete:^(NSDictionary * _Nonnull resultDic) {
    if ([PNSCodeSuccess isEqualToString:[resultDic objectForKey:@"resultCode"]] == NO) {
        [ProgressHUD showError:@"Failed to accelerate the authorization page."];
        [weakSelf showResult:resultDic];
        return ;
    }
    // 3.2 Get the login token to present the authorization page. The model must be created on the main thread.
    [ProgressHUD dismiss];
    [[TXCommonHandler sharedInstance] getLoginTokenWithTimeout:timeout controller:weakSelf model:model complete:^(NSDictionary * _Nonnull resultDic) {
        NSString *code = [resultDic objectForKey:@"resultCode"];
        if ([PNSCodeLoginControllerPresentSuccess isEqualToString:code]) {
            [ProgressHUD showSuccess:@"Presented the authorization page successfully."];
        } else if ([PNSCodeLoginControllerClickCancel isEqualToString:code]) {
            [ProgressHUD showSuccess:@"Tapped Cancel on the authorization page."];
        } else if ([PNSCodeLoginControllerClickChangeBtn isEqualToString:code]) {
            [ProgressHUD showSuccess:@"Tapped the button to switch to other login methods."];
        } else if ([PNSCodeLoginControllerClickLoginBtn isEqualToString:code]) {
            if ([[resultDic objectForKey:@"isChecked"] boolValue] == YES) {
                [ProgressHUD showSuccess:@"Tapped the login button with the checkbox selected. The SDK will proceed to get the login token."];
            } else {
                [ProgressHUD showSuccess:@"Tapped the login button with the checkbox deselected. The SDK will not get the login token."];
            }
        } else if ([PNSCodeLoginControllerClickCheckBoxBtn isEqualToString:code]) {
            [ProgressHUD showSuccess:@"Tapped the checkbox."];
        } else if ([PNSCodeLoginControllerClickProtocol isEqualToString:code]) {
            [ProgressHUD showSuccess:@"Tapped the agreement."];
        } else if ([PNSCodeSuccess isEqualToString:code]) {
            // Callback for successful login token retrieval when the login button is tapped.
            NSString *token = [resultDic objectForKey:@"token"];
            // The following code exchanges the token for a mobile number on your server. For reference only.
            [PNSVerifyTopRequest requestLoginWithToken:token complete:^(BOOL isSuccess, NSString * _Nonnull msg, NSDictionary * _Nonnull data) {
                NSString *popCode = [data objectForKey:@"code"];
                NSDictionary *module = [data objectForKey:@"module"];
                NSString *mobile = module[@"mobile"];
                if ([popCode isEqualToString:@"OK"] && mobile.length > 0) {
                    [ProgressHUD showSuccess:@"One-click login successful."];
                } else {
                    [ProgressHUD showSuccess:@"One-click login failed."];
                }
                dispatch_async(dispatch_get_main_queue(), ^{
                    [[TXCommonHandler sharedInstance] cancelLoginVCAnimated:YES complete:nil];
                });
                [weakSelf showResult:data];
            }];
        } else {
            [ProgressHUD showError:@"Failed to get the login token."];
        }
        [weakSelf showResult:resultDic];
    }];
}];

Authorization page: Full-screen mode

Supports screen rotation.

TXCustomModel *model = [[TXCustomModel alloc] init];
model.navColor = UIColor.orangeColor;
model.navTitle = [[NSAttributedString alloc] initWithString:@"one-click login (full screen)" attributes:@{NSForegroundColorAttributeName : UIColor.whiteColor,NSFontAttributeName : [UIFont systemFontOfSize:20.0]}];
//model.navIsHidden = NO;
model.navBackImage = [UIImage imageNamed:@"icon_nav_back_light"];
//model.hideNavBackItem = NO;
UIButton *rightBtn = [UIButton buttonWithType:UIButtonTypeSystem];
[rightBtn setTitle:@"More" forState:UIControlStateNormal];
model.navMoreView = rightBtn;
model.privacyNavColor = UIColor.orangeColor;
model.privacyNavBackImage = [UIImage imageNamed:@"icon_nav_back_light"];
model.privacyNavTitleFont = [UIFont systemFontOfSize:20.0];
model.privacyNavTitleColor = UIColor.whiteColor;
model.logoImage = [UIImage imageNamed:@"taobao"];
//model.logoIsHidden = NO;
//model.sloganIsHidden = NO;
model.sloganText = [[NSAttributedString alloc] initWithString:@"one-click login slogan" attributes:@{NSForegroundColorAttributeName : UIColor.orangeColor,NSFontAttributeName : [UIFont systemFontOfSize:16.0]}];
model.numberColor = UIColor.orangeColor;
model.numberFont = [UIFont systemFontOfSize:30.0];
model.loginBtnText = [[NSAttributedString alloc] initWithString:@"one-click login" attributes:@{NSForegroundColorAttributeName : UIColor.whiteColor,NSFontAttributeName : [UIFont systemFontOfSize:20.0]}];
//model.autoHideLoginLoading = NO;
//model.privacyOne = @[@"Privacy 1",@"https://www.taobao.com/"];
//model.privacyTwo = @[@"Privacy 2",@"https://www.taobao.com/"];
model.privacyColors = @[UIColor.lightGrayColor, UIColor.orangeColor];
model.privacyAlignment = NSTextAlignmentCenter;
model.privacyFont = [UIFont fontWithName:@"PingFangSC-Regular" size:13.0];
model.privacyOperatorPreText = @"《";
model.privacyOperatorSufText = @"》";
//model.checkBoxIsHidden = NO;
model.checkBoxWH = 17.0;
model.changeBtnTitle = [[NSAttributedString alloc] initWithString:@"Switch to other methods" attributes:@{NSForegroundColorAttributeName : UIColor.orangeColor,NSFontAttributeName : [UIFont systemFontOfSize:18.0]}];
//model.changeBtnIsHidden = NO;
//model.prefersStatusBarHidden = NO;
model.preferredStatusBarStyle = UIStatusBarStyleLightContent;
//model.presentDirection = PNSPresentationDirectionBottom;
// Customize the layout of default controls on the authorization page.
//model.navBackButtonFrameBlock =
//model.navTitleFrameBlock =
model.navMoreViewFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    CGFloat width = superViewSize.height;
    CGFloat height = width;
    return CGRectMake(superViewSize.width - 15 - width, 0, width, height);
};
model.loginBtnFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        frame.origin.y = 20;
        return frame;
    }
    return frame;
};
model.sloganFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        return CGRectZero; // Hide the control in landscape mode.
    } else {
        return CGRectMake(0, 140, superViewSize.width, frame.size.height);
    }
};
model.numberFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        frame.origin.y = 140;
    }
    return frame;
};
model.loginBtnFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        frame.origin.y = 185;
    }
    return frame;
};
model.changeBtnFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        return CGRectZero; // Hide the control in landscape mode.
    } else {
        return CGRectMake(10, frame.origin.y, superViewSize.width - 20, 30);
    }
};
//model.privacyFrameBlock =
// Add a custom control and configure its layout.
__block UIButton *customBtn = [UIButton buttonWithType:UIButtonTypeCustom];
[customBtn setTitle:@"This is a custom control" forState:UIControlStateNormal];
[customBtn setBackgroundColor:UIColor.redColor];
customBtn.frame = CGRectMake(0, 0, 230, 40);
model.customViewBlock = ^(UIView * _Nonnull superCustomView) {
    [superCustomView addSubview:customBtn];
};
model.customViewLayoutBlock = ^(CGSize screenSize, CGRect contentViewFrame, CGRect navFrame, CGRect titleBarFrame, CGRect logoFrame, CGRect sloganFrame, CGRect numberFrame, CGRect loginFrame, CGRect changeBtnFrame, CGRect privacyFrame) {
    CGRect frame = customBtn.frame;
    frame.origin.x = (contentViewFrame.size.width - frame.size.width) * 0.5;
    frame.origin.y = CGRectGetMinY(privacyFrame) - frame.size.height - 20;
    frame.size.width = contentViewFrame.size.width - frame.origin.x * 2;
    customBtn.frame = frame;
};
// Support all interface orientations except upside-down.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskAllButUpsideDown;
// Restrict to portrait orientation.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskPortrait;
// Restrict to landscape orientation.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskLandscape;

Secondary pop-up window in full-screen mode

 TXCustomModel *model = [[TXCustomModel alloc] init];
    model.supportedInterfaceOrientations = UIInterfaceOrientationMaskPortrait;
    model.navColor = [UIColor orangeColor];
    NSDictionary *attributes = @{
        NSForegroundColorAttributeName : [UIColor whiteColor],
        NSFontAttributeName : [UIFont systemFontOfSize:20.0]
    };
    model.navTitle = [[NSAttributedString alloc] initWithString:@"one-tap login" attributes:attributes];
    model.navBackImage = [UIImage imageNamed:@"icon_nav_back_light"];
    model.logoImage = [UIImage imageNamed:@"taobao"];
    model.changeBtnIsHidden = YES;
    model.privacyOne = @[@"agreement 1", @"https://www.taobao.com"];
    UIButton *button1 = [UIButton buttonWithType:UIButtonTypeSystem];
    [button1 setTitle:button1Title forState:UIControlStateNormal];
    [button1 addTarget:target1 action:selector1 forControlEvents:UIControlEventTouchUpInside];
    UIButton *button2 = [UIButton buttonWithType:UIButtonTypeSystem];
    [button2 setTitle:button2Title forState:UIControlStateNormal];
    [button2 addTarget:target2 action:selector2 forControlEvents:UIControlEventTouchUpInside];
    model.privacyAlignment = NSTextAlignmentRight;
    model.customViewBlock = ^(UIView * _Nonnull superCustomView) {
        [superCustomView addSubview:button1];
        [superCustomView addSubview:button2];
    };
    model.customViewLayoutBlock = ^(CGSize screenSize, CGRect contentViewFrame, CGRect navFrame, CGRect titleBarFrame, CGRect logoFrame, CGRect sloganFrame, CGRect numberFrame, CGRect loginFrame, CGRect changeBtnFrame, CGRect privacyFrame) {
        button1.frame = CGRectMake(CGRectGetMinX(loginFrame),
                                   CGRectGetMaxY(loginFrame) + 20,
                                   CGRectGetWidth(loginFrame),
                                   30);
        button2.frame = CGRectMake(CGRectGetMinX(loginFrame),
                                   CGRectGetMaxY(button1.frame) + 15,
                                   CGRectGetWidth(loginFrame),
                                   30);
    };
    model.privacyAlertIsNeedShow = YES;
    model.privacyAlertMaskAlpha = 0.5;
    model.privacyAlertMaskColor = UIColor.blackColor;
    model.privacyAlertCornerRadiusArray = @[@10,@10,@10,@10];
    model.privacyAlertBackgroundColor = UIColor.whiteColor;
    model.privacyAlertAlpha = 1.0;
    model.privacyAlertTitleBackgroundColor = UIColor.whiteColor;
    model.privacyAlertContentBackgroundColor = UIColor.whiteColor;
    model.privacyAlertTitleFont = [UIFont systemFontOfSize:16];
    model.privacyAlertTitleColor = UIColor.blackColor;
    model.privacyAlertContentColors = @[UIColor.grayColor, UIColor.orangeColor];
    model.privacyAlertContentAlignment = NSTextAlignmentCenter;
    UIImage *activeImage = [TXCommonUtils imageWithColor:UIColor.orangeColor size:CGSizeMake(UIScreen.mainScreen.bounds.size.width - 2 * 18, 50) isRoundedCorner:YES radius:10];
    UIImage *hightLightImage = [TXCommonUtils imageWithColor:UIColor.grayColor size:CGSizeMake(UIScreen.mainScreen.bounds.size.width - 2 * 18, 50) isRoundedCorner:YES radius:10];
    model.privacyAlertBtnBackgroundImages = @[activeImage, hightLightImage];
    model.privacyAlertButtonTextColors = @[UIColor.whiteColor,UIColor.blueColor];
    model.privacyAlertButtonFont = [UIFont systemFontOfSize:18];
    model.privacyAlertCloseButtonIsNeedShow = YES;
    model.privacyAlertMaskIsNeedShow = YES;
    model.privacyAlertIsNeedAutoLogin = NO;
    model.tapPrivacyAlertMaskCloseAlert = NO;
    model.expandAuthPageCheckedScope = YES;
    model.privacyAlertCloseButtonIsNeedShow = YES;
    model.privacyAlertTitleFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
        return CGRectMake(0, 20, frame.size.width, frame.size.height);
    };
    model.privacyAlertPrivacyContentFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
        return CGRectMake(0, frame.origin.y+10, frame.size.width, frame.size.height);
    };
    model.privacyAlertButtonFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
        return CGRectMake(frame.origin.x,superViewSize.height - 50 - 20, frame.size.width, 50);;
    };
    model.privacyAlertFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
        return CGRectMake(40, (superViewSize.height - 150)*0.5, screenSize.width-80, 150);
    };

Authorization page in popup mode

Screen rotation is supported.

TXCustomModel *model = [[TXCustomModel alloc] init];
model.alertCornerRadiusArray = @[@10, @10, @10, @10];
//model.alertCloseItemIsHidden = YES;
model.alertTitleBarColor = UIColor.orangeColor;
model.alertTitle = [[NSAttributedString alloc] initWithString:@"One-click Login (Alert)" attributes:@{NSForegroundColorAttributeName : UIColor.whiteColor, NSFontAttributeName : [UIFont systemFontOfSize:20.0]}];
model.alertCloseImage = [UIImage imageNamed:@"icon_close_light"];
model.privacyNavColor = UIColor.orangeColor;
model.privacyNavBackImage = [UIImage imageNamed:@"icon_nav_back_light"];
model.privacyNavTitleFont = [UIFont systemFontOfSize:20.0];
model.privacyNavTitleColor = UIColor.whiteColor;
model.logoImage = [UIImage imageNamed:@"taobao"];
//model.logoIsHidden = NO;
//model.sloganIsHidden = NO;
model.sloganText = [[NSAttributedString alloc] initWithString:@"One-click login slogan" attributes:@{NSForegroundColorAttributeName : UIColor.orangeColor,NSFontAttributeName : [UIFont systemFontOfSize:16.0]}];
model.numberColor = UIColor.orangeColor;
model.numberFont = [UIFont systemFontOfSize:30.0];
model.loginBtnText = [[NSAttributedString alloc] initWithString:@"One-click Login" attributes:@{NSForegroundColorAttributeName : UIColor.whiteColor, NSFontAttributeName : [UIFont systemFontOfSize:20.0]}];
//model.autoHideLoginLoading = NO;
//model.privacyOne = @[@"《Privacy Policy 1》",@"https://www.taobao.com/"];
//model.privacyTwo = @[@"《Privacy Policy 2》",@"https://www.taobao.com/"];
model.privacyColors = @[UIColor.lightGrayColor, UIColor.orangeColor];
model.privacyAlignment = NSTextAlignmentCenter;
model.privacyFont = [UIFont fontWithName:@"PingFangSC-Regular" size:13.0];
model.privacyOperatorPreText = @"《";
model.privacyOperatorSufText = @"》";
//model.checkBoxIsHidden = NO;
model.checkBoxWH = 17.0;
model.changeBtnTitle = [[NSAttributedString alloc] initWithString:@"Switch to another method" attributes:@{NSForegroundColorAttributeName : UIColor.orangeColor,NSFontAttributeName : [UIFont systemFontOfSize:18.0]}];
//model.changeBtnIsHidden = NO;
//model.prefersStatusBarHidden = NO;
//model.preferredStatusBarStyle = UIStatusBarStyleDefault;
//model.presentDirection = PNSPresentationDirectionBottom;
CGFloat ratio = MAX(TX_SCREEN_WIDTH, TX_SCREEN_HEIGHT) / 667.0;
// If this block returns a frame with an x or y coordinate greater than 0, the SDK treats the authorization page as an alert.
model.contentViewFrameBlock = ^CGRect(CGSize screenSize, CGSize contentSize, CGRect frame) {
    CGFloat alertX = 0;
    CGFloat alertY = 0;
    CGFloat alertWidth = 0;
    CGFloat alertHeight = 0;
    if ([self isHorizontal:screenSize]) {
        alertX = ratio * TX_Alert_Horizontal_Default_Left_Padding;
        alertWidth = screenSize.width - alertX * 2;
        alertY = (screenSize.height - alertWidth * 0.5) * 0.5;
        alertHeight = screenSize.height - 2 * alertY;
    } else {
        alertX = TX_Alert_Default_Left_Padding * ratio;
        alertWidth = screenSize.width - alertX * 2;
        alertY = TX_Alert_Default_Top_Padding * ratio;
        alertHeight = screenSize.height - alertY * 2;
    }
    return CGRectMake(alertX, alertY, alertWidth, alertHeight);
};
// Adjust the layout of default controls on the authorization page.
//model.alertTitleBarFrameBlock =
//model.alertTitleFrameBlock =
//model.alertCloseItemFrameBlock =
model.logoFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        return CGRectZero; // Hides this control in landscape mode.
    } else {
        frame.origin.y = 10;
        return frame;
    }
};
model.sloganFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        return CGRectZero; // Hides this control in landscape mode.
    } else {
        frame.origin.y = 110;
        return frame;
    }
};
model.numberFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        frame.origin.y = 20;
        frame.origin.x = (superViewSize.width * 0.5 - frame.size.width) * 0.5 + 18.0;
    } else {
        frame.origin.y = 140;
    }
    return frame;
};
model.loginBtnFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        frame.origin.y = 60;
        frame.size.width = superViewSize.width * 0.5; // The minimum width for the login button is half of its superview's width. Smaller values are ignored.
    } else {
        frame.origin.y = 180;
    }
    return frame;
};
model.changeBtnFrameBlock = ^CGRect(CGSize screenSize, CGSize superViewSize, CGRect frame) {
    if ([self isHorizontal:screenSize]) {
        return CGRectZero; // Hides this control in landscape mode.
    } else {
        return CGRectMake(10, 240, superViewSize.width - 20, 30);
    }
};
//model.privacyFrameBlock =
// Add and configure the layout for a custom control.
__block UIButton *customBtn = [UIButton buttonWithType:UIButtonTypeCustom];
[customBtn setTitle:@"This is a custom control" forState:UIControlStateNormal];
[customBtn setBackgroundColor:UIColor.redColor];
model.customViewBlock = ^(UIView * _Nonnull superCustomView) {
    [superCustomView addSubview:customBtn];
};
model.customViewLayoutBlock = ^(CGSize screenSize, CGRect contentViewFrame, CGRect navFrame, CGRect titleBarFrame, CGRect logoFrame, CGRect sloganFrame, CGRect numberFrame, CGRect loginFrame, CGRect changeBtnFrame, CGRect privacyFrame) {
    CGFloat padding = 15;
    CGFloat x = 0;
    CGFloat y = 0;
    CGFloat width = 0;
    CGFloat height = 0;
    if ([self isHorizontal:screenSize]) {
        x = CGRectGetMaxX(loginFrame) + padding;
        y = padding;
        width = contentViewFrame.size.width - x - padding;
        height = CGRectGetMinY(privacyFrame) - y - padding;
    } else {
        x = padding;
        y = MAX(CGRectGetMaxY(changeBtnFrame), CGRectGetMaxY(loginFrame)) + padding;
        width = contentViewFrame.size.width - 2 * x;
        height = CGRectGetMinY(privacyFrame) - y - padding;
    }
    customBtn.frame = CGRectMake(x, y, width, height);
};
// Support all orientations except upside down.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskAllButUpsideDown;
// Support portrait only.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskPortrait;
// Support landscape only.
model.supportedInterfaceOrientations = UIInterfaceOrientationMaskLandscape;

Privacy policy confirmation

The mobile one-click login screen shows the One-click login title at the top and an "Authentication service provided by China Mobile" label in the center. A modal dialog appears with the title Please read and agree to the following terms. The dialog contains the text "I have read and agree to the China Mobile authentication terms of service and Agreement 1" and an Agree and continue button at the bottom. Behind the dialog, two login options are visible: SMS login (use system navigation bar) and SMS login (hide system navigation bar).

Secondary privacy policy dialog