Method queryAny

packages/core/src/ECS/Core/QuerySystem.ts:383–402

* 查询包含任意指定组件的实体 * * 返回包含任意一个指定组件类型的实体列表。 * 内部使用响应式查询作为智能缓存,自动跟踪实体变化,性能更优。 * * @param componentTypes 要查询的组件类型列表 * @returns 查询结果，包含匹配的实体和性能信息 * * @example * ```typescript * // 查询具有武器或护甲组件的实体 * const result = querySystem.queryAny(WeaponComponent, A

(...componentTypes: ComponentType[])

     * ```
     */
    public queryAny(...componentTypes: ComponentType[]): QueryResult {
        const startTime = performance.now();
        this._queryStats.totalQueries++;

        // 使用内部响应式查询作为智能缓存
        const reactiveQuery = this.getOrCreateReactiveQuery(QueryConditionType.ANY, componentTypes);

        // 从响应式查询获取结果(永远是最新的)
        const entities = reactiveQuery.getEntities();

        // 统计为缓存命中(响应式查询本质上是永不过期的智能缓存)
        this._queryStats.cacheHits++;

        return {
            entities,
            count: entities.length,
            executionTime: performance.now() - startTime,
            fromCache: true
        };
    }

    /**
     * 查询不包含任何指定组件的实体