格式说明

Unity 的场景格式通过 YAML 数据序列化语言实现。虽然不能在这里深入了解 YAML,但它是一种开发的格式,可以在 YAML 网站免费获得其规范。场景中的每个对象都作为独立 YAML 文档写入文件,并按照 --- 顺序在文件中进行介绍。请注意:在这种情况下,“对象”是游戏对象 (GameObjects)、组件和其他场景数据的统称,其中每个项目都在场景文件中包含有自己的 YAML 文件。可通过以下示例了解序列化对象的基本结构:

--- !u!1 &6
GameObject:
  m_ObjectHideFlags: 0
  m_PrefabParentObject: {fileID: 0}
  m_PrefabInternal: {fileID: 0}
  importerVersion: 3
  m_Component:
  - 4: {fileID: 8}
  - 33: {fileID: 12}
  - 65: {fileID: 13}
  - 23: {fileID: 11}
  m_Layer: 0
  m_Name: Cube
  m_TagString: Untagged
  m_Icon: {fileID: 0}
  m_NavMeshLayer: 0
  m_StaticEditorFlags: 0
  m_IsActive: 1

第一行在文档标记后包含字符串 "!u!1 &6"。"!u!" 部分之后的第一个数字是指对象的类(在本示例中表示游戏对象 (GameObject))。连字符后面的数字是指对象 ID 编号,虽然该数字会任意分配至每个对象,但在文件中是惟一的。每个对象的序列化属性用如下所示的行表示:

m_Name: Cube

属性通常以 "m_" 为前缀,但除此之外还需遵循脚本引用中定义的属性名称。如需在文件中继续定义第二个对象,则可以使用以下代码:-

--- !u!4 &8
Transform:
  m_ObjectHideFlags: 0
  m_PrefabParentObject: {fileID: 0}
  m_PrefabInternal: {fileID: 0}
  m_GameObject: {fileID: 6}
  m_LocalRotation: {x: 0.000000, y: 0.000000, z: 0.000000, w: 1.000000}
  m_LocalPosition: {x: -2.618721, y: 1.028581, z: 1.131627}
  m_LocalScale: {x: 1.000000, y: 1.000000, z: 1.000000}
  m_Children: []
  m_Father: {fileID: 0}

这是附加至上述 YAML 文档定义的游戏对象 (GameObjects) 的变换 (Transfrom) 组件。附件用下列行表示:-

m_GameObject: {fileID: 6}

…该文件内游戏对象 (GameObject) 的对象 ID 是 6。

浮点数字可以用十进制表示法或 IEE 754 格式的十六进制数字(前缀用 0x 表示)表示。IEE 754 用来表示值的无损编码,且 Unity 会在写入没有简短十进制表示的浮点值时使用它。Unity 编写十六进制数字时,会始终在括号中写下十进制数字,用于调试,但在加载文件时,只会对十六进制数字进行解析。若要手动编辑此类值,只需删除十六进制数并仅输入十进制数。以下表示的是一些有效的浮点值(所有值都表示数字 1):

myValue: 0x3F800000
myValue: 1
myValue: 1.000
myValue: 0x3f800000(1)
myValue: 0.1e1

Page last updated: 2013-06-28