接入指引

纯 SDK 接入模式提供完整的身份验证能力矩阵，支持您设计任何形态的登录流程。

本文将介绍如何在网页实现 Player Network SDK 的登录鉴权功能，列出了相关接口及其使用指南，请根据您需要的功能选择相应的集成方式。

能力描述：Player Network SDK 提供最核心的底层账号能力接口，不包含任何预置的前端界面，此方案给予开发团队最大的灵活性和控制权，适用于需要完全自定义前端交互流程的场景。
您的实现重点：
- 负责所有前端界面（UI/UX）的开发、测试与维护
- 处理登录态失效的流程（如令牌过期失效），并自然引导至登录界面。

登录流程

引⼊ SDK

caution

项目联调阶段可以引⼊ SDK 联调版本包，该包仅用于集成测试。项目上线须引⼊ SDK 正式版本包。

目前已支持 npm 包方式和 CDN 方式

// 如需使用 LI PASS 功能，请确保版本大于 1.16.0 
$ npm install @intlsdk/account-api 

// SDK 联调版本包
<script src="https://test-common-web.intlgame.com/sdk-cdn/account-api/latest/index.umd.js"></script>

// SDK 正式版本包
<script src="https://common-web.intlgame.com/sdk-cdn/account-api/latest/index.umd.js"></script>

使用 SDK

caution

在集成测试时，将 env 设置为测试环境；项目上线时，将 env 设置为相应的正式环境。

使用不同功能的参数不同。

邮箱帐号登录

const accountApi = new IntlgameAccountApi({
  env: "test", // sdk 运行的环境
  gameID: 11, // Player Network 中配置的 Game ID
  appID: "", // Player Network 中配置的 APP_ID
  accountPlatType: 131, // LI PASS平台 id
  hostCAcc: "https://test-web-pass.intlgame.com", // 测试环境传 `https://test-web-pass.intlgame.com`, 正式环境传 `https://li-sg.intlgame.com`
  langType: "en", // 语言
});

参数	类型	描述	备注
env	string	SDK 环境更多信息，请参见获取部署集群信息。	必填
gameID	number	Player Network 游戏唯一标识 ID	必填
appID	string	App ID Player Network 控制台分配的 ACCOUNT_APP_ID	必填
accountPlatType	number	账号平台类型，用于识别不同的账号平台 Player Network 控制台分配的 ACCOUNT_PLAT_TYPE，LI PASS 为 131	必填
hostCAcc	string	如果是 LI PASS，则该项必填，测试环境传 `https://test-web-pass.intlgame.com` 正式环境传 `https://li-sg.intlgame.com`	LI PASS 登录必填
langType	string	语言类型更多信息，请参见语言类型定义	必填

初始化 SDK 后，请根据流程逻辑图和 API 列表完成邮箱帐号注册与登录。

第三方渠道登录

渠道登录通过 thirdAuthorize 接口打开第三方渠道页面，要求玩家输入第三方身份信息，完成登录操作。登录成功后，通常会有授权页，要求玩家同意游戏获取其第三方渠道账号信息（如用户名、头像、邮箱等）。如果玩家同意授权，第三方渠道将返回用户的 UID 和其他信息，供 Player Network SDK 鉴权使用，从而实现玩家登录游戏。

Player Network JSSDK 封装了主流第三方社交平台的接入逻辑，支持快速鉴权并提取用户信息，屏蔽了各个渠道间的接入差异，极大地降低了集成成本。游戏团队可根据业务需求，自由配置支持的渠道及其显示顺序。

const accountApi = new IntlgameAccountApi({
  env: "test", // sdk 运行的环境，详见下 "env说明"
  gameID: 11,
});

参数	类型	描述	备注
env	string	SDK 环境更多信息，请参见获取部署集群信息。	必填
gameID	number	Player Network 游戏唯一标识 ID	必填

初始化 SDK 后，请根据流程逻辑图和 API 列表完成三方渠道登录。

流程逻辑图

账号密码注册

图片：账号注册

账号注册

图片：账号登录

第三方账号登录流程

图片：第三方账号登录流程

API

邮箱帐号 API

有关邮箱帐号 API 的更多信息，请参见：

API	函数定义
密码登录 (signIn)	密码登录
验证码登录 (verifyCodeSignIn)	使用邮箱验证码登录
注册 (VerifyCodeRegister)	注册邮箱帐号
发送验证码 (requestVerifyCode)	发送验证码（可用于注册、登录、修改密码）
查询注册状态 (queryRegisterStatus)	查询邮箱注册状态
查询用户信息（queryUserInfo）	查询用户信息
修改用户信息（modifyProfile）	修改用户信息
修改用户协议版本号（modifyUserAgreement）	修改用户协议
检查用户名是否被注册（queryUserNameStatus）	检查用户名是否被注册
修改密码（resetPassword）	修改密码
登出（intlLogout）	登出

第三方渠道 API

有关第三方登录 API 的更多信息，请参见：

API	函数定义
thirdAuthorize	第三方渠道授权
intlAuthorize	Player Network 账号授权
intlLogout	登出

绑定 API

有关绑定 API 的更多信息，请参见：

API	函数定义
绑定 (bind)	绑定
解除绑定 (unbind)	解除绑定
getBindChannelsByOpenID	根据 Player Network SDK OpenID 获取绑定列表
getBindChannelsByUid	根据渠道登录信息获取绑定列表

登录流程​

引⼊ SDK​

使用 SDK​

邮箱帐号登录​

第三方渠道登录​

流程逻辑图​

账号密码注册​

账号注册​

第三方账号登录流程​

API​

邮箱帐号 API​

第三方渠道 API​

绑定 API​