入门指引

LEVEL INFINITE PASS 资源可以帮助业务屏蔽底层账号认证的实现细节，同时也包括繁琐的 UI 开发。业务可以使用 LEVEL INFINITE PASS 统一的登录能力快速并安全地上线。

根据本文中的步骤接入 LEVEL INFINITE PASS 后，游戏只需几行代码即可支持 LEVEL INFINITE PASS 和其他第三方身份供应商（本文中称为 "渠道"）的身份验证功能。

前提条件

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

使用登录组件完成客户端登录流程

步骤1：导入 LI PASS 插件

Unity

引擎版本支持

SDK 1.27 及之后版本

Unity 2021 ~ Unity 6

SDK 1.24 ~ 1.26

Unity 2021 ~ Unity 2022

SDK 1.24 之前版本

Unity 2018 ~ Unity 2022

注意

目录 StreamingAssets/LevelInfinite 使用于 Player Network SDK V1.20.01 及以上版本，目录 StreamingAssets/INTLGameNative 使用于 Player Network SDK V1.20.00 及以下版本。

1. 将 LevelInfinite、Plugins 和 StreamingAssets/LevelInfinite 文件夹复制到游戏项目的 Assets 目录后，再使用 Unity 导入。

   

   文件夹	说明
   LevelInfinite	LI PASS 引擎层代码
   Plugins	LI PASS 平台层库文件
   StreamingAssets/LevelInfinite	LI PASS 业务逻辑资源，可热更

2. [可选] 从项目中移除程序集。

LI PASS 从 V1.08 版本开始支持程序集。如果项目不支持程序集，请执行以下步骤来移除：

1. 删除以下程序集定义文件。
2. 修改 luaSvr.cs，将程序集名从 LevelInfinite 换成 Assembly-CSharp。
3. 联系 Player Network 助手获取不带程序集的 AssetBundle 包。

3. 在 Unity 菜单栏，选择 INTLLua > All > Clear 删除 Assets/LevelInfinite/Runtime/INTLGameNative/Scripts/LuaObject 目录。
   如果删除成功，则自动弹窗提示生成 Unity 的 Lua 接口。如未弹窗，在 Unity 菜单栏选择 INTL > INTLLua > All > Make 来手动触发弹窗。

   

4. 在弹窗中，点击 Generate 生成 C# 导出到 Lua 的接口。

   

5. 在 Assets/LevelInfinite/Runtime/INTLGameNative/Scripts/LuaObject 目录中查看接口导出文件是否成功生成。

   

   注意

   存在 Custom 和 Unity 文件夹代表接口文件生成成功。

   • Custom 文件夹：自定义类接口导出到 Lua。
   • Unity 文件夹：Unity 引擎类接口导出到 Lua。

6. [可选] 切换加载方式。

加载方式默认为 Editor 模式，用于在编辑器中正常跑通 LI PASS 流程。业务可选择在开发时，通过在菜单栏 LevelInfinite > AssetLoadMode 中选择对应的加载方式，将加载方式切换成 StreamingAssets 模式。

加载模式的选择不影响构建发布包的加载模式（默认 CDN）。

选项	说明
Editor	对应 INTL_DEBUG_LUA 宏，读取本地 Lua 文件
StreamingAssets	对应 INTL_USE_LOCAL_ASSETS 宏，加载 StreamingAssets 中的 AssetBundle
CDN	对应 Player Network 控制台 AssetBundle，如果控制台资源加载失败则加载 StreamingAssets 中的 AssetBundle

7. [可选] 完成 Unity 主机游戏的项目配置。

1. 安装并激活 Input System 包：

   注意

   Input System 需要 Unity 2019.1 或更高版本与 .NET Framework 4 运行，不适用于运行 .NET Framework 3.5 的项目。

   在 XSX 真机运行时需匹配 1.6.1 版本的 Input System，同时附带安装 com.unity.inputsystem.gxdk-1.0.1 的拓展包，如果遇到引入问题请联系 Player Network 助手。

   更多详情，请参见 Input System 安装指南.

   1. 从 Unity 的主菜单中，进入 Window > Package Manager 以打开 Unity Package Manager。

   2. 点击 Advanced，确认 Show Preview Packages 已启用。

   3. 从左侧的列表中，选择最新的 Input System 包后，点击 Install。

      

   4. 从 Unity 的主菜单中，进入 Edit > Project Settings后，点击 Player。

   5. 将 Active Input Handling 的值设置为 Input System Package (New)。

      

2. 添加宏定义：

   1. 从 Unity 的主菜单中，进入 Edit > Project Settings 后，点击 Player。

   2. 打开 Other Settings 面板，浏览至 Scripting Define Symbols。

   3. 将 INTL_CONSOLE_GAME_INPUT 添加到文本框中，使用分号分隔。

      

   4. 在 Assets/LevelInfinite 中打开程序集定义文件 LevelInfinite.asmdef，然后在 Assembly Definition References 中添加 Unity.InputSystem。

      

Unreal Engine

引擎版本支持

SDK 1.26 及之后版本

UE4.21 ~ UE4.27 & UE5 ~ UE5.5

SDK 1.26 之前版本

UE4.21 ~ UE4.27 & UE5 ~ UE5.4

1. 将 LevelInfinite 文件夹拷贝至目标项目的 Plugins 文件夹中。如果项目没有 Plugins 文件夹，请创建一个。

   警告

   在 Cook 的时候如果报错 LongPackageNameToFilename failed to convert '/LevelInfinite'. Path does not map to any roots，需要修改 Cook 的路径 /LevelInfinite -> /LevelInfinite/，一般常出现在低于 UE4.27 版本。

   注意

   在 LI PASS V1.16 之前的版本，LI PASS 插件必须要放到 Plugins/LevelInfinite 目录中。如果业务要自定义路径，要对应修改 PLUGIN_LI_CONTENT_PATH、LI_LUA_BASE_PATH 和 FRAME_LUA_BASE_PATH 变量并重新编译。
   在 LI PASS V1.16 或之后的版本，LI PASS 插件自动根据业务配置的自定义路径，动态加载资源文件。

   说明

   LevelInfiniteAssetVersion.lua 的文件拓展名为 LUA 而并非 LUAC，是因为里面包含了 LI PASS 的版本号，方便业务同学了解我们的 LI PASS 版本，便于定位问题。

2. 打开游戏模块的构建文件，即 {项目名}.Build.cs 文件，并按照示例将 LevelInfinite 插件添加为模块的私有依赖：

   public INTLSample(ReadOnlyTargetRules Target) : base(Target)
   {
       PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
   
       PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore", "HeadMountedDisplay" });
   
       // Add the following code
       PrivateDependencyModuleNames.AddRange(new string[] {
               "INTLCore",
               "INTLFoundation",
               "INTLConfig",
               "LevelInfinite"
       });
   }

