本页尚未翻译,当前显示英文版本。
Schema 对象参考
Schema 由三类对象构成,对象又由字段构成。 Entity 存放游戏的 Record,Part 是 Entity 内部可复用的字段组,Enum 是固定的取值列表。本页是它们的参考说明;如何创建它们,见 Building a Game Schema。
Entity、Part 与 Enum
| 对象 | 是什么 | 有无自己的 Record | 示例 |
|---|---|---|---|
| Entity | 独立对象:游戏读写的一张 Record 表。 | 有,列在 Data 中 | Ships、Pilots、MatchResults |
| Part | 可复用的字段组,只存在于 Entity 或另一个 Part 内部。 | 没有,其值存放在包含它的 Record 中 | Stats、Loadout |
| Enum | 字段允许取值的固定列表。 | 没有 | ShipClass:Fighter、Bomber、Scout |
字段类别
每个字段都有一个类别,它决定字段存储什么。
| 类别 | 存储内容 | 目标 | 基数 |
|---|---|---|---|
| Primitive | 直接存储一个值,类型为某种基本类型。 | — | 单个值 |
| Enum reference | Enum 中的一个值。 | 一个 Enum | 单个值 |
| Relationship → entity | 通过 ID 链接到另一个 Entity 的 Record。 | 一个 Entity | 一对一或一对多 |
| Inclusion ↳ part | 嵌入到当前 Record 中的 Part 字段。 | 一个 Part | 一对一或一对多 |
Relationship 和 Inclusion 都用于连接对象,但方式不同。Relationship 指向一条独立存在、可以共享的 Record:一个 pilot 指向一艘 ship,许多 pilot 可以指向同一艘 ship。Inclusion 嵌入的结构属于其父对象,没有独立的生命周期:一艘 ship 的 Stats 只作为这艘 ship 的一部分存在。
基本类型
| 类型 | 存储内容 |
|---|---|
| Text | 短字符串 |
| Long text | 多行字符串 |
| Integer | 整数 |
| Number | 浮点数 |
| Decimal | 定点精度数 |
| Boolean | true 或 false |
| Date & time | ISO 时间戳 |
| Date | 日期,YYYY-MM-DD |
| UUID | 唯一标识符 |
| JSON | 结构化对象 |
| 经过校验的邮箱地址 | |
| URL | 链接 |
字段设置
| 设置 | 含义 |
|---|---|
| Name |