36 lines
773 B
Markdown
36 lines
773 B
Markdown
# GameObject::GetLayer
|
|
|
|
返回当前对象的 layer 值。
|
|
|
|
```cpp
|
|
uint8_t GetLayer() const;
|
|
```
|
|
|
|
## 行为说明
|
|
|
|
这个接口直接返回底层 `m_layer` 的当前值。
|
|
|
|
按当前实现：
|
|
|
|
- 默认值是 `0`
|
|
- 原生 [SetLayer](SetLayer.md) 会把上界限制到 `31`
|
|
- 托管 `GameObject.layer` / `Component.layer` 会先把 `int` 显式限制到 `[0, 31]`
|
|
- `GameObject::Serialize()` 与 `Scene::SerializeToString()` 都会保存这个字段
|
|
|
|
因此在引擎正常产生的数据路径里，这个值会稳定落在 `0..31`。
|
|
|
|
## 返回值
|
|
|
|
- `uint8_t` - 当前对象的 layer。
|
|
|
|
## 常见用途
|
|
|
|
- 渲染层过滤
|
|
- 轻量对象分组
|
|
- 向脚本层暴露与 Unity 类似的 `layer` 属性
|
|
|
|
## 相关文档
|
|
|
|
- [GameObject](GameObject.md)
|
|
- [SetLayer](SetLayer.md)
|