本页尚未翻译,当前显示英文版本。
管理 Player
Players 列出在顶栏所选 Environment 中登录过游戏的所有账号。 无论通过哪些提供方登录,每个 Player 都只有一个 PlayServ Player ID。在这里,你可以查找 Player,查看其会话、设备和登录尝试,并对其执行暂停、封禁或删除。在侧边栏 Game 下的 Players 中打开它。
页面有四个标签页:Players、Roles(即将推出)、管理登录提供方的 SSO & Auth,以及 History。
Player 列表
可以按名称、邮箱或 Player ID 搜索,并用筛选器缩小列表范围。筛选条件保存在页面地址中,因此筛选后的视图可以分享给他人。
| 筛选器 | 取值 |
|---|---|
| Status | Active、Suspended、Banned |
| Provider | Player 已关联的登录提供方 |
| Last seen | 24 小时、7 天、30 天、90 天,或超过 90 天未活跃 / 从未活跃 |
| 列 | 显示内容 |
|---|---|
| Player | 名称和邮箱。未通过提供方登录的 Player 显示缩短的 Player ID 和 anonymous player;有名称但没有邮箱的显示 no email。 |
| Status | 账号状态,见下文。 |
| SSO | 已关联到该账号的提供方。 |
| Country | 已知时显示 Player 所在国家,通常为空。 |
| Last seen · Joined | 最近一次活动时间,以及账号创建时间。 |
| 状态 | 含义 |
|---|---|
| active | Player 可以登录并游戏。 |
| suspended | 已被登出且无法登录。进度和购买记录保留。 |
| banned | 已被登出且无法登录,其使用过的设备也一并被封禁。 |
| merged | 该账号已合并到另一个账号,不再能登录。 |
勾选 Player 后,可以 Suspend(暂停)、Export(导出为 CSV 文件)或 Remove(永久删除)。拥有阻止删除的数据的 Player 会被跳过(见删除 Player);但确认提示仍会把它们计为已删除,所以操作后请检查一下列表。页头的 Export 会把所有 Player 下载为 CSV 文件,包含 ID、名称、邮箱、状态、提供方、国家、加入日期和最近在线时间。
Player 详情
点击某个 Player 即可打开其详情。 顶部显示名称、邮箱、Player ID 和状态;操作按钮位于底部。
| 标签页 | 显示内容 |
|---|---|
| Overview | 身份信息:Player ID、显示名称、邮箱、国家、加入时间、最近在线时间和最近 IP。随后是关联到该 Player 的账号、可能存在的身份冲突、暂停或封禁的原因,以及设备与封禁。 |
| Auth attempts | 每一次登录尝试,见下文。红色计数标出被拒绝的尝试。 |
| Owned records | 该 Player 拥有行数据的每个数据 Entity,包括行数,以及删除该 Player 时这些行的处理方式。打开某个 Entity 可以分页浏览其行,也可以跳转到 Data 中查看。 |
| Sessions | 该 Player 已登录的设备。 |
| Activity | 该 Player 的生命周期事件:登录、关联提供方、暂停、封禁等。 |
| Permissions | 即将推出。 |
会话
每个会话会显示设备、当前是否在线、位置和 IP、最近活跃时间以及过期时间。Revoke 让该设备退出登录;Revoke all 让该 Player 在所有设备上退出登录。被吊销会话的已打开连接会立即关闭,因此正在对局中的 Player 会断开连接。吊销不会阻止 Player:他们可以再次登录。
设备与封禁
PlayServ 会记录 Player 登录所用每台设备的指纹。指纹只用于与封禁列表比对,从不用于识别回归的 Player。Device & ban enforcement 卡片显示该 Player 的指纹及其设备封禁状态。
| 操作 | 作用 |
|---|---|
| Lift… | 解除一台设备的封禁,必须填写原因。如果账号本身仍处于封禁状态,它依然保持封禁。 |
| Lift all device bans… | 同上,但作用于该 Player 所有被封禁的设备。 |
| Rebind device… | 根据 64 位字符的指纹哈希,为该 Player 记录一台新设备;Player ID 不变。旧设备不会被登出:如果它不应继续保有访问权限,请在 Sessions 中吊销其会话。对话框会在设备已被封禁或属于另一个 Player 时发出 警告,但不会阻止你。可用它找回更换了设备的匿名 Player。 |
登录尝试
| 结果 | 含义 |
|---|---|
| success | Player 已登录。 |
| failed | 凭据有误,例如提供方 token 无效或已过期。 |
| refused | 凭据没有问题,但 PlayServ 拒绝了登录:设备或账号被封禁,或账号被暂停。 |
每次尝试会显示提供方(未使用提供方的登录显示为 Device)、原因、IP、设备指纹和时间。当出现连续被拒绝的尝试时,页面会显示横幅提示,并提供解除设备封禁的快捷入口;来自多个 IP 的集中失败尝试也会被标出。可以按结果或提供方筛选。
暂停、封禁与恢复
| 操作 | 可用状态 | 结果 |
|---|---|---|
| Suspend | Active | Player 立即被登出且无法登录。进度和购买记录保留。原因可选填。 |
| Restore | Suspended | Player 可以再次登录。 |
| Ban… | Active 或 Suspended | Player 被登出且无法登录,其使用过的每 台设备都会被封禁,因此也无法在这些设备上创建新账号。必须填写原因。 |
| Unban | Banned | 账号可以再次登录。原因可选填。 |
列表中每一行的 ⋯ 菜单里也有相同的操作。每次操作都会连同操作人和原因记录在 History 中。
打开 Ban
在 Player 详情中点击 Ban…。
填写原因
输入封禁该 Player 的原因。原因为必填项,之后会显示在 Player 详情中。
确认
输入该 Player 的显示名称(如果没有名称,则输入其 Player ID),然后点击 Ban permanently。
Unban 不会解封设备
Unban 只恢复账号。随账号一起被封禁的设备会保持封禁,直到你在 Device & ban enforcement 中解除,因此使用被封禁设备的 Player 仍然无法登录。
关联账号与冲突
一个 Player,多个提供方。 Player 可以把 Google、Apple、Epic 等提供方关联到同一个 Player ID,并用其中任意一个登录。
每个提供方下,一个 Player 最多只有一个账号:在第一个 Google 账号解除关联之前,无法再为同一 Player 关联第二个 Google 账号。已关联账号旁的 Unlink 会将其从该 Player 上移除。Player 必须至少保留一个账号:最后一个账号旁仍会显示 Unlink,但解除关联会失败。
PlayServ 从不自行合并账号。当 Player 尝试关联的提供方账号已经登录过另一个 Player 时,两个账号都保持原样,并在该 Player 的 Overview 中显示身份冲突。通过 Review… 你可以:
| 选项 | 结果 |
|---|---|
| Keep both | 不做任何更改;可以添加备注。 |
| 从当前 Player 上 Unlink | 该提供方账号留在另一个 Player 上。 |
| 从另一个 Player 上 Unlink | 该提供方账号被释放, 可供当前 Player 使用。 |
合并两个账号只能由 Player 自己在游戏中完成,并且需要证明自己同时控制这两个账号:见 User Login。
合并转移的是登录方式,不是游戏数据
两个账号合并时,已关联的提供方会转移到保留下来的账号上,另一个账号变为 merged。被合并账号的进度、购买记录及其拥有的数据仍留在它自己名下,不会被复制。如果被合并账号处于封禁状态,保留下来的账号也会被封禁。
删除 Player
Delete player… 会永久清除该 Player,例如应对 GDPR 请求:包括账号、会话和已关联的提供方。确认之前,对话框会按 Entity 逐一列出该 Player 所拥有数据的处理方式,依据是每个 Entity 的 on-delete 设置:
| Entity 设置 | 该 Player 的行 |
|---|---|
cascade-delete | 被删除。 |
anonymise | 保留,但去掉与该 Player 的关联。 |
restrict | 保留;只要还存在这样的行,删除就会被阻止。请先移除这些行。 |
输入该 Player 的显示名称(如果没有名称,则输入其 Player ID)进行确认。
删除 Player 无法撤销
删除后无法恢复。如果只是暂时不让该 Player 登录,请改用暂停。
详情底部的 Export data 会把该 Player 的概要下载为 CSV 文件。其拥有的数据列在 Owned records 中。
历史记录
History 列出该 Project 最新的 100 条 Player 生命周期事件,按时间从新到旧排列:登录、关联与解除关联提供方、身份冲突及其解决方式、暂停、封禁及其撤销、解除设备封禁、合并以及删除 Player。你可以搜索这些事件,或按时间范围筛选;两者都只作用于这 100 条事件。
后续步骤
- SSO & Auth —— Player 用来登录的提供方
- 用户登录 —— 在游戏中让 Player 登录
- Schema Object Reference —— 被拥有的数据,以及删除 Player 时它们的处理方式
更新于 2026年10月16日