3. 将 LI PASS Lua 资源打进首包，在 Packaging/Additional Non-Asset 选项中添加：

   • ../Plugins/LevelInfinite/Content

   

   注意

   业务需要根据实际存放 LevelInfinite 文件夹的路径进行填写，例如实际存放路径是 ../Plugins/Template/LevelInfinite，则在此需要添加的是 ../Plugins/Template/LevelInfinite/Content。

4. 将 LI PASS uasset 资源打进首包，在 Packaging/Additional Asset 选项中添加：

   • /LevelInfinite

     

步骤2：配置 LI PASS

业务可选择使用编辑器的可视化配置编辑工具来进行 LI PASS 的配置，或直接打开工程目录修改 INTLConfig.ini 文件。以下步骤将介绍如何使用编辑器轻松配置 LI PASS。

有关各配置项的详情，可在编辑器选中选项来自动展示选项的简述，或参见 LI PASS 客户端配置 查看完整的配置项列表。

注意

在编辑器运行时生效需要重启引擎，否则构建安装包时则自动生效。

Unity

1. 通过编辑器工具栏 INTL > LI INIConfig Window 打开可视化配置编辑工具。

   

Unreal Engine

1. 通过编辑器工具栏 LITools > Config Editor 打开可视化配置编辑工具。

   

2. 将 ACCOUNT_SDK_KEY 和 ACCOUNT_APP_ID 设置为 Player Network 控制台分配的值。

   注意

   在 LI PASS V1.16 之前的版本，将 ACCOUNT_URL 设置为 https://test-pass.intlgame.com 来定义 LI PASS 测试环境。
   在 LI PASS V1.16 或之后的版本，此配置项为选填。

3. 为所需的平台配置指定的第三方登录渠道。
   例如，ACCOUNT_THIRD_CHANNEL_ANDROID = Facebook,Google。

   完整的配置列表，请参见 配置。

4. [可选] 第三方渠道登录时获取玩家邮箱。

要在第三方渠道登录时获取玩家邮箱需先设置对应权限。

• 基于合规考虑，可针对特定来源对返回的 email 做 mask 处理，如有需求请联系 Player Network 助手打开。
• 可在后台流水日志中上报 hash 后的 base64(sha256(email))，如有需求请联系 Player Network 助手打开。
• 可用于验证玩家信息或绑定列表是否包含 email 信息，如有需求请联系 Player Network 助手打开。
• 可用于 iOS Firebase 的 Private Set Membership（PSM）功能，详见 Firebase iOS 工程配置。

以下为支持返回玩家邮箱的第三方渠道：

Apple

注意

Apple 获取玩家邮箱需要玩家授权，如果玩家拒绝授权将无法获取到玩家邮箱，详见 Login 接口传入 email 和 fullName。

1. 使用编辑工具，将 email 权限添加到 [Dynamic] 下的 APPLE_LOGIN_PERMISSION。

2. 在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Google

在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Facebook

1. 使用编辑工具，将 email 权限添加到 [Dynamic] 下的 FACEBOOK_LOGIN_PERMISSION。如果 INTLConfig.ini 没有配置 FACEBOOK_LOGIN_PERMISSION，则会自动带上 email 权限。

2. 在 Meta for Developers 配置 email 权限。email 权限需要有 高级访问级别，才能让所有应用都能获取到玩家的 email。

   

3. 在 Player Network 控制台开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Twitter

1. 在 Twitter Developer Platform 的 User authentication settings 下，勾选 Request email from users。

   

2. 在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

步骤3：初始化 LI PASS

Unity

在游戏的启动活动中 初始化 SDK 后，调用 InitLIP 来初始化 LI PASS 登录组件。初始化过程首先会检查当前资源版本是否有可用的热更版本信息。如果有，将会下载新版资源，然后加载新版资源。加载完成后，初始化即被视为完成，并触发 LI PASS 事件回调（LIEventObserver）中的 GN_READY 事件。

Font font = GetFont();
LevelInfinite.InitLIP(font, Application.version, "en");

Unreal Engine

在游戏的启动活动中 初始化 SDK 后，调用 InitLIP 来初始化 LI PASS 登录组件。初始化过程首先会检查当前资源版本是否有可用的热更版本信息。如果有，将会下载新版资源，然后加载新版资源。加载完成后，初始化即被视为完成，并触发 LI PASS 事件回调（LIEventObserver）中的 GN_READY 事件。

FString Version = FApp::GetBuildVersion();
ULevelInfiniteAPI::InitLIP(GetGameInstance<UGameInstance>(), Version, TEXT("en"));

步骤4：处理 LI PASS 回调

注意

无需处理 LI PASS 内部回调事件，否则可能会拦截 LI PASS 正常的回调流程，导致登录异常。

根据以下示例，处理打开登录面板 OpenLoginPanel 和自动登录 AutoLogin 等回调事件。

Unity

开发人员需添加 AuthResultObserver、AuthBaseResultObserver 和 LIEventObserver 回调来处理登录组件和用户中心的事件。回调数据结构为 INTLAuthResult，其中包含登录信息和账号信息，例如 OpenID、账号绑定信息和账号注销状态。

// Add callbacks
public void AddAuthBaseObserver()
{
    INTLAPI.AddAuthBaseResultObserver(OnAuthBaseResultEvent);
}

// Remove callbacks
public void RemoveAuthBaseObserver()
{
    INTLAPI.RemoveAuthBaseResultObserver(OnAuthBaseResultEvent);
}

// Add callbacks
public void AddAuthObserver()
{
    INTLAPI.AddAuthResultObserver(OnAuthResultEvent);
}

// Remove callbacks
public void RemoveAuthObserver()
{
    INTLAPI.RemoveAuthResultObserver(OnAuthResultEvent);
}

// Handle AuthResultObserver callback result
private void OnAuthResultEvent(INTLAuthResult AuthResult)
{
    switch (AuthResult.MethodId)
    {
        // LI PASS third channel / LI channel enter game
        case (int)INTLMethodID.LI_LOGIN_ENTER_GAME:
            if(AuthResult.RetCode == (int)ERROR_CODE.SUCCESS) {
                Debug.Log("LI PASS Login success");
            } else {
                Debug.Log("LI PASS Login failed, ret_code = " + AuthResult.RetCode + ", ret_msg = " + AuthResult.RetMsg);
                LevelInfinite.OpenLoginPanel();
            }
            break;
        // LI PASS autologin enter game
        case (int)INTLMethodID.LI_AUTOLOGIN_ENTER_GAME:
            if(AuthResult.RetCode == (int)ERROR_CODE.SUCCESS) {
                Debug.Log("LI PASS Autologin success");
            } else {
                Debug.Log("LI PASS Autologin failed, ret_code = " + AuthResult.RetCode + ", ret_msg = " + AuthResult.RetMsg);
                LevelInfinite.OpenLoginPanel();
            }
            break;
        default:
            break;
    }
}

