Method notifyEntityComponentChanged

packages/core/src/ECS/Scene.ts:658–687

* 通知相关系统实体的组件发生了变化 * * 这是事件驱动设计的核心：当组件被添加或移除时，立即通知相关系统检查该实体是否匹配， * 并触发 onAdded/onRemoved 回调。通过组件ID索引优化，只通知关心该组件的系统。 * * This is the core of event-driven design: when a component is added or removed, * immediately notify relevant systems to check if the entity matches an

(entity: Entity, changedComponentType?: ComponentType)

     * @param changedComponentType 变化的组件类型（可选） | The changed component type (optional)
     */
    public notifyEntityComponentChanged(entity: Entity, changedComponentType?: ComponentType): void {
        const notifiedSystems = new Set<EntitySystem>();

        if (changedComponentType && this.componentRegistry.isRegistered(changedComponentType)) {
            const componentId = this.componentRegistry.getBitIndex(changedComponentType);
            const interestedSystems = this._componentIdToSystems.get(componentId);

            if (interestedSystems) {
                for (const system of interestedSystems) {
                    system.handleEntityComponentChanged(entity);
                    notifiedSystems.add(system);
                }
            }
        }

        for (const system of this._globalNotifySystems) {
            if (!notifiedSystems.has(system)) {
                system.handleEntityComponentChanged(entity);
                notifiedSystems.add(system);
            }
        }

        if (!changedComponentType) {
            for (const system of this.systems) {
                if (!notifiedSystems.has(system)) {
                    system.handleEntityComponentChanged(entity);
                }
            }
        }
    }

    /**
     * 将系统添加到组件索引