docs: expand gameobject helper docs
This commit is contained in:
@@ -1,30 +1,26 @@
|
||||
# GameObject::Awake
|
||||
|
||||
公开方法,详见头文件声明。
|
||||
向当前对象的普通组件分发 `Awake()`。
|
||||
|
||||
```cpp
|
||||
void Awake();
|
||||
```
|
||||
|
||||
该方法声明于 `XCEngine/Components/GameObject.h`,当前页面用于固定 `GameObject` 类目录下的方法级 canonical 路径。
|
||||
## 行为说明
|
||||
|
||||
**参数:** 无。
|
||||
当前实现会遍历 `m_components`,并对每个普通组件调用 `Awake()`。
|
||||
|
||||
**返回:** `void` - 无返回值。
|
||||
需要注意:
|
||||
|
||||
**示例:**
|
||||
- 它不会递归调用子对象的 `Awake()`
|
||||
- `TransformComponent` 不在 `m_components` 中,因此不会在这里收到 `Awake()`
|
||||
|
||||
```cpp
|
||||
#include <XCEngine/Components/GameObject.h>
|
||||
## 典型触发路径
|
||||
|
||||
void Example() {
|
||||
XCEngine::Components::GameObject object;
|
||||
// 根据上下文补齐参数后调用 GameObject::Awake(...)。
|
||||
(void)object;
|
||||
}
|
||||
```
|
||||
- `Scene::CreateGameObject()` 创建对象后会立即调用它
|
||||
- 用户也可以手工直接调用,但这不等价于完整场景创建流程
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [返回类总览](GameObject.md)
|
||||
- [返回模块目录](../Components.md)
|
||||
- [Start](Start.md)
|
||||
- [Scene::CreateGameObject](../../Scene/Scene/CreateGameObject.md)
|
||||
|
||||
Reference in New Issue
Block a user