跳到主要内容
Data 与 Schema

本页尚未翻译,当前显示英文版本。

访问控制

每个 Entity 都规定谁可以读、谁可以写,每个 Function 都规定谁可以运行。 访问权限按调用方设置:游戏客户端、你的服务器和云函数。对于 Player 拥有的 Entity,所有权会进一步把客户端限制在自己的 Record 上。Entity 的访问权限在 Schema 的 Entity 编辑器中设置;Function 的访问权限在 Function 的 manifest 中设置。


调用方

调用方身份
Client你的游戏,使用客户端密钥(pk_…)以匿名或已登录 Player 的身份登录。
Server你自己的服务器和工具,使用服务器密钥(sk_…)。
Backend你的云函数,以自己的身份回调平台。

Backoffice 本身不受这些设置约束。


Read 与 Write

每个 Entity 针对每类调用方都有一个 Read 开关和一个 Write 开关。 Write 涵盖所有变更:创建、更新和删除 Record 都算在内。没有单独的删除权限。

调用方ReadWrite
Client关关
Server开开
Backend开开

这是新建 Entity 的默认值:对客户端关闭,对你的服务器和 Function 开放。在你允许之前,客户端既不能读也不能写新的 Entity。

访问权限按固定顺序判定:先看调用方是否可以读或写该 Entity;如果是客户端访问 Player 拥有的 Entity,再看它可以操作哪些 Record。

调用 + 凭据→ 主体权限Read / Write flag否 → 403 forbidden行范围客户端访问 Player 拥有的表仅限自己的行他人的行404 —— 不可见

在 Backoffice 中设置访问权限

打开 Entity 编辑器

在 Schema 中选择该 Entity,点击其名称旁的铅笔图标。新建 Entity 时,同样的设置位于 New ▾ → Entity 中。

设置 Read 和 Write

在 Access control 下,为每类调用方勾选 Read 和 Write。

暂存并应用

点击 Apply changes 暂存修改,然后审阅并应用迁移。访问权限的变更随迁移一起上线。

共享 Entity 上的客户端 Write 让任何 Player 都能修改任何 Record

在不属于 Player 的 Entity 上,客户端 Write 不受任何限制:每个 Player 都能修改或删除每一条 Record。只对本来就要共享的数据开放它,每个 Player 自己的数据请使用 Player 拥有的 Entity。

通过代码设置访问权限

在 Unity 项目中定义的 Entity,通过 [PlayServSchema] 特性设置访问权限,SDK 的 schema 工具会把它与 schema 一起推送。每个开关的取值为 Default、Allow 或 Deny:

using Playserv.Schema;

[PlayServSchema("Pilots",
    OwnedBy = PlayServSchemaOwner.Player,
    Read = PlayServSchemaReadPolicy.Owner,
    OnPlayerDelete = PlayServPlayerDeletePolicy.Anonymise,
    ClientRead = PlayServSchemaAccess.Allow,
    ClientWrite = PlayServSchemaAccess.Allow)]
public class Pilots
{
    public string Callsign;
    public int Level;
}

ServerRead、ServerWrite、BackendRead 和 BackendWrite 以同样的方式设置其他调用方。通过代码设置的访问权限与在 Backoffice 中设置的,存储和执行方式完全相同。从代码推送的 Entity 在 Backoffice 中只读,访问权限也不例外:请在代码中修改。


Player 拥有的 Entity

在 Player 拥有的 Entity 上,Read 和 Write 仍然决定客户端能否访问它,而所有权决定能访问哪些 Record。

客户端……Read access 为 OwnerRead access 为 Public
读取只能读取自己的 Record。没有已登录的 Player 时会被拒绝。所有 Record。
创建创建归其 Player 所有的 Record。没有已登录的 Player 时会被拒绝。同左。
更新或删除只能操作自己的 Record。只能操作自己的 Record。

服务器和 backend 的调用不受限制:它们可以读取、更新和删除任意 Record。要在 Player 拥有的 Entity 中创建 Record,它们需要代表某个 Player 操作,该 Player 即成为 Record 的所有者。

对客户端来说,属于其他 Player 的 Record 是不可见的,而不是被禁止访问:读取、更新或删除它都会返回 404,与不存在的 Record 完全一样。客户端代码无法区分这两种情况,这是有意为之。


游戏客户端中的检查

最终决定权始终在平台。Unity SDK 也会在发送请求前检查访问权限:当它知道某个 Entity 对客户端关闭时,会刷新一次本地缓存的访问设置;如果该 Entity 仍然关闭,就直接在本地以 access-denied 错误让调用失败,而不再发送请求。


Function 的 Execute

每个 Function 都在其 manifest 的 execute 设置中规定哪些调用方可以运行它:client、server 和 backend,各自为 true 或 false,默认全部允许。没有 Execute 权限的调用方会被以 403 拒绝。

Execute 与 Function 的 auth 设置相互独立,后者决定客户端调用是否需要已登录的 Player(player,默认值)或不需要(none)。Backoffice 中 Function 的 Settings 标签页会显示其 auth 设置;Execute 设置只存在于 manifest 中。


调用被拒绝时

返回触发时机检查什么
403 table_read_forbidden调用方无权读取该 Entity。该 Entity 针对此调用方的 Read 开关。
403 table_write_forbidden调用方无权写入该 Entity。该 Entity 针对此调用方的 Write 开关。
403 owner_read_requires_player没有已登录 Player 的客户端读取 Read access 为 Owner 的 Entity。先让 Player 登录。
422 acting_player_required在 Player 拥有的 Entity 中创建 Record,但没有可作为所有者的 Player。让 Player 登录,或代表某个 Player 创建。
404客户端访问其他 Player 的 Record,或不存在的 Record。该 Record 是否属于已登录的 Player。
403 function_execute_forbidden调用方无权运行该 Function。该 Function 的 execute 设置。
401 player_auth_required客户端在没有已登录 Player 的情况下调用需要 Player 的 Function。该 Function 的 auth 设置,或让 Player 登录。
403 player_read_forbidden客户端读取不属于自己的 Player 账号,或者没有已登录的 Player。只读取已登录 Player 自己的账号。

大多数拒绝都归结为两项设置

如果客户端写入被拒绝,先检查该 Entity 的客户端 Write 开关,再检查该 Entity 是否为 Player 拥有、以及该 Record 是否属于已登录的 Player。


后续步骤

更新于 2026年10月16日