# 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)