// Process the INTLBaseResult callback
public void OnAuthBaseResultEvent(INTLBaseResult ret)
{
    Debug.Log($"MethodID: {ret.MethodId}");
    
    string methodTag = "";
    if (ret.MethodId == (int)INTLMethodID.INTL_AUTH_LOGOUT)
    {
        methodTag = "Logout";
    }
    ShowLogInNewLine(methodTag + Tools.Instance.GetRetString(ret));
}

// Add callbacks
LevelInfinite.AddLIEventObserver(OnLIBaseEventResult);
// Handle LIEventObserver callback result
private void OnLIBaseEventResult(LIBaseEventResult liRet)
    {
        Debug.Log("<color=#ff00ff>OnLIBaseEventResult.  lIEventType : " + Enum.GetName(typeof(LIEventType), liRet.lIEventType) + ", extraJson:" + liRet.extraJson + "</color>");
        ShowLogInNewLine("OnLIBaseEventResult.  lIEventType : " + Enum.GetName(typeof(LIEventType), liRet.lIEventType) + ", extraJson:" + liRet.extraJson);
        switch (liRet.lIEventType)
        {
            // LI PASS Init Finish
            case LIEventType.GN_READY:
                // LevelInfinite.AutoLogin()
                // LevelInfinite.OpenLoginPanel()
                break;
            // LI PASS Panel Open 
            case LIEventType.LIP_PANEL_OPEN:
                break;
            // LI PASS Panel Close 
            case LIEventType.LIP_PANEL_CLOSE:
                break;
            // LI PASS Open Login Panel
            case LIEventType.OPEN_LOGIN:
                break;
            // LI PASS Close Login Panel    
            case LIEventType.CLOSE_LOGIN:
                break;
            // LI PASS Open Account Center
            case LIEventType.OPEN_ACCOUNT_CENTER:
                break;
            // LI PASS Close Account Center
            case LIEventType.CLOSE_ACCOUNT_CENTER:
                break;
            // LI PASS Close Delete Account Panel
            case LIEventType.CLOSE_DELETE_ACCOUNT:
                break;
            // LI PASS Close Parent Certificate Panel
            case LIEventType.CLOSE_PARENT_CERTIFICATE:
                break;
            // LI PASS Close Parent Tip Panel
            case LIEventType.CLOSE_PARENT_TIP:
                break;
            // LI PASS Close Parent Deny Panel
            case LIEventType.CLOSE_PARENT_DENY:
                break;
            // LI PASS Init Repeat
            case LIEventType.GN_REPEAT:
                break;
            // LI PASS Closed
            case LIEventType.GN_DISABLED:
                break;
            default:
                break;
        }
    }
// Remove callbacks
LevelInfinite.RemoveLIEventObserver(OnLIBaseEventResult);

开发人员也可添加 LILuaErrorObserver 回调处理 Lua 错误。

Unreal Engine

开发人员需添加 AuthResultObserver、AuthBaseResultObserver 和 LIEventObserver 回调来处理登录组件和用户中心的事件。回调数据结构为 FINTLAuthResult，其中包含登录信息和账号信息，例如 OpenID、账号绑定信息和账号注销状态。

//configure callback
FINTLAuthBaseEvent authBaseEvent;
authBaseEvent.AddUObject(this, &OnAuthBaseResult_Implementation);
UINTLSDKAPI::SetAuthBaseResultObserver(authBaseEvent);
// Remove callbacks
UINTLSDKAPI::GetAuthBaseResultObserver().Clear();
//Handle AuthBaseResult callback result
void OnAuthBaseResult_Implementation(FINTLAuthBaseResult ret)
{ 
    UE_LOG(LogTemp, Warning, TEXT("MethodID: %d"), ret.MethodId);
}
// Add callbacks
AuthResultObserver = UINTLSDKAPI::GetAuthResultObserver().AddUObject(this, &ULevelInfiniteWindow::OnAuthResult_Callback);
// Handle AuthResultObserver callback result
void ULevelInfiniteWindow::OnAuthResult_Callback(FINTLAuthResult AuthResult)
{
    if(AuthResult.MethodId == (int32)LIEnterGameMethodId::kLILoginEnterGame)
    {
        FString logStr;
        if(AuthResult.RetCode == INTL_NAMESPACE::ErrorCode::SUCCESS)
        {
            logStr = TEXT("LI PASS login success");
        }else{
            ULevelInfiniteAPI::OpenLoginPanel();
            logStr = FString::Printf(TEXT("LI PASS login failed, ret_code = %d, ret_msg = %s"), AuthResult.RetCode, *AuthResult.RetMsg);
        }
        UE_LOG(LogTemp, Warning, TEXT("%s"), *logStr);
    } else if (AuthResult.MethodId == (int32)LIEnterGameMethodId::kLIAutoLoginEnterGame){
        if(AuthResult.RetCode == INTL_NAMESPACE::ErrorCode::SUCCESS)
        {
            UE_LOG(LogTemp, Warning, TEXT("LI PASS Autologin success"));
        }else{
            ULevelInfiniteAPI::OpenLoginPanel();
            UE_LOG(LogTemp, Warning, TEXT("LI PASS Autologin failed, ret_code = %d, ret_msg = %s"), AuthResult.RetCode, *AuthResult.RetMsg);
        }
    }
}
// Remove callbacks
UINTLSDKAPI::GetAuthResultObserver().Remove(AuthResultObserver);

