概述

账号绑定是 Hub 平台的核心能力，用于将合作方平台用户与世游游戏角色建立关联关系。

绑定完成后，合作方可以查询该用户的角色数据，并向其发放游戏内奖励。

绑定模型

Hub 采用 一对一绑定模型：同一个合作方用户在同一款游戏中，只能绑定一个角色。

绑定关系由以下三要素唯一确定：

• Partner User ID：合作方平台上的用户标识
• Game ID：游戏标识
• Role ID + Server ID：游戏角色标识（服务器 + 角色）

绑定规则

唯一性约束

• 同一 partner_user_id 在同一 game_id 下只能绑定一个角色。
• 同一 role_id（相同区服）在同一 game_id、同一合作方下只能被一个 partner_user_id 绑定。

换绑机制

换绑行为受合作方的 换绑策略 控制：

• 允许换绑（unlimited）：用户可以随时解绑并绑定新角色，无冷却限制。
• 禁止换绑（forbidden）：绑定后不允许解绑或更换角色。
• 冷却期换绑（cooldown）：自上次绑定起，需经过配置的冷却时间后才能换绑新角色。

信息

换绑策略从世游发行平台 Console 每个合作方统一配置。合作方如需调整，请联系世游运营对接人。

隐式换绑

当用户发起新的绑定请求时，如果该用户在该游戏下已有绑定关系，系统会先隐式解绑旧角色，再绑定新角色（前提是换绑策略允许）。合作方无需单独调用解绑接口。

绑定入口

合作方通过调用 获取绑定链接 接口，获得一个带有 Bind Token 的世游通行证页面 URL。将用户引导至该 URL，用户在世游通行证页面完成身份验证和角色选择后，即完成绑定。

绑定完成后，用户会被重定向到合作方提供的 redirect_url。

绑定页面支持从合作方应用内通过 Webview 打开，若合作方不提供 redirect_url ，则需自行实现关闭 Webview 或返回页面功能，使得用户能够回到原应用内页面。