Method queryEntities

packages/core/src/Plugins/DebugPlugin.ts:277–320

* 查询实体 * * @param filter - 查询过滤器

(filter: {
        sceneName?: string;
        tag?: number;
        name?: string;
        hasComponent?: string;
    })

     * @param filter - 查询过滤器
     */
    public queryEntities(filter: {
        sceneName?: string;
        tag?: number;
        name?: string;
        hasComponent?: string;
    }): EntityDebugInfo[] {
        if (!this.worldManager) {
            throw new Error('Plugin not installed');
        }

        const results: EntityDebugInfo[] = [];
        const worlds = this.worldManager.getAllWorlds();

        for (const world of worlds) {
            for (const scene of world.getAllScenes()) {
                if (filter.sceneName && scene.name !== filter.sceneName) {
                    continue;
                }

                for (const entity of scene.entities.buffer) {
                    if (filter.tag !== undefined && entity.tag !== filter.tag) {
                        continue;
                    }

                    if (filter.name && !entity.name.includes(filter.name)) {
                        continue;
                    }

                    if (filter.hasComponent) {
                        const hasComp = entity.components.some(
                            (c) => c.constructor.name === filter.hasComponent
                        );
                        if (!hasComp) {
                            continue;
                        }
                    }

                    results.push(this.getEntityInfo(entity));
                }
            }
        }

        return results;
    }

    /**
     * 打印统计信息到日志