// Add callbacks
FDelegateHandle LIEventObserver;
LIEventObserver = ULevelInfiniteAPI::GetEventDelegate().AddUObject(this, &ULevelInfiniteWindow::OnLIEvent_Callback);
// Handle LIEventObserver callback result
void ULevelInfiniteWindow::OnLIEvent_Callback(FLIBaseEvent Event)
{
	FString logStr;
    switch(Event.EventType){
        // LI PASS Closed
		case ELIEventType::GN_DISABLED:
		{
			break;
		}
        // LI PASS Panel Open 
		case ELIEventType::LIP_PANEL_OPEN:
        // LI PASS Open Login Panel
        {
            logStr = TEXT("LI PASS panel open");
            break;
        }
        // LI PASS Panel Close 
		case ELIEventType::LIP_PANEL_CLOSE:
        {
            logStr = TEXT("LI PASS panel close");
            break;
        }
        // LI PASS Open Login Panel
        case ELIEventType::LOGIN_PANEL_OPEN:
        {
			logStr = TEXT("Login panel open");
            break;
        }
        // LI PASS Close Login Panel
        case ELIEventType::LOGIN_PANEL_CLOSE:
        {
			logStr = TEXT("Login panel close");
            break;
        }
        // LI PASS Open Account Center
        case ELIEventType::ACCOUNT_CENTER_OPEN:
        {
			logStr = TEXT("Account center open");
            break;
        }
        // LI PASS Close Account Center
        case ELIEventType::ACCOUNT_CENTER_CLOSE:
        {
			logStr = TEXT("Account center close");
            break;
        }
        // LI PASS Save Protocol Version
        case ELIEventType::SET_PROVISION:
		{
			logStr = FString::Printf(TEXT("LI set provision: %s"), *Event.ExtraJson);
			break;
		}
        // LI PASS Real Name Compliance Success
		case ELIEventType::COMPLIANCE_AGE_SUCESS:
		{
			logStr = TEXT("LI age and region compliance success");
			break;
		}
        // LI PASS Minor Compliance Success
		case ELIEventType::COMPLIANCE_MINOR_SUCESS:
		{
			logStr = TEXT("LI minor compliance success");
			break;
		}
        // LI PASS Close Parent Tip Panel
		case ELIEventType::CLOSE_PARENT_TIP_PANEL:
        {
        	logStr = TEXT("LI close parent tip panel");
        	break;
        }
        // LI PASS Close Parent Deny Panel
		case ELIEventType::CLOSE_PARENT_DENY_PANEL:
        {
        	logStr = TEXT("LI close parent deny tip panel");
        	break;
        }
        // LI PASS Close Parent Certificate Panel
		case ELIEventType::CLOSE_PARENT_CERTIFICATE_PANEL:
        {
        	logStr = TEXT("LI close parent certificate panel");
        	break;
        }
        // LI PASS Close Delete Account Panel
		case ELIEventType::CLOSE_DELETE_ACCOUNT_PANEL:
        {
        	logStr = TEXT("LI close delete account panel");
        	break;
        }
        // LI PASS Init Repeat
        case ELIEventType::INTL_REPEAT:
        {
            break;
        }
        // LI PASS Init Finish
		case ELIEventType::GN_READY:
		{
			// ULevelInfiniteAPI::AutoLogin();
            // ULevelInfiniteAPI::OpenLoginPanel();
			break;
		}
    }
}
// Remove callbacks
ULevelInfiniteAPI::GetEventDelegate().Remove(LIEventObserver);

开发人员也可添加 LILuaErrorObserver 回调处理 Lua 错误。

步骤5：设置 LI PASS 界面和邮件的语言

开发人员需要设置所有 LI PASS 界面和邮件使用的语言，因此需要使用 语言代码 作为入参调用 SetLanguage。建议此处设置的语言与游戏语言保持一致，以确保一致性。否则，LI PASS 界面和电子邮件中使用的语言可能与游戏使用的语言不同。

Unity

LevelInfinite.SetLanguage("zh-Hans");

Unreal Engine

ULevelInfiniteAPI::SetLanguage(TEXT("zh-Hans"));

步骤6：设置 UI 根节点

在使用任何其他 LI PASS 功能之前，需调用 SetUIRoot 设置所有 LI PASS 界面的根节点。

注意

设置 UI 根节点后，请不要销毁该节点，否则 LI PASS UI 界面无法挂载，会产生预期外的行为。

LI PASS 界面的释放请通过界面按钮操作，不要强制销毁。在切换场景时若由 Unity 控制 GC（垃圾回收）可能发生，会造成空指针错误出现。

Unity

有关分辨率的详细设置，请参见 设置 UI 根节点。

LevelInfinite.SetUIRoot(uiRoot);

Unreal Engine

Unreal Engine 需要将根节点铺满整个屏幕。

ULevelInfiniteAPI::SetUIRoot(uiRoot);

步骤7：设置发布地区

LI PASS 登录组件内置默认的合规流程，需要开发人员使用 allowList 和 blockList 数组作为入参调用 UpdateCountryList。allowList 数组应包含 LI PASS 国家地区选择页面需要展示的国家地区的 ISO 3166-1 数字代码，而 blockList 数组应包含不应显示的国家或地区代码。

此处指定的国家和地区将用于 LI PASS 登录组件内置的合规工作流程中。

Unity

string[] allowArray = new string[] {"496","400"};
string[] blockArray = new string[] {"400"};

LevelInfinite.UpdateCountryList(allowArray,blockArray);

Unreal Engine

TArray<FString> allowList;
allowList.Add(TEXT("496"));
allowList.Add(TEXT("400"));
TArray<FString> blockList;
blockList.Add(TEXT("400"))

ULevelInfiniteAPI::UpdateCountryList(allowList,blockList);

步骤8：添加 LI PASS 功能

• 登录组件
  添加 LI PASS 登录组件，实现账号注册、登录、登出、账号中心等功能。

• 礼包
  配置 LI PASS 礼包活动。

Unreal Engine 主机平台游戏内账号绑定

警告

游戏内账号绑定功能仅用于 Unreal Engine 中的主机平台，其他平台无需接入。

此功能用于在游戏页面内拉起绑定 LI PASS 页面。

// 添加登录态监听代码
AuthResultObserver = UINTLSDKAPI::GetAuthResultObserver().AddUObject(this, &UFloatingSidebar::OnAuthResult_Callback);

// 查询当前用户的绑定关系
UINTLSDKAPI::QueryBindInfo();

// 处理查询绑定关系的回调
void UFloatingSidebar::OnAuthResult_Callback(FINTLAuthResult AuthResult)
{
	UE_LOG(LogTemp, Warning, TEXT("UFloatingSidebar::OnAuthResult_Callback AuthResult.MethodId: %d"),AuthResult.MethodId);
	if(AuthResult.MethodId == (int32)LIMethodId::kLIQueryBindInfo) {
		if(AuthResult.RetCode == INTL_NAMESPACE::ErrorCode::SUCCESS)
        {
            UE_LOG(LogTemp, Warning, TEXT("LI query bind info success bindlist = %s"), *AuthResult.BindList);
			TArray <TSharedPtr<FJsonValue>> bindInfoArray;
			TSharedRef<TJsonReader<TCHAR>>jsonReader = TJsonReaderFactory<TCHAR>::Create(AuthResult.BindList);
			bool isSe = FJsonSerializer::Deserialize(jsonReader, bindInfoArray);
			if (isSe)
			{
				UE_LOG(LogTemp, Warning, TEXT("LI query bind info format JsonObject success"));		
				bool haveBindLI = false;
				FString liEmail;
				for(int i = 0; i < bindInfoArray.Num(); i++)
				{
					int32 channelId = bindInfoArray[i]->AsObject()->GetIntegerField("channelid");
					FString email = bindInfoArray[i]->AsObject()->GetStringField("email");
					UE_LOG(LogTemp, Warning, TEXT("LI query bind info channelId = %d, email = %s"), channelId, *email);
					if(channelId ==  (int32)EINTLLoginChannel::kChannelLevelInfinite) {
						haveBindLI = true; 
						liEmail = email;
						break;
					}
				}
				if(!haveBindLI) {
                    // 打开游戏内绑定的页面
					ULevelInfiniteAPI::OpenBindAccount();
				} else {
                    // 当前用户已绑定 LI PASS，无需进行后续的引导绑定操作
                    UE_LOG(LogTemp, Warning, TEXT("Account have bind LI"));
				}
			} else {
				UE_LOG(LogTemp, Warning, TEXT("LI query bind info format JsonObject failed"));
			}
        }else{
			UE_LOG(LogTemp, Warning, TEXT("LI query bind info failed, ret_code = %d, ret_msg = %s"), AuthResult.RetCode, *AuthResult.RetMsg);
            // token失效的情况
			FINTLAuthResult CurrentAuthResult;
			if (UINTLSDKAPI::GetAuthResult(CurrentAuthResult)) {
				EINTLLoginChannel channel = static_cast<EINTLLoginChannel>(CurrentAuthResult.ChannelID);

				if (channel == EINTLLoginChannel::kChannelPS5) {
					FString permissions = "psn:s2s openid id_token:psn.basic_claims";
					ULevelInfiniteAPI::LoginChannelWithLIPass(channel, permissions, "{}");
				} else if (channel == EINTLLoginChannel::kChannelXbox) {
					ULevelInfiniteAPI::LoginChannelWithLIPass(channel, "", "{}");
				} else {
					ULevelInfiniteAPI::LoginChannelWithLIPass(channel, "", "{}");
				}
			}	
        }
	}
}

