@shijiu/jsview-vue 2.1.200 → 2.1.339-test.0

package/utils/JsViewEngineWidget/MetroWidget/RenderItem.ts

@@ -1,4 +1,4 @@
-import { ref } from "vue";
+import { ref, computed } from "vue";
 import type { Ref } from "vue";
 import { TemplateItem } from "../TemplateParser/MetroTemplate"
 
@@ -21,6 +21,7 @@ interface CustomerCallbackMap {
   onFocus?: (rect: object) => void,
   onBlur?: () => void,
   onClick?: () => void,
+  onTap?: () => void,
   onWidgetEdge?: (rect: object) => void,
 }
 
@@ -35,6 +36,7 @@ export class RenderItem {
   public mounted: Ref<boolean> = ref(false);
   public touchInit: boolean = false;
   public rootDiv: HTMLDivElement | null = null;
+  public enableTap: boolean = false;
 
   private customerCallbackMap: CustomerCallbackMap = {};
   private onRef: (() => void) | null;
@@ -112,6 +114,10 @@ export class RenderItem {
     }
   }
 
+  public readonly onTap = computed(() => {
+    return this.enableTap ? { click: this.onClick.bind(this) } : {};
+  })
+
   public onClick(): boolean {
     if (this.mounted.value) {
       this.customerCallbackMap.onClick?.();
@@ -143,6 +149,10 @@ export class RenderItem {
       })
     }
     this.divMountedCallback = [];
+    if (this.enableTap && this.rootDiv) {
+      const divView = (this.rootDiv as any).jsvGetProxyView();
+      divView.DragEnables?.(0x01); // 只激活tap
+    }
   }
 
   private onDivUnmounted(): void {

package/utils/JsViewEngineWidget/MetroWidget/SlotComponent.vue

@@ -0,0 +1,13 @@
+<template>
+  <div><slot /></div>
+</template>
+
+<script setup>
+import { onBeforeUpdate } from "vue";
+onBeforeUpdate(() => {
+  console.log("onBeforeUpdate");
+  return false;
+});
+</script>
+
+<style scoped></style>

package/utils/JsViewEngineWidget/TemplateParser/CommonMetroTemplate.ts

@@ -201,7 +201,7 @@ class CommonMetroTemplate extends MetroTemplate {
     }
   }
 
