@xtctwins/tctwins-bimx-engine 0.3.7 → 0.3.8

package/dist/{tallPanel-CHmr0WiN.mjs → tallPanel-CBDkSWkE.mjs}

@@ -1,4 +1,4 @@
-import { o as g, p as t, T as r, A as y, B as x, x as S, y as b } from "./index-B9qL5nx5.mjs";
+import { o as g, p as t, T as r, A as y, B as x, x as S, y as b } from "./index-Bv-246pp.mjs";
 import { defineComponent as k, ref as c, onMounted as P, watch as W, openBlock as _, createElementBlock as f, normalizeStyle as w, createElementVNode as o, toDisplayString as C, createVNode as T, unref as h, renderSlot as N, createCommentVNode as B } from "vue";
 const E = { class: "tall_panel_content" }, $ = { class: "panel_top" }, H = { class: "panel_title" }, L = { class: "panel_close" }, A = { class: "panel_content" }, M = {
   key: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xtctwins/tctwins-bimx-engine",
-	"version": "0.3.7",
+	"version": "0.3.8",
 	"main": "dist/BIMX_Viewer_Lib.umd.js",
 	"style": "dist/style.css",
 	"module": "dist/BIMX_Viewer_Lib.es.js",
@@ -38,7 +38,7 @@
 		"@vue/eslint-config-prettier": "^9.0.0",
 		"@vue/eslint-config-typescript": "^13.0.0",
 		"@vue/tsconfig": "^0.5.1",
-		"@xtctwins/tctwins-bimx-viewer": "^1.1.3",
+		"@xtctwins/tctwins-bimx-viewer": "^1.1.4",
 		"ali-oss": "^6.20.0",
 		"axios": "^1.7.3",
 		"element-plus": "^2.8.0",

package/types/components/BimxViewerComp.vue.d.ts

@@ -12,9 +12,7 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
     loadSequential?: boolean;
-    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
     loadInterval?: number;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     emitHandler: (...args: any[]) => void;
@@ -31,9 +29,7 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
     loadSequential?: boolean;
-    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
     loadInterval?: number;
 }> & Readonly<{
     onEmitHandler?: ((...args: any[]) => any) | undefined;

package/types/pages/BimxViewerEntry.vue.d.ts

@@ -14,9 +14,7 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
     loadSequential?: boolean;
-    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
     loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
@@ -76,9 +74,7 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
     loadSequential?: boolean;
-    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
     loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;

package/types/viewerManager/load/loadModel.d.ts

@@ -22,9 +22,9 @@ export interface ModelLoaderConfig {
     loadMeta?: boolean;
     /** 事件回调：modelLoaded / metaLoading / metaLoaded */
     emit?: (event_name: string, content: any) => void;
-    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 间隔依次发起，默认 true */
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 各自就绪即加载（默认推荐），默认 true */
     sequential?: boolean;
-    /** 非顺序加载时，发起下一个模型的间隔毫秒数，默认 200 */
+    /** 非顺序加载时的发起间隔毫秒数（仅作节流），默认 0 表示不节流 */
     loadInterval?: number;
 }
 /**
@@ -42,8 +42,9 @@ export default function viewerLoadModel(modelId: string, modelType: string, mode
  * 模型加载器：统一封装「下载 -> 引擎加载 -> meta 加载」。
  *
  * 相比逐模型串行「下载-加载」，这里会：
- *  - 多模型时先并发下载全部模型 + meta，再串行交给引擎（消除模型间的网络间隔）；
- *  - 单文件（model + meta）也是并发下载；
+ *  - 顺序加载时用流水线预取：下载第 i 个模型的同时加载第 i-1 个，让网络与解析重叠；
+ *  - 非顺序加载时所有模型并发下载、就绪即加载；
+ *  - 单文件（model + meta）并发下载；
  *  - OSS STS client 在 OSSHelper 内缓存复用，不再每个文件都申请一次凭证。
  */
 export declare class ModelLoader {
@@ -52,7 +53,7 @@ export declare class ModelLoader {
     private emit;
     /** 多模型是否顺序加载（默认 true） */
     private sequential;
-    /** 非顺序加载的发起间隔（毫秒，默认 200） */
+    /** 非顺序加载的发起间隔（毫秒，默认 0 = 不节流） */
     private loadInterval;
     private metaBuffer?;
     private metaReady;
@@ -76,17 +77,21 @@ export declare class ModelLoader {
     private loadMetadata;
     /** 绑定引擎 meta 事件（只绑一次），转发给 emit */
     private bindMetaEvents;
-    /** 按路径加载单个模型：并发下载 model + meta，下载完再引擎加载 */
+    /** 按路径加载单个模型：并发下载 model + meta，下载完再引擎加载；下载失败不抛异常 */
     loadFromPath(modelId: string, filePath: string, options?: Record<string, any>): Promise<ModelLoadResult | undefined>;
     /** 下载 meta（.xts）；失败不阻断主流程 */
     private downloadMeta;
+    /** 准备单个模型：并发下载 model + meta，返回可直接加载的数据；下载失败 buffer 为空（不抛异常） */
+    private prepareItem;
     /**
-     * 多模型加载：先并发下载全部模型（含 meta），再交给引擎加载。
+     * 多模型加载。
      *
-     * 引擎加载调度由 config.sequential 决定：
-     *  - sequential=true（默认）：等待每个模型加载完成后再加载下一个（原循环方式）；
-     *  - sequential=false：不等每个模型加载完成，按 loadInterval 毫秒间隔依次发起下一个。
-     * @returns 每个模型的加载结果
+     * sequential=true：一个一个来，等当前模型 loaded 后再加载下一个。
+     * sequential=false（对齐 xtctwins 示例用法）：所有模型同时开始下载，
+     *   「谁的 buffer 先到就立即加载谁」，互不等待、默认不插入任何延迟。
+     *   这样下载与解析天然重叠，是引擎下最快的加载方式。
+     *
+     * loadInterval 仅作为可选的发起节流（默认 0 不节流）。
      */
     loadMulti(items: ModelLoadItem[]): Promise<ModelLoadResult[]>;
     /** 延迟指定毫秒数 */