功能示例：

使用 Web 组件完成 Web 端登录流程

LI PASS Web 组件具备登录、注册、绑定及预约功能，并支持同一业务（即 GAME_ID）下多套配置，可以满足您在各种网页场景的 LI PASS 以及第三方渠道的账号需求，与游戏客户端内账号互通。

只需几行代码就可完成接入，让您的网页无须再逐一接入 API，告别自行搭建交互和 UI。

注意

推荐使用 Player Network 控制台 配置 Web 组件 功能，配置更简单、更新更灵活。

已通过代码形式配置的业务，可前往 Player Network 控制台新增 Web 端配置，从控制台下发的配置将覆盖网页的代码配置。
如有疑问，请联系 Player Network 助手。

步骤1：引入 SDK

从 CDN 安装 Web SDK。

// SDK 联调版本包
<script src="https://test-common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.umd.js"></script>
<link rel="stylesheet" href="https://test-common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.css" />


// SDK 正式版本包
<script src="https://common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.umd.js"></script>
<link rel="stylesheet" href="https://common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.css" />

步骤2：在 Player Network 控制台配置 LI PASS

详细配置步骤，请参见 LI PASS 配置。 配置 Web 类型的登录配置后，可在发布后获得 WEB_ID。

注意

您可在 Player Network 控制台创建多个 LI PASS Web 配置，在不同的 Web 场景使用不同的配置。

步骤3：实例化 JavaScript SDK

引入 JS、CSS 资源

<script src="https://test-common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.umd.js"></script>
<link rel="stylesheet" href="https://test-common-web.intlgame.com/sdk-cdn/infinite-pass/latest/index.css" />
<!-- 项目上线时，请使用正式版本 SDK 正式版本包 -->

<!-- 挂载节点 -->
<div id="infinite-pass-component"></div>

实例化 SDK

const pass = new PassFactory.Pass({
  env: "test", // environment, 正式环境参数请联系 Player Network 助手
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "", // Player Network 控制台中配置的 WEB_ID

  config: {}, // 如果不使用 webID，可配置 config
});

初始化参数详情，请参见 网页组件配置。

注意

如果您已在 Player Network 控制台创建好 LI PASS Web 的配置，只需要复制 WEB_ID 在代码初始化传入即可，并且能够实时修改配置。
如果您未在 Player Network 控制台完成 Web 配置，则需参考 详细配置 在代码里手动配置 config。

步骤4：实现 LI PASS 登录／注册

LEVEL INFINITE PASS Web 组件支持玩家通过 LEVEL INFINITE PASS 和第三方渠道登录游戏。

初始化 pass 组件后，调用 start 方法，将 LI PASS Web 组件挂载到指定的 DOM 节点。 登录成功后，登录结果会在 intlSignResp 中返回。

登录/注册成功完成后，组件的 UI 不会变更，需要自行处理后续逻辑。如将登录信息存储到 cookie 或者 localStorage，并将 UI 导航到登录成功的页面。

要自定义登录交互，请参见 Web。

<div id="infinite-pass-component"></div>

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "", // Player Network 控制台中配置的 WEB_ID
});

// 调用 `start` 将 Web 组件挂载到指定的 DOM 节点
// 登录成功后 登录结果在 `onLogin`、`onRegister` 事件返回
pass.start("#infinite-pass-component");

// 您可以监听事件列表，当用户完成登录或注册时获取用户的鉴权信息
pass.on("onLogin", (userInfo) => {
  // After the user fails to log in, the 'onLoginError event' will be triggered, and the game logic after the user successfully logs in, can be processed in the event callback
  // For example, redirect to a specific page
  console.log(userInfo);
});

pass.on("onRegister", (userInfo) => {
  // Logic added after successful registration
  // For example, redirect to a specific page
  console.log(userInfo);
});

返回参数

参数	类型	描述
ret	number	返回代码 0：请求成功 !=0：请求失败，查看 msg 详细结果说明
msg	string	结果说明
token	string	Player Network SDK 生成的用户 token 长度：40字节，详见 Token
openid	string	Player Network SDK 用户唯⼀标识 默认为 64-bit 无符号整数的字符串，也可以支持 32-bit
token_expire_time	int64	令牌过期时间 Unix 时间
user_name	string	用于登录的用户名
channel_info	object	当前渠道的渠道信息。 更多信息，请参见 渠道信息。
del_account_status	number	账号注销状态 -1：查询失败 0：没有记录撤销 Player Network 账号注销请求 (包括邮件账号和电话账号) 1：删除的静默期 2：账号注销完成 3：注销账号 4：账号注销失败
seq	string	数据流消息序号
first_login	number	是否首次登录 未知: -1 否: 0 是: 1

返回示例

{
    channel_info:{
        account:"wuqinghao@outlook.com",
        account_plat_type: 131,
        account_type: 1,
        channelId: 131
    },
    del_account_status: 0,
    first_login: 0,
    msg: "success",
    openid: "xxx",
    ret: 0,
    seq: "1638194026-0180225310-032531-0000292460",
    token: "xxx",
    token_expire_time: 1638494026,
    user_name: "user",
}

步骤5：实现第三方渠道登录

警告

LI PASS Web 登录第三方渠道仅支持系统浏览器，任何游戏或应用的内置 WebView 组件均不支持第三方渠道登录：

