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

GameObject::AddComponent

为当前对象添加一个普通组件，或返回已有的内建 Transform。

template<typename T, typename... Args>
T* AddComponent(Args&&... args);

行为说明

当前模板实现分两条路径：

• 如果 T 继承自 TransformComponent
  • 直接返回已有 m_transform
  • 不会创建第二个 Transform
• 否则
  • 构造一个新的组件实例
  • 回填 component->m_gameObject = this
  • 放入 m_components
  • 返回新组件指针

当前不会自动发生什么

运行时添加普通组件时，当前实现不会自动补发：

• Awake()
• Start()
• OnEnable()

这是当前对象系统最重要的现实边界之一。组件挂载完成，不等于它已经追平生命周期进度。

所有权语义

• 普通组件的所有权由 GameObject 内部 std::unique_ptr<Component> 接管
• 返回值只是观察指针
• 调用方不应自行 delete

相关文档

• GameObject
• GetComponent
• RemoveComponent
• GetTransform