Method getComponent

packages/core/src/ECS/Entity.ts:517–530

* @zh 获取指定类型的组件 * @en Get component of specified type * * @param type - @zh 组件类型构造函数 @en Component type constructor * @returns @zh 组件实例，如果不存在则返回null @en Component instance, or null if not found * * @example * ```typescript * const position = entity.getComponen

(type: ComponentType<T>)

     * ```
     */
    public getComponent<T extends Component>(type: ComponentType<T>): T | null {
        // 快速检查：位掩码
        if (!this.hasComponent(type)) {
            return null;
        }

        // 从Scene存储获取
        if (!this.scene?.componentStorageManager) {
            return null;
        }

        const component = this.scene.componentStorageManager.getComponent(this.id, type);
        return component as T | null;
    }

    /**
     * @zh 检查实体是否拥有指定类型的组件