• 基于安全考量，Google 和 Facebook 完全禁止在内置 WebView 使用网页登录
• WebView 组件不能同时加载两个页面，这意味着它无法加载第三方登录页面来完成登录过程

LI PASS Web 组件的第三方渠道登录目前支持 Apple、Discord、Epic、Facebook、Google、LINE、PS5、Steam、Twitch、Twitter、VK、QQ、Wechat。

方法1：通过 Player Network 控制台配置（推荐）

通过 Player Network 控制台配置第三方渠道登录，实时地变更需要展示的第三方渠道。详细配置步骤，请参见 Web 登录渠道。

[可选] 在登录过程中自动引导用户绑定 LI PASS

针对通过第三方渠道登录的用户，若其未使用邮箱绑定 LI PASS，则可在用户登录时引导该用户绑定 LI PASS。

要使用该功能，请在 Player Network 控制台的 账号绑定策略 中开启 引导玩家使用邮箱绑定 LI PASS 和 登录时自动触发 的开关，并在初始化 pass 时传入 webID。

您可监听 onBindError 事件获取和绑定错误相关的信息：

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "xxxxxxxxxxxx", // Player Network 控制台中配置的 WEB_ID
});

// 调用 `start` 将登录启动器挂载到指定的 DOM 节点
// 登录成功后登录结果在 `onLogin`、`onRegister` 事件返回
pass.start("#infinite-pass-component");

// 当用户完成登录和绑定时，会触发 `onLogin` 事件，同时会返回绑定的结果 `has_bind_lip`
pass.on("onLogin", (userInfo) => {
  console.log(userInfo.has_bind_lip);
});

// 您可以监听 `onBindError` 事件，当绑定出现错误时，会触发该流程
pass.on("onBindError", (result) => {
  console.log(result);
});

// 可监听 `onClose` 事件，用户在绑定流程中点击关闭按钮，并且 Player Network 控制台中的绑定策略配置为 **强制玩家绑定**，将触发该事件
pass.on("onClose", (accountApi) => {
  console.log(accountApi);
});

参数	类型	描述
has_bind_lip	boolean	是否绑定了 LI PASS true：用户已绑定 LI PASS，或在本次登录过程中完成绑定 false：用户跳过了绑定

[可选] 在登录过程中自动引导用户绑定第三方渠道

可在用户登录时引导该用户绑定第三方渠道，如果用户没有绑定过 LI PASS，会优先绑定 LI PASS，每次登录过程中仅可以绑定一次渠道。

绑定第三方渠道的范围必须是登录时第三方渠道渠道的子集。

要使用该功能，请在 Player Network 控制台的 账号绑定策略 中开启 引导玩家绑定第三方渠道 和 登录时自动触发 的开关，并在初始化 pass 时传入 webID。

您可监听 onBindError 事件获取和绑定错误相关的信息：

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "xxxxxxxxxxxx", // Player Network 控制台中配置的 WEB_ID
});

// 调用 `start` 将登录启动器挂载到指定的 DOM 节点
// 登录成功后登录结果在 `onLogin`、`onRegister` 事件返回
pass.start("#infinite-pass-component");

// 当用户完成登录和绑定时，会触发 `onLogin` 事件，同时会返回绑定的结果 `has_bind_lip`
pass.on("onLogin", (userInfo) => {
  console.log(userInfo.has_bind_lip);
});

// 您可以监听 `onBindError` 事件，当绑定出现错误时，会触发该流程
pass.on("onBindError", (result) => {
  console.log(result);
});

// 可监听 `onClose` 事件，用户在绑定流程中点击关闭按钮，并且 Player Network 控制台中的绑定策略配置为 **强制玩家绑定**，将触发该事件
pass.on("onClose", (accountApi) => {
  console.log(accountApi);
});

参数	类型	描述
has_bind_lip	boolean	是否绑定了 LI PASS true：用户已绑定 LI PASS，或在本次登录过程中完成绑定 false：用户跳过了绑定
socialBindList	object	用户的第三方渠道绑定列表

socialBindList

参数	类型	描述
channelId	number	渠道 ID
channelName	string	渠道唯一标识
isNewlyBound	boolean	是否本次操作绑定，用于区分历史绑定和本次绑定

[可选] 第三方渠道登录时获取玩家邮箱

注意

此项设置属于 Player Network 控制台的 第三方渠道配置，Web 端运营角色将无权限访问，请联系业务完成配置。

要使用 Web 绑定模块的快速绑定功能，需先设置在第三方渠道登录时获取玩家邮箱的权限。

• 基于合规考虑，可针对特定来源对返回的 email 做 mask 处理，如有需求请联系 Player Network 助手打开。
• 可在后台流水日志中上报 hash 后的 base64(sha256(email))，如有需求请联系 Player Network 助手打开。
• 可用于验证玩家信息或绑定列表是否包含 email 信息，如有需求请联系 Player Network 助手打开。
• 可用于 iOS Firebase 的 Private Set Membership（PSM）功能，详见 Firebase iOS 工程配置。

以下为支持返回玩家邮箱的第三方渠道：

Apple

注意

Apple 获取玩家邮箱需要玩家授权，如果玩家拒绝授权将无法获取到玩家邮箱，详见 Login 接口传入 email 和 fullName。

1. 使用编辑工具，将 email 权限添加到 [Dynamic] 下的 APPLE_LOGIN_PERMISSION。

2. 在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Google

在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Facebook

1. 使用编辑工具，将 email 权限添加到 [Dynamic] 下的 FACEBOOK_LOGIN_PERMISSION。如果 INTLConfig.ini 没有配置 FACEBOOK_LOGIN_PERMISSION，则会自动带上 email 权限。

2. 在 Meta for Developers 配置 email 权限。email 权限需要有 高级访问级别，才能让所有应用都能获取到玩家的 email。

   

3. 在 Player Network 控制台开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

Twitter

1. 在 Twitter Developer Platform 的 User authentication settings 下，勾选 Request email from users。

   

2. 在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

方法2：通过代码配置

<div id="infinite-pass-component"></div>

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID

  config: {
    socialList: ['facebook', 'twitter']
  }
});

// 调用 `start` 方法将登录启动器挂载到指定的 DOM 节点
pass.start("#infinite-pass-component");

// 您可以监听事件列表，当用户完成登录或注册时获取用户的鉴权信息
pass.on("onLogin", (userInfo) => {
  // After the user fails to log in, the 'onLoginError event' will be triggered, and the game logic after the user successfully logs in, can be processed in the event callback
  // For example, redirect to a specific page
  console.log(userInfo);
});

pass.on("onLoginError", (userInfo) => {
  // The 'onLogin event' will be triggered after the user successfully logs in, and the game logic after the user fails to log in, can be processed in the event callback.
  console.log(userInfo);
});

