本页尚未翻译,当前显示英文版本。
构建游戏 Schema
Schema 在 Schema 页面中构建,每项变更都通过迁移上线。 创建对象或编辑字段并不会立即生效,而是先暂存起来。准备好之后,把暂存的变更作为一次迁移来审阅并应用。在侧边栏 Engineering 下的 Schema 中打开它;它作用于顶栏所选的 Environment。
页面有三个标签页:Diagram 以图的形式展示整个 schema;Table view 展示单个对象及其字段;History 列出迄今为止已应用的迁移。在图中点击某个对象,会在 Table view 中打开它。对象和字段类别的说明见 Schema Object Reference。
先规划结构
动手创建之前,先梳理游戏要存储什么:哪些事物独立存在(Entity),哪些字段组会重复出现(Part),哪些值来自固定列表(Enum)。按这个顺序创建,先建 Enum 和 Part,这样在添加使用它们的字段时就可以直接选择。
| 常见错误 | 正确做法 |
|---|---|
| 用 Relationship 链接一个属于父对象的结构 | 用 Inclusion 嵌入它:ship 的 stats 属于这艘 ship。 |
| 用 Inclusion 嵌入一个独立存在的事物 | 用 Relationship 链接它:pilot 指向一艘可被许多 pilot 共享的 ship。 |
| 在多个 Entity 中重复同一组字段 | 把这组字段放进一个 Part,并在各处包含它。 |
| 用自由文本字段存放来自固定列表 的值 | 使用 Enum reference。 |
创建对象
选择类型
点击 New ▾,选择 Entity、Part 或 Enum。
填写内容
为它命名;如果是 Enum,还要填写取值。如果是 Entity,还要选择其设置:单例、访问权限和 Player 所有权。显示字段要等 Entity 有了字段之后再设置。
暂存
点击 Stage entity、Stage part 或 Stage enum。该对象会出现在 schema 中并标记为未保存,变更等待审阅。
添加字段
打开对象
在 Table view 中选择 Entity 或 Part,然后点击 Add field。
选择类别
选择 Primitive 及其类型、Enum reference 及对应的 Enum、Relationship → entity 及目标 Entity,或 Inclusion ↳ part 及对应的 Part。对于 Relationship 或 Inclusion,选择 1-to-1 或 1-to-many。
完成设置
为字段命名,可以选填 Default,并设置 Required、Unique 和 Indexed 约束。见字段设置。
添加
点击 Add field。和其他编辑一样,它在应用之前都处于暂存状态。
在 Table view 中,每个对象还会显示它在哪里被使用:Entity 显示 Referenced by,Part 显示 Included in,Enum 显示 Used by。
审阅并应用变更
暂存的变更会作为一次迁移一起上线。 只要有暂存内容,页头就会显示 Discard 和 Review migration;暂存的对象超过一个时,还会显示数量。
打开审阅
点击 Review migration。对话框会列出每项变更及其对现有数据的影响。