Skip to main content

Login Configuration

Developers can utilize the LI PASS interface to manage various aspects of player accounts. This includes handling the login panel, which is responsible for player registration, login, and logout.

Login panel for client​

LI PASS provides two distinct methods for the login panel, each designed to support different scenarios. The OpenLoginPanel method is designed for mobile games as well as Windows games that have their own launcher. The LoginChannelWithLIPass method is designed for console games like PS5 and Xbox, and for Windows games released on Steam and Epic. The following sections will introduce these methods and explain their implementation.

OpenLoginPanel​

This method is suitable for games released on mobile platforms, specifically iOS and Android, as well as Windows games that have their own standalone launchers. It equips games with the ability to facilitate player login via LI PASS and more than 30 other identity providers.

Image: LI PASS Login Flow

Call the LI PASS AutoLogin method to authenticate players using the authentication state stored in the local cache. If auto-login is successful, the player will proceed into the game. However, if it fails, developers should call the OpenLoginPanel function to launch the LI PASS login panel. This feature manages LI PASS registration, login, and the compliance workflow.

Include the following code in the AuthResultObserver callback to handle auto-login outcomes.

if (AuthResult.MethodId == (int)INTLMethodID.LI_AUTOLOGIN_ENTER_GAME) {
    if(AuthResult.RetCode == (int)ERROR_CODE.SUCCESS) {
        Debug.Log("LI Autologin success");
    } else {
        Debug.Log("LI Autologin failed, ret_code = " + AuthResult.RetCode + ", ret_msg = " + AuthResult.RetMsg);
        LevelInfinite.OpenLoginPanel();
    }
}

This default login panel allows new players to create an LI PASS. They can then choose to use either their LI PASS account and password or their email address along with a verification code to log in to the game. Alternately, they can log in via other identity providers or guest accounts. Furthermore, it also offers a password reset function. This is illustrated in the following image:

Image: LI

For information on customizing the functions of the login panel, see Configure LI PASS.

LoginChannelWithLIPass​

This method is suitable for games released on PS5 and Xbox, as well as Steam and Epic games on Windows platforms. It allows players to link their game accounts to LI PASS, but does not support linking to other third-party identity providers.

The CAPTCHA function in LI PASS is recommended to be disabled for this method, for better compatibility with the platforms. For more information about the CAPTCHA function, see CAPTCHA Configuration.

For console games on PS5 and Xbox, this method displays the LI PASS linking screen with a skip button upon game launch. Players can either link their PS5 or Xbox accounts to LI PASS, or bypass the account linking process.

Image: LI PASS console login with skip button

First-time players who choose to skip this process will see a popup reminding them to link their LI PASS. They can either continue to link an LI PASS or close the page to enter the game. Players who close the page can still link an LI PASS via the Account Center at a later stage.

Image: LI PASS console login popup after skip linking

Call the LI PASS LoginChannelWithLIPass method to activate the LI PASS login panel. The login channel should be provided as the input parameter. If the current account hasn't been linked to LI PASS and it's the player's first time entering the game, the login panel will display the user interface for LI PASS linking.

LevelInfinite.LoginChannelWithLIPass(INTLChannel.Xbox);
Image: LI PASS Login Flow

For information on customizing the functions of the login panel in Player Network Console, see Configure LI PASS.

Passkey​

note

This feature is supported in Player Network SDK V1.27 or later.

Configure PASSKEY_ENABLE in the INI file to toggle on Passkey.
For details about the configuration results, see Login Sample.

Web widget​

Games can configure login and registration settings for Web through Player Network Console.
For details about the configuration results, see Login Sample.

Registration​

note

Automatic registration is uncommon, please enable it according to your needs.

Auto and manual registration are available as registration methods, where the information required can be customized for manual registration.

Generally, the fewer details required for registration, the shorter the registration process for players, but attention should be paid to legal requirements regarding account registration information on your webpage. Registration information that can be customized include:

  • Country/region
  • LI PASS agreements
  • Game agreements
  • Adult status
  • Password
note

You may modify the login method, registration information, or other configurations at any time. Here are some possible scenarios:

  • In your game/platform, users used to register accounts by only verifying their email, but now you want users to provide more information for account registration.
  • Other games/platforms do not match your configuration, and users may not have filled out the information you require during registration in those other games/platforms.

To ensure consistency of user information across your game/platform, when users log in, the component will check if there is any missing information based on your latest configuration. If so, a popup will prompt users to provide the required information.

Login​

The Web widget supports player login through a game account, email verification code, or third-party channels.

For third-party channel login, the display order of the channels will be consistent with the configuration order in Player Network Console. When the number of channels exceeds five, the first five channels will be shown directly on the login screen, and the subsequent channels will appear in an extended screen.

The supported third-party channels include:

  • Facebook
  • Twitter
  • Google
  • Apple
  • Line
  • Steam
  • Epic
  • Vk
  • Discord
  • Twitch
  • PS5
  • Xbox
  • QQ
  • WeChat
note

Third-party channel accounts will be displayed as secondary login channels in the lower part of the widget, and the layout cannot be swapped with LI PASS.

Last updated on