Web 登录接入
快速入门
步骤1：引⼊ SDK
caution
项目联调阶段可以引⼊ SDK 联调版本包，该包仅用于集成测试。项目上线须引⼊ SDK 正式版本包。
目前已支持 npm 包方式和 CDN 方式
- 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>
步骤 2：使用 SDK
caution
在集成测试时，将 env 设置为测试环境；项目上线时，将 env 设置为相应的正式环境。
使用不同功能的参数不同。
LI PASS 登录相关
const accountApi = new IntlgameAccountApi({
env: "test", // sdk 运行的环境
gameID: 11, // Player Network 中配置的 Game ID
appID: "", // Player Network 中配置的 APP_ID
accountPlatType: 131, // LI PASS平台 id
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 | 语言类型 更多信息，请参见 语言类型定义 | 必填 |
第三方渠道相关
const accountApi = new IntlgameAccountApi({
env: "test", // sdk运行的环境，详见下“env说明”
gameID: 11,
});
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| env | string | SDK 环境 更多信息，请参见 获取部署集群信息。 | 必填 |
| gameID | number | Player Network 游戏唯一标识 ID | 必填 |
支持渠道
当前 Player Network SDK 已支持的渠道包括（不限于）：
自建账号
const accountApi = new IntlgameAccountApi({
env: "test", // sdk 运行的环境
gameID: 11, // Player Network 中配置的 Game ID
appID: "", // Player Network 中配置的 APP_ID
accountPlatType: xxx, // 账号平台类型
langType: "en", // 语言
});
| 参数 | 类型 | 描述 | 备注 |
|---|---|---|---|
| env | string | SDK 环境 更多信息，请参见 获取部署集群信息。 | 必填 |
| gameID | number | Player Network 游戏唯一标识 ID | 必填 |
| appID | string | App ID Player Network 控制台分配的 ACCOUNT_APP_ID | 必填 |
| accountPlatType | number | 账号平台类型，用于识别不同的账号平台 | 必填 |
| langType | string | 语言类型 更多信息，请参见 语言类型定义 - 自建账号 | 必填 |
流程逻辑图
账号密码注册
账号注册
第三方账号登录流程
客户端的接入
流程图中 Web 部分是 Web 客户端需要完成的，其中
步骤1：初始化 JSSDK 步骤2：开发用户交互，获取用户的邮箱及密码，调用登录接口 步骤3：处理登录结果，由网站决定是否将登录接口进行持久化存储（存入 cookie 或者 localStorage 等）
后台接入
登录态的鉴权方式需要 Web 客户端传递登录数据给游戏后台，游戏后台到 PNTSDK 后台进行鉴权，处理游戏后台返回的鉴权结果
游戏后台到 PNTSDK 后台的鉴权步骤，参考后台接入指引 后台接入概览
并且需要调用 /v2/auth/verify_login 鉴权接口
API
有关第三方登录 API 的更多信息，请参见：
docs/resources/api/Web/Account/Bind/GetBindChannelsByOpenID
| API | 函数定义 |
|---|---|
| thirdAuthorize | 第三方渠道授权 |
| intlAuthorize | Player Network 账号授权 |
| intlLogout | 登出 |
有关绑定 API 的更多信息，请参见：
| API | 函数定义 |
|---|---|
| 绑定 (bind) | 绑定 |
| 解除绑定 (unbind) | 解除绑定 |
| getBindChannelsByOpenID | 根据 Player Network SDK OpenID 获取绑定列表 |
| getBindChannelsByUid | 根据渠道登录信息获取绑定列表 |
有关映射 API 的更多信息，请参见：
| API | 函数定义 |
|---|---|
| 映射 (map) | 映射 |
| 解除映射 (unmap) | 解除映射 |
| 获取映射列表 (queryMapByCAccInfo) | 根据自建账号登录信息获取映射到该自建账号的渠道列表 |
| 获取映射列表 (queryMapByThirdInfo) | 根据渠道登录信息获取该渠道映射的自建账号 UID |