-  public addItem(itemObj: MeasureInfo): TemplateItem {
+  public addItemInner(itemObj: MeasureInfo): TemplateItem {
     const templateItem = MetroTemplate.getTemplateItem(itemObj);
     // Layout template items
     const fenceStack = this._FenceStack;

package/utils/JsViewEngineWidget/TemplateParser/ListMetroTemplate.ts

@@ -11,7 +11,7 @@ class ListMetroTemplate extends MetroTemplate {
 
   public calculateNeighborWhenAddStop(): void { }
 
-  public addItem(itemObj: MeasureInfo): TemplateItem {
+  public addItemInner(itemObj: MeasureInfo): TemplateItem {
     const templateItem = MetroTemplate.getTemplateItem(itemObj);
     this._addTemplateItem(templateItem);
     this.tailItemIndex = templateItem.index;

package/utils/JsViewEngineWidget/TemplateParser/MetroTemplate.ts

@@ -1,5 +1,6 @@
 import { checkType, toRawType, getTypeName } from "../CheckType.js";
 import { METRO_WIDGET } from "../MetroWidget/Const";
+import { VERTICAL } from "../WidgetCommon";
 
 const TAG = "MetroTemplate";
 
@@ -160,6 +161,7 @@ interface TemplateItem {
   }
   findNextAnchor: FindNextAnchor | null,
   layoutCache: { top: number, left: number, width: number, height: number } | null,
+  uid?: string,
 }
 
 interface MeasureInfo {
@@ -175,11 +177,13 @@ interface MeasureInfo {
   itemSlide?: number,
   permanent?: boolean,
   zIndex?: number | object,
+  uid?: string,
 }
 
 abstract class MetroTemplate {
   protected supportHistoryPath: boolean;
   protected idsMap: Array<number>;
+  protected uidMap: Object;
   public templateList: Array<TemplateItem>;
   public readonly direction: Symbol;
   public readonly lineMax: number;
@@ -196,6 +200,7 @@ abstract class MetroTemplate {
     this.layoutType = layoutType
     this.pageSize = pageSize;
     this.supportHistoryPath = supportHistoryPath;
+    this.uidMap = {};
   }
 
   get size(): number {
@@ -247,9 +252,22 @@ abstract class MetroTemplate {
     return item ? item : null;
   }
 
+  public getItemByUid(uid: string): TemplateItem | null {
+    return this.uidMap[uid];
+  }
+
   public abstract calculateNeighborWhenAddStop(): void;
 
-  public abstract addItem(itemObj: MeasureInfo): TemplateItem;
+  public abstract addItemInner(itemObj: MeasureInfo): TemplateItem;
+
+  public addItem(itemObj: MeasureInfo): TemplateItem {
+    const item = this.addItemInner(itemObj);
+    //检查uid
+    if (itemObj.uid) {
+      this.uidMap[itemObj.uid] = item;
+    }
+    return item;
+  }
 
   public abstract getNextItem(baseId: number, hOffset: number, vOffset: number, moveType: number): TemplateItem | null;
 
@@ -258,6 +276,21 @@ abstract class MetroTemplate {
   public abstract updateItemSize(index: number,
     newSize: { width: number, height: number }): void;
 
+  public getBoundingBoxSize() {
+    const lastItem = this.templateList[this.templateList.length - 1];
+    if (this.direction == VERTICAL) {
+      return {
+        width: this.lineMax,
+        height: lastItem.height + lastItem.top - 1,
+      }
+    } else {
+      return {
+        height: this.lineMax,
+        width: lastItem.width + lastItem.left - 1,
+      }
+    }
+  }
+
   public getTailItemIndex() {
     return this.tailItemIndex;
   }

package/utils/JsViewEngineWidget/TemplateParser/TemplateItemAdder.ts

@@ -12,6 +12,7 @@ class TemplateItemAdder {
   private _SideEffect: Function;
   private _Key: string;
   private _ID: number;
+  private _OnAddDone: Function | null;
 
   constructor(
     template_parser: MetroTemplate,
@@ -19,7 +20,8 @@ class TemplateItemAdder {
     measure_func: Function,
     page_range: number,
     side_effect: Function,
-    id: number
+    id: number,
+    onAddDone: Function | null = null,
   ) {
     this._MetroTemplate = template_parser;
     this._Data = data;
@@ -28,6 +30,7 @@ class TemplateItemAdder {
     this._CurIndex = 0;
     this._CurPage = 0;
     this._SideEffect = side_effect;
+    this._OnAddDone = onAddDone;
     this._Key =
       this._MetroTemplate.direction === HORIZONTAL
         ? "left"
@@ -41,14 +44,14 @@ class TemplateItemAdder {
 
     //过期属性警告
     if (typeof measureObj.doSlide !== "undefined") {
-      measureObj.itemSlide = measureObj.doSlide ? 
-      METRO_WIDGET_CONST.ITEM_SLIDE.ACT_ITEM_FOCUS : METRO_WIDGET_CONST.ITEM_SLIDE.ACT_FOCUS_RECT_EVENT;
+      measureObj.itemSlide = measureObj.doSlide ?
+        METRO_WIDGET_CONST.ITEM_SLIDE.ACT_ITEM_FOCUS : METRO_WIDGET_CONST.ITEM_SLIDE.ACT_FOCUS_RECT_EVENT;
       console.warn("MetroWidget: doSlide will be deprecated soon. use itemSlide instead.");
     }
 
     let templateItem = this._MetroTemplate.addItem(measureObj);
     this._SideEffect?.(itemData, templateItem, measureObj);
-    return templateItem;
+    return { templateObj: templateItem, measureObj: measureObj };
   }
 
   public tryAddItem(cur_item: TemplateItem | null = null, page_num: number = 1) {
@@ -60,9 +63,9 @@ class TemplateItemAdder {
     ) {
       while (this._CurIndex < this._Data.length) {
         try {
-          let item = this.addDataToTemplate(this._Data, this._CurIndex);
+          let { templateObj } = this.addDataToTemplate(this._Data, this._CurIndex);
           this._CurIndex++;
-          if (item[this._Key] >= (this._CurPage + page_num) * this._PageRange) {
+          if (templateObj[this._Key] >= (this._CurPage + page_num) * this._PageRange) {
             this._CurPage += page_num;
             break;
           }
@@ -77,6 +80,7 @@ class TemplateItemAdder {
       this._MetroTemplate.calculateNeighborWhenAddStop();
       added = true;
     }
+    this._OnAddDone?.();
     // 添加完成需要计算neighbor
     return added;
   }
@@ -86,6 +90,7 @@ class TemplateItemAdder {
     if (page_num > this._CurPage) {
       this.tryAddItem(null, page_num - this._CurPage);
     }
+    this._OnAddDone?.();
   }
 
   tryAddItemByIndex(index: number) {
@@ -94,9 +99,9 @@ class TemplateItemAdder {
     while (this._CurIndex <= _index) {
       added = true;
       try {
-        let item = this.addDataToTemplate(this._Data, this._CurIndex);
+        let { templateObj } = this.addDataToTemplate(this._Data, this._CurIndex);
         this._CurIndex++;
-        if (item[this._Key] >= (this._CurPage + 1) * this._PageRange) {
+        if (templateObj[this._Key] >= (this._CurPage + 1) * this._PageRange) {
           this._CurPage++;
         }
       } catch (e) {
@@ -112,6 +117,7 @@ class TemplateItemAdder {
     }
     //再添加一屏
     this.tryAddItem(this._MetroTemplate.getItemByIndex(index), 2);
+    this._OnAddDone?.();
   }
 
   tryAddItemById(id: number) {
@@ -123,9 +129,9 @@ class TemplateItemAdder {
       while (cur_id < _id && this._CurIndex < this._Data.length) {
         added = true;
         try {
-          let item = this.addDataToTemplate(this._Data, this._CurIndex);
-          cur_id = item.id;
-          if (item[this._Key] >= (this._CurPage + 1) * this._PageRange) {
+          let { templateObj } = this.addDataToTemplate(this._Data, this._CurIndex);
+          cur_id = templateObj.id;
+          if (templateObj[this._Key] >= (this._CurPage + 1) * this._PageRange) {
             this._CurPage++;
           }
           this._CurIndex++;
@@ -143,6 +149,41 @@ class TemplateItemAdder {
     }
     //再添加一屏
     this.tryAddItem(this._MetroTemplate.getItemById(id), 2);
+    this._OnAddDone?.();
+  }
+
+  tryAddItemByUid(uid: string) {
+    if (this._MetroTemplate.getItemByUid(uid)) {
+      //已经添加
+      return;
+    }
+    let added = false;
+    let targetItem: TemplateItem | null = null;
+    while (!targetItem && this._CurIndex < this._Data.length) {
+      added = true;
+      try {
+        let { templateObj, measureObj } = this.addDataToTemplate(this._Data, this._CurIndex);
+        if (measureObj.uid == uid) {
+          targetItem = templateObj;
+        }
+        this._CurIndex++;
+        if (templateObj[this._Key] >= (this._CurPage + 1) * this._PageRange) {
+          this._CurPage++;
+        }
+      } catch (e) {
+        console.error(
+          `MetroWidget: ${this._ID} parse template item ${this._CurIndex} failed. data:`,
+          this._Data
+        );
+        throw e;
+      }
+    }
+    if (added) {
+      this._MetroTemplate.calculateNeighborWhenAddStop();
+    }
+    if (targetItem) {
+      this.tryAddItem(targetItem, 2);
+    }
   }
 
   updateData(data: Array<object>) {

package/utils/JsViewEngineWidget/index.js

@@ -1,4 +1,4 @@
-/*
+/*!
  * @Author: ChenChanghua
  * @Date: 2021-06-16 10:07:20
  * @LastEditors: ChenChanghua
@@ -13,5 +13,5 @@ export { default as MetroWidget } from "./MetroWidget/MetroWidget.vue";
 export { default as ListWidget } from "./MetroWidget/ListWidget.vue";
 export { METRO_WIDGET, METRO_WIDGET_CONST } from "./MetroWidget/Const.ts";
 
-export { default as JsvFocusBlock } from "./JsvFocusBlock.vue";
-export { jsvCreateFocusManager, useFocusHub } from "./JsvFocusManager";
+export { default as JsvFocusBlock } from "./JsvFocus/JsvFocusBlock.vue";
+export { jsvCreateFocusManager, useFocusHub } from "./JsvFocus/JsvFocusManager";

package/utils/JsViewPlugin/JsvAudio/AudioProxy.js

@@ -7,6 +7,7 @@ import JsvAudioBridgeProxy from "./JsvAudioBridgeProxy";
 import { checkType, toRawType } from "./CheckType";
 import sPluginLoader from "./PluginLoader";
 import Events from "./Events.js"
+import { ScreenLockManager } from "./ScreenLockManager.js";
 
 const TAG = "JsvAudio";
 
@@ -325,6 +326,14 @@ class AudioProxy {
       this.pause();
     }
   }
+
+  //屏保开关
+  closeScreenSaver() {
+    ScreenLockManager.lock();
+  }
+  openScreenSaver() {
+    ScreenLockManager.unlock();
+  }
 }
 
 export { sAudioManager, getKeyToken };

package/utils/JsViewPlugin/JsvAudio/BrowserAudio/BrowserAudio.vue

@@ -1,6 +1,6 @@
 <script>
 // import playerExMethods from "./JsvMediaBrowserInterface.js"
-import JsvSystemAudio from './JsvSystemAudio.vue';
+import JsvSystemAudio from "./JsvSystemAudio.vue";
 
 export default {
   components: {
@@ -16,8 +16,15 @@ export default {
   },
   methods: {
     onRefProxy(audio_ref) {
+      if (audio_ref != null) {
+        audio_ref.closeScreenSaver = () => {
+          //浏览器端仅提供接口, 不实现功能
+        };
+        audio_ref.openScreenSaver = () => {
+          //浏览器端仅提供接口, 不实现功能
+        };
+      }
       this.audioRef = audio_ref;
-
       // 不在此直接回调 onRef，因为onRefProxy可能会因为 .src的设置导致重新触发一次调用(vue本身问题)
       // 参照vue-core处理的 componentUpdateFn处理, onMounted 一次, src设置后会再次 onPatch 一次
     },
@@ -37,6 +44,7 @@ export default {
     }
   },
   beforeUnmount() {
+    this.audioRef?.closeScreenSaver();
     if (this.onRef) {
       // audio_ref为null，代表video标签卸载处理
       this.onRef(null);
@@ -47,4 +55,4 @@ export default {
 
 <template>
   <jsv-system-audio :onRef="onRefProxy" v-bind="$attrs" />
-</template>
+</template>

package/utils/JsViewPlugin/JsvAudio/JsvAudio.vue

@@ -129,6 +129,7 @@ props.onRef?.(audio);
 
 onBeforeUnmount(() => {
   if (audio != null) {
+    audio.openScreenSaver();
     audio.release();
     props.onRef?.(null);
   }

package/utils/JsViewPlugin/JsvAudio/JsvAudioBridgeProxy.js

@@ -7,6 +7,7 @@ export default class {
   static isReady() {
     return typeof window.jsvAudioBridge != "undefined" && !!window.jsvAudioBridge;
   }
+
   static CreateAudio(key) {
     if (typeof window.jsvAudioBridge != "undefined"
       && typeof window.jsvAudioBridge.CreateAudio != "undefined") {
@@ -40,4 +41,11 @@ export default class {
       return window.jsvAudioBridge.SetProperty(key, params);
     }
   }
+
+  static ScreenWakeLock(lock) {
+    if (typeof window.jsvAudioBridge != "undefined"
+      && typeof window.jsvAudioBridge.ScreenWakeLock != "undefined") {
+      window.jsvAudioBridge.ScreenWakeLock(lock);
+    }
+  }
 }

package/utils/JsViewPlugin/JsvAudio/ScreenLockManager.js

@@ -0,0 +1,16 @@
+import JsvAudioBridgeProxy from "./JsvAudioBridgeProxy";
+
+export class ScreenLockManager {
+  static refCount = 0;
+  static lock() {
+    ScreenLockManager.refCount++;
+    JsvAudioBridgeProxy.ScreenWakeLock(true)
+  }
+
+  static unlock() {
+    ScreenLockManager.refCount = Math.max(0, ScreenLockManager.refCount - 1);
+    if (ScreenLockManager.refCount == 0) {
+      JsvAudioBridgeProxy.ScreenWakeLock(false)
+    }
+  }
+}

package/utils/JsViewPlugin/JsvAudio/version.js

@@ -7,9 +7,9 @@ let PluginInfo = {
     // downloadUrl:"http://192.168.0.63:8080/plugin/JsvAudio-164.zip", //插件下载地址
     packageName: "com.qcode.jsvaudio",
     name: "音频插件",
-    version: "1.0.24",  //插件需要的版本号
-    versionCodeMin: 24,
-    versionCodeMax: 24,
+    version: "1.0.26",  //插件需要的版本号
+    versionCodeMin: 26,
+    versionCodeMax: 26,
     bridgeName: "jsvAudioBridge", //插件bridge注册到jsview的名称
     className: "com.qcode.jsvaudio.JsvAudio",  //插件初始化类名称
     initMethod: "createInstance",   //插件初始化方法

package/utils/JsViewPlugin/JsvAudio/version.mjs

@@ -7,9 +7,9 @@ let PluginInfo = {
   // downloadUrl:"http://192.168.0.63:8080/plugin/JsvAudio-164.zip", //插件下载地址
   packageName: "com.qcode.jsvaudio",
   name: "音频插件",
-  version: "1.0.24",  //插件需要的版本号
-  versionCodeMin: 24,
-  versionCodeMax: 24,
+  version: "1.0.26",  //插件需要的版本号
+  versionCodeMin: 26,
+  versionCodeMax: 26,
   bridgeName: "jsvAudioBridge", //插件bridge注册到jsview的名称
   className: "com.qcode.jsvaudio.JsvAudio",  //插件初始化类名称
   initMethod: "createInstance",   //插件初始化方法

package/utils/JsViewPlugin/JsvLatex/index.js

@@ -10,7 +10,7 @@ let globalLoadJsvLatexPlugin;
 let _JsvLatex;
 
 if (!window.JsView) {
-  const BrowserJsvLatex = await import("./JsvLatexBrowser.vue");
+  const BrowserJsvLatex = await import("./BrowserJsvLatex.vue");
   //browser
   globalLoadJsvLatexPlugin = (listener) => {
     setTimeout(listener, 0);

package/utils/JsViewPlugin/JsvPlayer/JsvPlayer.vue

@@ -1,6 +1,6 @@
 <script>
 import {JsvMediaVideo, JsvMediaAudio, findMediaObjectByKey, logDebug} from './JsvMedia'
-import JsvNativeSharedDiv from 'jsview/utils/JsViewVueWidget/JsvNativeSharedDiv.vue'
+import { JsvNativeSharedDiv } from '../../JsViewVueWidget'
 
 
 export default {

package/utils/JsViewPlugin/JsvPlayer/index-0.9.js

@@ -1,4 +1,4 @@
-//考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
 import { default as JsvPlayer }  from "./JsvPlayer.vue";
 import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvMedia.js"
 import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvMedia.js"
@@ -6,7 +6,7 @@ import { getJsvPlayerCapabilitySet as getCapabilitySet } from "./JsvMedia.js"
 import { setJsvPlayerDebugMode as setDebugMode } from "./JsvMedia.js"
 import { getJsvPlayerRunningNum as getRunningPlayerNum } from "./JsvMedia.js"
 import { globalLoadSetOperator as setOperator } from "./JsvMedia.js"
-import {default as BrowserPlayer} from "./JsvPlayerBrowser-0.9.vue"
+import {default as BrowserPlayer} from "./BrowserJsvPlayer-0.9.vue"
 let _JsvPlayer = JsvPlayer;
 
 let globalLoadJsvPlayerPlugin = initPlugin;
@@ -17,7 +17,7 @@ let getJsvPlayerRunningNum = getRunningPlayerNum;
 let globalLoadSetOperator = setOperator;
 
 if (window.jsvIsBrowserDebug) {
-    // const BrowserPlayer =  await import("./JsvPlayerBrowser.vue");
+    // const BrowserPlayer =  await import("./BrowserJsvPlayer.vue");
     // 浏览器版本
     _JsvPlayer = BrowserPlayer;
 

package/utils/JsViewPlugin/JsvPlayer/index.js

@@ -1,4 +1,4 @@
-//考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
 import { default as JsvPlayer }  from "./JsvPlayer.vue";
 import { globalLoadJsvPlayerPlugin as initPlugin } from "./JsvMedia.js"
 import { globalPreLoadJsvPlayerPlugin as preLoadPlugin } from "./JsvMedia.js"
@@ -16,7 +16,7 @@ let getJsvPlayerRunningNum = getRunningPlayerNum;
 let globalLoadSetOperator = setOperator;
 
 if (window.jsvIsBrowserDebug) {
-    const BrowserPlayer =  await import("./JsvPlayerBrowser.vue");
+    const BrowserPlayer =  await import("./BrowserJsvPlayer.vue");
     // 浏览器版本
     _JsvPlayer = BrowserPlayer.default;
 

package/utils/JsViewVueTools/DebugTool.js

@@ -1,6 +1,6 @@
 
 
-// 用于存储用于Debug的全局引用
+//! 用于存储用于Debug的全局引用
 let DebugObjectRefer = {
     RootRouter: null,
 };
@@ -34,7 +34,7 @@ function DebugWrap81WarnStack() {
     }
 }
 
-// 全局引用，以便于在devtools中能直接进行查询
+//! 全局引用，以便于在devtools中能直接进行查询
 window.JsvDebugTools = DebugTools;
 
 export {

package/utils/JsViewVueTools/DefaultKeyMap.js

@@ -1,4 +1,4 @@
-// 10000以内的按键值同网页的键值，参照ASCII码
+//! 10000以内的按键值同网页的键值，参照ASCII码
 const DefaultKeyCodeMap = {
   Left: 37,
   Up: 38,

package/utils/JsViewVueTools/JsvDynamicCssStyle.js

@@ -2,7 +2,7 @@
  * Created by donglin.lu@qcast.cn on 11/13/2020.
  */
 
-/*
+/*!
  * 【模块 export 内容】
  * CssStyleSheet：面向对象类，CSS rule的操作器，用于添加和删除CssStyle，服务于JsvStyleClass
  *      接口：

package/utils/JsViewVueTools/JsvDynamicKeyFrames.js

@@ -2,7 +2,7 @@
  * Created by donglin.lu@qcast.cn on 11/13/2020.
  */
 
-/*
+/*!
  * 【模块 export 内容】
  * getKeyFramesGroup: 函数，获取KeyFrame操作类 KeyFrameStyleSheet
  * KeyFrameStyleSheet：面向对象类，KeyFrames CSS rule的操作类，用于添加和删除KeyFrame
@@ -13,7 +13,7 @@
  *          hasRule(name)                   查询KeyFrame是否存在
  */
 
-/*
+/*!
  * getKeyFramesGroup 参数说明:
  *      anchor_tag    (String) keyFrame的名称，可以不设置或者为undefined
  *  返回值:

package/utils/JsViewVueTools/JsvImpactTracer.js

@@ -9,7 +9,7 @@
  * Created by donglin.lu@qcast.cn on 4/30/2020.
  */
 
-/*
+/*!
  * 【模块 export 内容】
  * createImpactTracer: 函数，创建碰撞跟踪对象
  * createImpactCallback: 函数，创建碰撞发生后的回调函数
@@ -19,7 +19,7 @@
 
 import { Forge } from "@shijiu/jsview/dom/jsv-forge-define";
 
-/*
+/*!
  * createImpactCallback 参数说明:
  *      on_contact      (function[]) 接受碰撞事件的回调
  *      on_dis_contact  (function[]) 接受物体分离事件的回调
@@ -30,7 +30,7 @@ function createImpactCallback(on_contact, on_dis_contact) {
   return new Forge.sImpactSensorManager.Callback(on_contact, on_dis_contact);
 }
 
-/*
+/*!
  * createImpactTracer 参数说明:
  *      ele1        (Element)   html element句柄，1号碰撞体
  *      ele2        (Element)   html element句柄，2号碰撞体
@@ -43,8 +43,8 @@ function createImpactTracer(ele1, ele2, callback, auto_froze) {
   return Forge.sImpactSensorManager.StartTrace(ele1.jsvGetProxyView(), ele2.jsvGetProxyView(), callback, auto_froze);
 }
 
-// 创建用于设置碰撞即停管理对象的参数
-// 结果用于函数 createImpactAutoFroze 和 updateImpactAutoFroze
+//! 创建用于设置碰撞即停管理对象的参数
+//! 结果用于函数 createImpactAutoFroze 和 updateImpactAutoFroze
 function _ConvertToViewsList(elements_array) {
   const views_array = [];
   if (elements_array) {
@@ -55,7 +55,7 @@ function _ConvertToViewsList(elements_array) {
   return views_array;
 }
 
-/*
+/*!
  * createImpactAutoFroze 参数说明:
  *      element_auto_froze_pre_impact   (Array<Element>)    关联运动元素的列表,这些元素碰撞前一帧停止运动
  *      element_auto_froze_on_impact    (Array<Element>)    关联运动元素的列表,这些元素碰撞当前帧停止运动
@@ -81,7 +81,7 @@ function createImpactAutoFroze(element_auto_froze_pre_impact, element_auto_froze
     (on_impact_list.length > 0 ? on_impact_list : null));
 }
 
-/*
+/*!
  * updateImpactAutoFroze 参数说明:
  *      handler                         (Object)            由 createImpactAutoFroze 创建的句柄
  *      element_auto_froze_pre_impact   (Array<Element>)    关联运动元素的列表,这些元素碰撞前一帧停止运动

package/utils/JsViewVueTools/JsvPreDownloader.ts

@@ -1,4 +1,4 @@
-/* 
+/*! 
  *  JsvPreDownloader 通用下载器，可以在不同的环境中进行资源下载操作。
  *       JsvPreDownloader.download:实例方法，根据传入参数来下载资源。支持单个url或者url列表，返回Promise对象。
  *        参数:

package/utils/JsViewVueTools/JsvRefTaker.js

@@ -1,5 +1,6 @@
 
-/********************
+/*!
+ *******************
  * JsvRefTaker模块
  * 
  * 用于解决 script setup 写法，不容易通过 this.$ref.xxxx 拿到子模块的句柄，