跳到主要内容

入门指引

警告

自建账号适用于2023年及之前接入的业务，新业务仅可接入 LI PASS。更多信息，请参见 LEVEL INFINITE PASS。

开始前​

  1. 在 Player Network 控制台配置您的游戏应用
  2. 接入 SDK

步骤1：在 SDK 中配置自建账号​

打开项目的 INTLConfig.ini 文件，并添加以下配置：

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

LoginWithVerifyCode 不需要玩家设置用户资料或密码即可成功注册。如果未提供密码，并且玩家希望之后使用密码登录，则需要通过 ResetPasswordWithVerifyCode设置有效密码。如果该账号已经被注册，LoginWithVerifyCode 只会登录该账号。

注意

申请验证码时，验证码 CodeType 应为 2，即注册并登录的验证码类别。

登录​

已注册的用户可以通过验证码登录。如果设置了密码，用户也可以使用密码登录。

LoginWithPassword​

玩家无需请求验证码，玩家使用账号和密码登录。

在调用 LoginWithPassword 之前，请确保已经调用 SetAccountInfo 来设置登录渠道信息。

LoginWithVerifyCode (登录)​

登录流程是 注册 中所示流程的一部分。如果账号已被注册，玩家只需登录，则也可以请求 RequestVerifyCode 的 CodeType=2 的验证码，即注册并登录的验证码类别。在登录时，用户提供的密码将被忽略。

最后于 更新