XCEngine/docs/api/XCEngine/Components/GameObject/GetLayer.md

GameObject::GetLayer

返回当前对象的 layer 值。

uint8_t GetLayer() const;

行为说明

这个接口直接返回底层 m_layer 的当前值。

按当前实现：

• 默认值是 0
• 原生 SetLayer 会把上界限制到 31
• 托管 GameObject.layer / Component.layer 会先把 int 显式限制到 [0, 31]
• GameObject::Serialize() 与 Scene::SerializeToString() 都会保存这个字段

因此在引擎正常产生的数据路径里，这个值会稳定落在 0..31。

返回值

• uint8_t - 当前对象的 layer。

常见用途

• 渲染层过滤
• 轻量对象分组
• 向脚本层暴露与 Unity 类似的 layer 属性

相关文档

• GameObject
• SetLayer