关键配置参数

参数	类型	描述	备注
socialList	string[]	渠道列表，详细配置请参见 config	选填
socialParams	object	第三方渠道登录时需要的配置, 详细配置请参见 socialParams	选填

返回参数

参数	类型	描述
ret	number	返回代码 0：请求成功 !=0：请求失败，查看 msg 详细结果说明
msg	string	结果说明
token	string	Player Network SDK 生成的用户 token 长度：40字节，详见 Token
openid	string	Player Network SDK 用户唯⼀标识 默认为 64-bit 无符号整数的字符串，也可以支持 32-bit
token_expire_time	int64	Player Network SDK token 过期时间 Unix时间
user_name	string	用于登录的用户名
channel_info	object	登录渠道的渠道信息 更多信息，请参见 渠道信息。
del_account_status	number	账号注销状态 -1：查询失败 0：未撤回任何注销账号记录或删除号码 (邮件或手机账号) 1：账号注销前的静默期 2：已经成功注销账号 3：正在注销账号 4：注销账号失败
seq	string	数据流消息序号

返回示例

{
    channel_info: {
        access_token:"xxxxx",
        expire_ts: 1641527900,
    }
    first_login: 0,
    msg: "success",
    openid: "xxxx",
    picture_url: "https://www.google.com/Images/profileA.png",
    ret: 0,
    seq: "1638935899-1006943754-018668-0000656615",
    token: "xxx",
    token_expire_time: 1641527900,
    del_account_status: 0,
    user_name: "user",
}

步骤6：实现身份验证状态保留

使用 LI PASS Web 组件时，您可以根据信息的存入方式自行开发身份验证状态如何持久保留：

• 已登录的用户在显式退出登录前，无限期地保留身份验证状态（存储 cookie 或者 localStorage）
• 在窗口关闭时清除身份验证状态（存入 sessionStorage）
• 在页面重新加载时清除身份验证状态（不做存储）

下列为表格为存储的用户凭证信息，可通过监听 onLogin、onRegister 事件获取。

参数	类型	读取方式
openid	string	userInfo.openid
token	string	userInfo.token
channelId	string	userInfo.channel_info.channelId

禁用默认行为

使用 LI PASS Web 组件登录后，会自动将身份验证状态存储到 logined_account_cache_key cookie 中。为避免过度依赖此 cookie，如果需要保留登录态请选择将用户凭证信息存入 localStorage 或 sessionStorage。

如果需要禁用该默认行为，可以在初始化 widget 的时候进行设置：

const pass = new PassFactory.Pass({
  env: "", // Environment
  gameID: "", // Game ID
  appID: "", // LI PASS App ID

  config: {
    disableCookie: true
  }
});

步骤7：设置 UI 交互方式

方法1：通过 Player Network 控制台配置（推荐）

推荐使用 Player Network 控制台设置 Web 端的 交互方式：

• 嵌入内容页面 - 普通形态，将组件嵌入到网页任意的 DOM 节点
• 以弹框形式在页面展示 - 模态框形态，和普通形态类似，并支持使用 show 和 hide 控制模态框的显示／隐藏

方法2：通过代码配置

将 config.renderMode 设置为 inline（普通形态）或 modal（模态框形态），优先级低于 Player Network 控制台下发的配置。

初始化：调用 start 方法，会进行自动渲染

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "", // Player Network 控制台中配置的 WEB_ID
});

// 调用 `start` 将 Web 组件挂载到指定的 DOM 节点
pass.start("#infinite-pass-component");

主动关闭模态框：

pass.hide()

关闭后，再次打开模态框（不保留用户输入）：每次都重新重新初始化模态框

<div id="infinite-pass-component"></div>
<button onclick="login">登录</button>

function login() {
    const pass = new PassFactory.Pass({
        env: "test", // Environment
        gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
        appID: "", // Player Network 控制台中配置的 APP_ID
        webID: "", // Player Network 控制台中配置的 WEB_ID
    });

    // 调用 `start` 将 Web 组件挂载到指定的 DOM 节点
    pass.start("#infinite-pass-component");
}

关闭后，再次打开模态框（保留用户输入）：在第一次初始化时，保存实例，后续调用 pass.show 重新展示模态框

<div id="infinite-pass-component"></div>
<button onclick="login">登录</button>

function login() {
    // 您需要自行保存 pass 实例的引用
    if (!pass) {
        const pass = new PassFactory.Pass({
            env: "test", // Environment
            gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
            appID: "", // Player Network 控制台中配置的 APP_ID
            webID: "", // Player Network 控制台中配置的 WEB_ID
        });

        // 调用 `start` 将 Web 组件挂载到指定的 DOM 节点
        pass.start("#infinite-pass-component");
    } else {
        pass.show()
    }
}

步骤8：添加 LI PASS 功能

绑定 LI PASS 组件

在用户使用第三方渠道登录 LI PASS 的情况下，可以调用 bind API 手动触发 LI PASS 绑定流程。

• 如果当前登录的第三方渠道能够返回用户邮箱，并且没有绑定过 LI PASS，则进入快速绑定流程。
• 如果当前登录的第三方渠道无法获取邮箱，或获取到的邮箱已绑定过其他 LI PASS，则会让用户输入邮箱绑定 LI PASS。
• 如果当前用户已经绑定了 LI PASS，则返回已绑定的信息。

在 Player Network 控制台创建 LI PASS Web 配置，并在 账号绑定策略 中开启 引导玩家使用邮箱绑定 LI PASS 和 允许玩家手动触发。发布后，在初始化 pass 时传入所生成的 WEB_ID。

您可监听 onBindError 事件获取和绑定错误相关的信息：

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "xxxxxxxxxxxx", // Player Network 控制台中配置的 WEB_ID
});


// 调用 `bind` 方法展示绑定组件
pass.bind({
  bindToken: '', // 当前用户的 openid
  bindToken: '', // 当前用户的 token
  bindChannelID: 6, // 当前用户的 channelid
})

// 监听 `onBind` 事件，您可以从结果中的 `has_bind_lip` 查看用户的绑定状态
pass.on("onBind", (result) => {
  console.log(result);
});

// 用户点击关闭按钮时会触发 `onClose` 事件，代表用户没有完成绑定
pass.on("onClose", (accountApi) => {});

// 您可以监听 `onBindError` 事件，当绑定出现错误时，会触发该流程
pass.on("onBindError", (result) => {
  console.log(result);
});

返回参数

参数	类型	描述
has_bind_lip	boolean	是否绑定了 LI PASS
openid	string	Player Network SDK 用户唯⼀标识 默认为 64-bit 无符号整数的字符串，也可以支持 32-bit
token	string	Player Network SDK 生成的用户 token 长度：40字节，详见 Token
channel_info	object	渠道信息

channel_info

