入门指引
自建账号适用于2023年及之前接入 的业务，新业务仅可接入 LI PASS。更多信息，请参见 LEVEL INFINITE PASS。
开始前
步骤1：在 SDK 中配置自建账号
打开项目的 INTLConfig.ini 文件，并添加以下配置：
[INTL environment]
# WARNING: You should change this URL to the production environment when you release your game.
INTL_URL = https://test.intlgame.com
GAME_ID = {INTL_GAME_ID}
SDK_KEY = {INTL_SDK_KEY}
[INTL Log]
LOG_LEVEL = 1
LOG_CONSOLE_OUTPUT_ENABLE = 1
LOG_FILE_OUTPUT_ENABLE = 1
LOG_ENCRYPT_ENABLE = 0
LOG_COMPRESS_ENABLE = 0
[Android LifeCycle]
LIFECYCLE = QQ
[Custom Account]
ACCOUNT_SDK_KEY = {YOUR_ACCOUNT_SDK_KEY}
ACCOUNT_APP_ID = {YOUR_ACCOUNT_APP_ID}
ACCOUNT_PASSWORD_VALIDATION = 1
- 将 SDK 后台 环境设置为
INTL_URL = https://test.intlgame.com。 - 将
{INTL_GAME_ID}和{INTL_SDK_KEY}替换为 Player Network 控制台 分配的GAME_ID和SDK_KEY的值。 - 将日志相关配置设置为
LOG_LEVEL = 1、LOG_CONSOLE_OUTPUT_ENABLE = 1、LOG_FILE_OUTPUT_ENABLE = 1、LOG_ENCRYPT_ENABLE = 0、和LOG_COMPRESS_ENABLE = 0以便于生成控制台日志并在生存日志文件时不自动加密或压缩。 - 将
{YOUR_ACCOUNT_SDK_KEY}和{YOUR_ACCOUNT_APP_ID}替换为 Player Network 控制台 分配的ACCOUNT_SDK_KEY和ACCOUNT_APP_ID的值。 - 将 替换为 Player Network 控制台分配的 值。
- 将
ACCOUNT_PASSWORD_VALIDATION设置为 1，即代表使用 Player Network SDK 对密码进行校验。默认的密码校验规则是 8-20位，支持的符号包括大小写字母，数字，和部分特殊符号包括!@#$%^&*()+=\-_/?<>,.:;|。
如果游戏有自己的校验需求，需要在ACCOUNT_PASSWORD_VALIDATION中配置 INTLConfig.ini 为 0。这样 Player Network SDK 将不会对密码进行校验，游戏需要在调用接口前自己先做密码校验。
配置多渠道自建账号
通过将渠道 ID 作为后缀，游戏可以配置多个自建账号渠道。当找不到带渠道 ID 后缀的配置时，会使用不带后缀的配置。
例如，游戏 接入了 ChannelID 为 7 和 12 的自建账号渠道，并使用了以下配置：
ACCOUNT_SDK_KEY_7 = {ACCOUNT_SDK_KEY_FOR_7}
ACCOUNT_SDK_KEY_12 = {ACCOUNT_SDK_KEY_FOR_12}
ACCOUNT_PASSWORD_VALIDATION = 1
当用户使用 ChannelID 为 7 的渠道时，会使用 ACCOUNT_SDK_KEY_7 的配置。当用户使用 ChannelID 为 12 的渠道时，会使用 ACCOUNT_SDK_KEY_12 的配置。
因为没有为 7 和 12 单独进行 ACCOUNT_PASSWORD_VALIDATION 的配置，查看是否需要校验密码时，会使用 ACCOUNT_PASSWORD_VALIDATION 的配置。
步骤2：实现自建账号登录
在调用与自建账号相关的功能之前，请调用 SetAccountInfo 来设置登录渠道信息。
注册账号
Player Network SDK 提供两种账号注册方法：Register 与 LoginWithVerifyCode。
注册
Register 允许玩家在注册的同时设置用户资料。建议在调用 Register 之前，先检查账号是否已经注册。
申请验证码时，验证码 CodeType 应为 0，即注册的验证码类别。
LoginWithVerifyCode（注册）
LoginWithVerifyCode 不需要玩家设置用户资料或密码即可成功注册。如果未提供密码，并且玩家希望之后使用密码登录，则需要通过 ResetPasswordWithVerifyCode设置有效密码。如果该账号已经被注册，LoginWithVerifyCode 只会登录该账号。
申请验证码时，验证码 CodeType 应为 2，即注册并登录的验证码类别。
登录
已注册的用户可以通过验证码登录。如果设置了密码，用户也可以使用密码登录。
LoginWithPassword
玩家无需请求验证码，玩家使用账号和密码登录。
在调用 LoginWithPassword 之前，请确保已经调用 SetAccountInfo 来设置登录渠道信息。
LoginWithVerifyCode (登录)
登录流程是 注册 中所示流程的一部分。如果账号已被注册，玩家只需登录，则也可以请求 RequestVerifyCode 的 CodeType=2 的验证码，即注册并登录的验证码类别。在登录时，用户提供的密码将被忽略。