@xtctwins/tctwins-bimx-engine 0.3.6 → 0.3.8

package/dist/{tallPanel-_5WiJEu-.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-DK7roCJZ.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.6",
+	"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.2",
+		"@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,6 +12,8 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
+    loadSequential?: boolean;
+    loadInterval?: number;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     emitHandler: (...args: any[]) => void;
 }, string, import('vue').PublicProps, Readonly<{
@@ -27,6 +29,8 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
+    loadSequential?: boolean;
+    loadInterval?: number;
 }> & Readonly<{
     onEmitHandler?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

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

@@ -14,6 +14,8 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
+    loadSequential?: boolean;
+    loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
     bottomHeight?: number;
@@ -72,6 +74,8 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
+    loadSequential?: boolean;
+    loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
     bottomHeight?: number;

package/types/utils/OSSHelper.d.ts

@@ -1,5 +1,7 @@
 export default class OSSHelper {
     static getBuffer(filePath: string, done: Function, error?: Function): Promise<void>;
+    /** 下载单个文件并返回 ArrayBuffer（Promise 风格，便于并发） */
+    static fetchBuffer(filePath: string): Promise<ArrayBuffer>;
     static requestFileFromOSS(filePath: string, isFile: boolean, done: Function, error: Function): Promise<void>;
     static downloadFile(filePath: string): Promise<ArrayBuffer>;
 }

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

@@ -1,3 +1,32 @@
+export interface ModelLoadResult {
+    code: 200 | -1;
+    result: string;
+    msg?: string;
+}
+export interface ModelLoadItem {
+    /** 模型 ID；为空时由 filePath 推导 */
+    modelId?: string;
+    /** 下载来源路径（http 完整地址 或 OSS 相对地址），为空表示直接使用 buffer */
+    filePath?: string;
+    /** 已下载好的模型二进制（filePath 为空时必填） */
+    buffer?: ArrayBuffer;
+    /** 已就绪的 meta 二进制（可选） */
+    metaBuffer?: ArrayBuffer;
+    /** 透传引擎 cfg：{ position, scale, rotation, matrix, origin, brightness, ... } */
+    options?: Record<string, any>;
+}
+export interface ModelLoaderConfig {
+    /** 模型类型（xtc / glb / ifc），默认 xtc */
+    modelType?: string;
+    /** 是否加载 meta（.xts）；不传则运行时取 getConfig("loadMeta") */
+    loadMeta?: boolean;
+    /** 事件回调：modelLoaded / metaLoading / metaLoaded */
+    emit?: (event_name: string, content: any) => void;
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 各自就绪即加载（默认推荐），默认 true */
+    sequential?: boolean;
+    /** 非顺序加载时的发起间隔毫秒数（仅作节流），默认 0 表示不节流 */
+    loadInterval?: number;
+}
 /**
  * BIMX 模型加载
  * @param modelId 模型 ID
@@ -9,3 +38,62 @@
  *                - position / rotation / scale / origin / alignTo: 多模型坐标对齐参数
  */
 export default function viewerLoadModel(modelId: string, modelType: string, modelArrayBuffer: ArrayBuffer, callback?: Function, options?: Record<string, any>): void;
+/**
+ * 模型加载器：统一封装「下载 -> 引擎加载 -> meta 加载」。
+ *
+ * 相比逐模型串行「下载-加载」，这里会：
+ *  - 顺序加载时用流水线预取：下载第 i 个模型的同时加载第 i-1 个，让网络与解析重叠；
+ *  - 非顺序加载时所有模型并发下载、就绪即加载；
+ *  - 单文件（model + meta）并发下载；
+ *  - OSS STS client 在 OSSHelper 内缓存复用，不再每个文件都申请一次凭证。
+ */
+export declare class ModelLoader {
+    private modelType;
+    private loadMetaOverride?;
+    private emit;
+    /** 多模型是否顺序加载（默认 true） */
+    private sequential;
+    /** 非顺序加载的发起间隔（毫秒，默认 0 = 不节流） */
+    private loadInterval;
+    private metaBuffer?;
+    private metaReady;
+    private metaEventsBound;
+    private pendingMetaModel?;
+    constructor(config?: ModelLoaderConfig);
+    /** 运行时判断是否加载 meta（跟随 config，避免 setup 阶段 getConfig 尚未就绪） */
+    private getLoadMeta;
+    /** viewer 销毁/重建时重置内部 meta 状态 */
+    reset(): void;
+    /** 外部传入已就绪的 meta buffer（单模型外部 buffer 场景，可能晚于模型到达） */
+    setMetaBuffer(buffer?: ArrayBuffer): void;
+    /** 下载单个文件（http 直连 / OSS），返回 Promise<ArrayBuffer> */
+    private fetch;
+    /** 模型主体下载路径：http 直接用原地址；OSS 补上 .xtc 等类型后缀 */
+    private downloadModelPath;
+    /** 加载单个已就绪 buffer 的模型到引擎，模型成功后自动处理 meta */
+    loadSingle(modelId: string, buffer: ArrayBuffer, metaBuffer?: ArrayBuffer, options?: Record<string, any>): Promise<ModelLoadResult>;
+    /** 引擎模型加载成功后处理 meta：可用则立即加载，否则挂起等 setMetaBuffer */
+    private handleMetaAfterModelLoad;
+    private loadMetadata;
+    /** 绑定引擎 meta 事件（只绑一次），转发给 emit */
+    private bindMetaEvents;
+    /** 按路径加载单个模型：并发下载 model + meta，下载完再引擎加载；下载失败不抛异常 */
+    loadFromPath(modelId: string, filePath: string, options?: Record<string, any>): Promise<ModelLoadResult | undefined>;
+    /** 下载 meta（.xts）；失败不阻断主流程 */
+    private downloadMeta;
+    /** 准备单个模型：并发下载 model + meta，返回可直接加载的数据；下载失败 buffer 为空（不抛异常） */
+    private prepareItem;
+    /**
+     * 多模型加载。
+     *
+     * sequential=true：一个一个来，等当前模型 loaded 后再加载下一个。
+     * sequential=false（对齐 xtctwins 示例用法）：所有模型同时开始下载，
+     *   「谁的 buffer 先到就立即加载谁」，互不等待、默认不插入任何延迟。
+     *   这样下载与解析天然重叠，是引擎下最快的加载方式。
+     *
+     * loadInterval 仅作为可选的发起节流（默认 0 不节流）。
+     */
+    loadMulti(items: ModelLoadItem[]): Promise<ModelLoadResult[]>;
+    /** 延迟指定毫秒数 */
+    private sleep;
+}