参数	类型	描述
channelId	number	渠道 ID

绑定第三方渠道组件

在用户已经完成登录授权的情况下，可以调用 bindSocial API 手动触发绑定第三方渠道的流程。

在 Player Network 控制台创建 LI PASS Web 配置，并在 账号绑定策略 中开启 引导玩家绑定第三方渠道 和 允许玩家手动触发。发布后，在初始化 pass 时传入所生成的 WEB_ID。

您可监听 onBindError 事件获取和绑定错误相关的信息：

const pass = new PassFactory.Pass({
  env: "test", // Environment
  gameID: xxxxx, // Player Network 控制台中配置的 GAME_ID
  appID: "", // Player Network 控制台中配置的 APP_ID
  webID: "xxxxxxxxxxxx", // Player Network 控制台中配置的 WEB_ID
});


// 调用 `bindSocial` 方法展示绑定组件
pass.bindSocial({
  bindToken: '', // 当前用户的 openid
  bindOpenid: '', // 当前用户的 token
  bindChannelID: 6, // 当前用户的 channelid
})

// 监听 `onBind` 事件，您可以从结果中的 `has_bind_lip` 查看用户的绑定状态
pass.on("onBind", (result) => {
  console.log(result);
});

// 用户点击关闭按钮时会触发 `onClose` 事件，代表用户没有完成绑定
pass.on("onClose", (accountApi) => {});

// 您可以监听 `onBindError` 事件，当绑定出现错误时，会触发该流程
pass.on("onBindError", (result) => {
  console.log(result);
});

返回参数

参数	类型	描述
has_bind_lip	boolean	是否绑定了 LI PASS
openid	string	Player Network SDK 用户唯⼀标识 默认为 64-bit 无符号整数的字符串，也可以支持 32-bit
token	string	Player Network SDK 生成的用户 token 长度：40字节，详见 Token
socialBindList	object	用户的第三方渠道绑定列表

socialBindList

参数	类型	描述
channelId	number	渠道 ID
channelName	string	渠道唯一标识
isNewlyBound	boolean	是否本次操作绑定，用于区分历史绑定和本次绑定

预约组件

使用 preOrder 方法实现预约，用户下载游戏后无需重新注册；收集用户有效邮箱，实现有效触达。

参数列表

参数	类型	描述	备注
apiKey	string	使用相同的 gameid 在 SmartLink 申请 apiKey	Required
tags	string[]	为 SmartLink 联系人添加自定义标签	Optional

示例

const pass = new PassFactory.Pass({
  env: "", // Environment
  gameID: "", // Game ID
  appID: "", // LI PASS App ID

  config: {
    langType: 'en' // 默认为 'en'，修改此配置来更换默认语言
  }
});

// 调用 `preOrder` 方法展示预订组件
pass.preOrder({
  apiKey: 'xxxxxxxxx',
  tags: ['tag1', 'tag2'],
})

推荐使用

您已完成 LI PASS Web 组件的接入，并可开始搭建您的网页。

我们建议使用以下 Web 组件功能：

• 查看 Web 组件登录配置，了解如何配置您的登录/注册流程，以便继续接入更多功能。
• 若您想在网页开展渠道账号绑定活动，请参见 Web 绑定。
• 若您想在网页开展游戏预约（预注册）活动，请参见 Web 预约。
• 无论哪种登录方式，我们都提供完整的合规流程，请参见 合规。
• 简单一个配置即可调整出更适合游戏风格的个性化网页组件，请参见 自定义外观。
• 应用场景示例，请参见 Web 场景，给您更多灵感。

Web 组件接入快速、功能灵活，还有更多应用场景等您一起探索。

更多详情，请联系 Player Network 助手进行咨询。

API 列表

方法名	描述
start	初始化 LI PASS Web 组件
unmount	卸载/关闭 LI PASS Web 组件
changeLanguage	切换语言，支持语言请参见 语言列表
on	监听事件，支持的事件请参见 事件列表
bind	LI PASS 绑定方法
preOrder	LI PASS 预约方法

unmount

调用 unmount 方法会将 LI PASS Web 组件从 DOM 上卸载。

changeLanguage

可以通过调用 changeLanguage 方法切换 Web 组件语言，如果传入的语言参数暂不支持，会展示默认语言 en。

示例

// Web 组件切换语言到意大利语
pass.changeLanguage("it");

语言列表

编码	语言类型
ar	Arabic（阿拉伯语）
cs	Czech（捷克语）
de	German（德语）
en	English（英语）
es	Spanish (Latin America)（西班牙语-拉美）
es-eu	Spanish (Europe)（西班牙语-欧洲）
fi	Finnish（芬兰语）
fil-PH	Filipino（菲律宾语）
fr	French（法语）
hi	Hindi（印地语）
id	Indonesian（印尼语）
it	Italian（意大利语）
ja	Japanese（日语）
ko	Korean（韩语）
ms	Malay（马来语）
nl	Dutch（荷兰语）
pl	Polish（波兰语）
pt	Portuguese (Latin America)（葡语-拉美）
ru	Russian（俄语）
th	Thai（泰语）
tr	Turkish（土耳其语）
vi	Vietnamese（越南语）
zh-Hant	Chinese (Traditional)（繁体中文）
zh-Hans	Chinese (Simplified)（简体中文）
zh-TW	Chinese (Taiwan)（中文-台湾）

on

调用 pass 组件提供的 on 方法可以注册回调事件处理器。用户在 LI PASS Web 组件进行操作时，组件会在相应的时机回调事件。

注意

需要在用户触发相应事件前注册事件。

示例

pass.on("onLogin", (userInfo) => {
  // 用户登录失败后会触发 'onLoginError 事件'，可以在该事件回调里处理用户成功登录后的业务逻辑
  // 例如跳转到特定的某个页面
  console.log(userInfo);
});

pass.on("onLoginError", (userInfo) => {
  // 用户成功登录后会触发 'onLogin 事件'，可以在该事件回调里处理用户登录失败后的业务逻辑
  console.log(userInfo);
});

pass.on("onRegister", (userInfo) => {
  // 注册成功后加入的逻辑
  // 例如跳转到特定的某个页面
  console.log(userInfo);
});

事件列表

方法名	描述	回调参数
onLoad	加载渲染的组件	accountApi
onClose	模态框模式下点击关闭按钮关闭组件	userInfo，accountApi
onLogin	登录成功	userInfo，accountApi
onLoginError	登录失败	error
onLoginTabChange	Web 组件上的 Tab 开关	activeTab
onRegister	注册成功	userInfo，accountApi
onRegisterError	注册失败	error
onPwdReset	密码重置成功	accountApi
onPwdResetError	密码重置失败	error，accountApi
onPreOrder	预约成功	result
onPreOrderError	预约失败	result
onBind	绑定成功	result
onBindError	绑定失败	result