@shijiu/jsview-vue 2.2.128 → 2.2.201

package/utils/JsViewVueWidget/JsvFragShaderView/JsvFragShaderView.vue

@@ -0,0 +1,145 @@
+<!-- 
+[模块 export 内容]
+  JsvFragShaderView：自定义Fragment shader的组件
+      props说明:
+          style         {Object}    (必填)left, top, width, height
+          shaderStr     {String}    (必填)shader的函数体
+          duration      {int}       动画时长
+          autoplay      {boolean}   自动播放
+          uniforms      {Array}     uniform参数, [{ name: string, value: number }]
+          textures      {Array}     texture参数, [{ name: string, resource: string }]
+      methods:
+          startAnim
+              @description 开始动画
+              @params {int} duration: 动画时长, 默认为props.duration
+          stopAnim
+              @description 停止动画
+      shader函数体说明:
+        参考网站: https://www.shadertoy.com
+        主函数: 
+          void mainImage( out vec4 fragColor, in vec2 fragCoord )
+            @params {vec4} fragColor: 输出的片元颜色
+            @params {vec2} fragCoord: 片元坐标, 左下角为原点, 往右为x正, 往上为y正
+      注意事项:
+        * 盒子端使用OpenGL ES 2.0版本, 而网站 https://www.shadertoy.com 上使用WebGL, glsl支持的函数和操作符有区别. 
+        * 由于坐标系的差异, texture()采样函数需要替换为jsvTexture2D()
+        * 盒子端的精度有限, 可能会出现精度导致的计算错误
+
+ -->
+<script setup>
+import { onMounted, onBeforeUnmount } from "vue";
+import { Forge } from "@shijiu/jsview/dom/jsv-forge-define";
+import ForgeHandles from "../../JsViewVueTools/ForgeHandles";
+
+const props = defineProps({
+  style: {
+    type: Object,
+    required: true,
+  },
+  duration: {
+    type: Number,
+    default: -1,
+  },
+  autoplay: {
+    type: Boolean,
+    default: false,
+  },
+  shaderStr: {
+    type: String,
+    required: true,
+  },
+  // [{ name: string, value: number }]
+  uniforms: {
+    type: Array,
+  },
+  // [{ name: string, type: number, resource: string }]
+  textures: {
+    type: Array,
+  },
+});
+
+//uniforms
+let uniformList = [];
+if (props.uniforms) {
+  for (let item of props.uniforms) {
+    uniformList.push({
+      name: item.name,
+      type: 1,
+      value: item.value,
+    });
+  }
+}
+
+//prepare texture
+let textureList = [];
+if (props.textures) {
+  const texture_manager = ForgeHandles.TextureManager;
+  for (let item of props.textures) {
+    if (typeof item.resource == "string") {
+      let image_url = item.resource;
+      if (item.resource && item.resource.trim().indexOf("url(") === 0) {
+        image_url = new window.JsView.Dom.UrlRef(image_url).href;
+      }
+      const texture = texture_manager.GetImage2(
+        image_url,
+        false,
+        null,
+        "RGB_8888",
+        null
+      );
+      textureList.push({
+        name: item.name,
+        id: texture.TexId,
+      });
+    }
+  }
+}
+
+const fragShaderView = new Forge.FragShaderView();
+fragShaderView.SetShaderInfo(
+  props.shaderStr,
+  uniformList,
+  textureList,
+  (state, detail) => {
+    console.log("haha", state, detail);
+  }
+);
+let viewId = Forge.sViewStore.add(new Forge.ViewInfo(fragShaderView, ""));
+
+const { left, top, width, height } = props.style;
+
+const startAnim = (d) => {
+  let duration = typeof d == "number" ? d : props.duration;
+  if (duration > 0) {
+    let shaderAnimation = new Forge.ShaderAnimation(duration, null);
+    fragShaderView.StartAnimation(shaderAnimation);
+  }
+};
+
+const stopAnim = () => {
+  fragShaderView?.StopAnimation();
+};
+
+onMounted(() => {
+  if (props.autoplay) {
+    startAnim(props.duration);
+  }
+});
+
+onBeforeUnmount(() => {
+  if (viewId != -1) {
+    Forge.sViewStore.remove(viewId);
+    viewId = -1;
+  }
+});
+defineExpose({
+  startAnim,
+  stopAnim,
+});
+</script>
+<template>
+  <div
+    :style="{ left, top, width, height }"
+    :data-jsv-vw-innerview="viewId"
+  ></div>
+</template>

package/utils/JsViewVueWidget/JsvFragShaderView/index.js

@@ -0,0 +1,18 @@
+/*
+ * @Author: ChenChanghua
+ * @Date: 2021-10-13 15:12:45
+ * @LastEditors: ChenChanghua
+ * @LastEditTime: 2021-11-22 14:24:36
+ * @Description: file content
+ */
+//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+import * as JsvFragShaderView from "./JsvFragShaderView.vue";
+
+let _JsvFragShaderView;
+if (window.JsView) {
+  _JsvFragShaderView = JsvFragShaderView.default;
+} else {
+  const BrowserJsvFragShaderView = await import("./BrowserJsvFragShaderView.vue");
+  _JsvFragShaderView = BrowserJsvFragShaderView.default;
+}
+export default _JsvFragShaderView;

package/utils/JsViewVueWidget/JsvFreeMoveActor/ActorControl.ts

@@ -12,83 +12,36 @@ import ActionRefObject from "./ActionRefObject";
 import { RunFreeMoveCmdPacks, FreeMoveAnimClass, FinishRenderBreak } from "./ForgeTypeDefine"
 import { NexusNode, newNexus } from "./NexusNode";
 
+interface CmdListCreator {
+  (builders: BuilderFactory): Array<Object>;
+}
 
-class ActorControl {
-  private _BindView: any;
-  private _BindAnim: any;
-  private _Callbacks: CallbackManager;
-  private _SelfNexusRecv: NexusNode;
-  private _SizeMode: Boolean = false;
-
+class BuilderFactory {
   private _SharedQuickConditionPackBuilder: ConditionPackBuilder;
   private _SharedQuickActionPackBuilder: ActionPackBuilder;
   private _StatePackBuilder: StatePackBuilder;
+  private _Callbacks: CallbackManager;
+  private _SelfNexusRecv: NexusNode;
+  private _OwnerControl: ActorControl;
 
-  constructor() {
-    this._BindView = null;
-    this._BindAnim = null;
-    this._Callbacks = new CallbackManager();
-    this._SelfNexusRecv = newNexus();
-    this._SharedQuickConditionPackBuilder = new ConditionPackBuilder(this._Callbacks, this._SelfNexusRecv);
+  constructor(owner: ActorControl, callbackManager: CallbackManager, selfNexusRecv: NexusNode) {
+    this._OwnerControl = owner;
+    this._Callbacks = callbackManager;
+    this._SelfNexusRecv = selfNexusRecv;
+
+    this._SharedQuickConditionPackBuilder = new ConditionPackBuilder(this._Callbacks, this._SelfNexusRecv, this);
     this._SharedQuickActionPackBuilder = new ActionPackBuilder(this._Callbacks, this._SelfNexusRecv);
     this._StatePackBuilder = new StatePackBuilder();
   }
 
-  asSizeMode() {
-    if (this._BindAnim != null) {
-      console.error("error: asSizeMode should call before bindForgeView");
-    } else {
-      this._SizeMode = true;
-    }
-  }
-
-  // debugGetAnimId() {
-  //   return this._BindAnim?.AnimNativeId;
-  // }
-
-  bindForgeView(bindView: any, instantActive: boolean) {
-    this._BindView = bindView;
-
-    if (instantActive) {
-      this._EnsureAnim();
-    }
-  }
-
-  /** 
-   * run 执行编排好的intent集合
-   *
-   * @param {Array} cmdPackList 内容来自 Condition(), State(), Action() 这些工厂类创建的Command pack
-   */
-  run(cmdPackList: Array<Object>) {
-    if ((window as any).JsView) {
-      this._WrappedRun(cmdPackList);
-    } else {
-      // Browser场景DomProxy需要onReady调用
-      let that = this;
-      this._BindView.RegisterOnProxyReady(() => {
-        that._WrappedRun(cmdPackList);
-      })
-    }
-  }
-
-  _WrappedRun(cmdPackList: Array<Object>) {
-    this._EnsureAnim();
-
-    if (!(cmdPackList instanceof Array)) {
-      console.error("params error");
-      return;
-    }
-
-    RunFreeMoveCmdPacks(this._BindView, cmdPackList);
-  }
-
   /**
    * Condition
    * 获取创建 ConditionPack 的工厂对象
    * ConditionPack对应支持 .then(cmdPackList), 可传入同 Run 的处理队列
    * 可用方法见 ./SetCondition.js
    * @param {int} group 可选参数，默认为0, 有效值为0~3, 对应默认组, 1组, 2组, 3组, 便于remove时，按组进行清理
-   * @param {boolean} multiTimes 可选参数，默认为false, 是否要多次执行, 若为单次，则执行后condition作废
+   * @param {boolean} multiTimes 可选参数，默认为false, 是否要多次执行, 
+   *                      若为单次, 当group未设定时自动作废，当group设定时，不作废但改为deactive状态
    * @param {string} specName 可选参数，默认null, 命名condition, 用于指定名字进行active/deactive动作的场景
    * @param {boolean} shoudRenderBreak 可选参数，默认false, 关联的回调是否会发起RenderBreak
    * @return {ConditionPackBuilder} ConditionPack 的工厂对象
@@ -103,7 +56,7 @@ class ActorControl {
     let builder: ConditionPackBuilder = this._SharedQuickConditionPackBuilder;
     if (builder.isInUsing()) {
       // 用于加速的builder被占用了，为了防止状态问题，使用新建builder
-      builder = new ConditionPackBuilder(this._Callbacks, this._SelfNexusRecv);
+      builder = new ConditionPackBuilder(this._Callbacks, this._SelfNexusRecv, this);
     }
     builder.updateCommandInfo(group, multiTimes, specName, shoudRenderBreak);
     return builder;
@@ -148,6 +101,80 @@ class ActorControl {
   state(): StatePackBuilder {
     return this._StatePackBuilder;
   }
+}
+
+class ActorControl {
+  private _BindView: any;
+  private _BindAnim: any;
+  private _Callbacks: CallbackManager;
+  private _SelfNexusRecv: NexusNode;
+  private _SizeMode: Boolean = false;
+
+  private _CondCycleStartList: Array<Function> | undefined = undefined;
+  private _CondCycleEndList: Array<Function> | undefined = undefined;
+  private _Builders: BuilderFactory;
+
+  constructor() {
+    this._BindView = null;
+    this._BindAnim = null;
+    this._Callbacks = new CallbackManager();
+    this._SelfNexusRecv = newNexus();
+    this._Builders = new BuilderFactory(this, this._Callbacks, this._SelfNexusRecv);
+  }
+
+  asSizeMode() {
+    if (this._BindAnim != null) {
+      console.error("error: asSizeMode should call before bindForgeView");
+    } else {
+      this._SizeMode = true;
+    }
+  }
+
+  // debugGetAnimId() {
+  //   return this._BindAnim?.AnimNativeId;
+  // }
+
+  bindForgeView(bindView: any, instantActive: boolean) {
+    this._BindView = bindView;
+
+    if (instantActive) {
+      this._EnsureAnim();
+    }
+  }
+
+  /**
+   * run 执行编排好的intent集合
+   *
+   * @param {CmdListCreator} commandsCreator 
+   *                         命令指令队列创建回调
+   *                         此回调返回值为一个数组，数组内容内容来自 Condition(), State(), Action() 
+   *                         这些工厂类创建的Command pack
+   */
+  run(commandsCreator: CmdListCreator | undefined) {
+    if (commandsCreator) {
+      let cmdPackList = commandsCreator(this._Builders);
+      if ((window as any).JsView) {
+        this._WrappedRun(cmdPackList);
+      } else {
+        // Browser场景DomProxy需要onReady调用
+        let that = this;
+        this._BindView.RegisterOnProxyReady(() => {
+          that._WrappedRun(cmdPackList);
+        })
+      }
+    }
+  }
+
+  _WrappedRun(cmdPackList: Array<Object>) {
+    this._EnsureAnim();
+
+    if (!(cmdPackList instanceof Array)) {
+      console.error("params error");
+      return;
+    }
+
+    RunFreeMoveCmdPacks(this._BindView, cmdPackList);
+  }
 
   getBindedAnim() {
     this._EnsureAnim();
@@ -159,11 +186,58 @@ class ActorControl {
     return this._BindView;
   }
 
+  /**
+   * addCondCycleListener
+   * 追加 cond cycle listener，可以根据start和end来进行callback时序排序
+   * 
+   * @param {Function} startCycleCallback   开始执行一帧的js回调(condition的callback)
+   * @param {Function} endCycleCallback  执行一帧的js回调完毕
+   */
+  addCondCycleListener(startCycleCallback: Function, endCycleCallback: Function) {
+    if (startCycleCallback) {
+      if (!this._CondCycleStartList) {
+        this._CondCycleStartList = new Array();
+      }
+      this._CondCycleStartList!.push(startCycleCallback);
+    }
+
+    if (endCycleCallback) {
+      if (!this._CondCycleEndList) {
+        this._CondCycleEndList = new Array();
+      }
+      this._CondCycleEndList!.push(endCycleCallback);
+    }
+  }
+
+  removeCondCycleListener(startCycleCallback: Function, endCycleCallback: Function) {
+    if (startCycleCallback && this._CondCycleStartList) {
+      for (let i = 0; i < this._CondCycleStartList.length; i++) {
+        if (this._CondCycleStartList[i] == startCycleCallback) {
+          this._CondCycleStartList.splice(i, 1);
+          break;
+        }
+      }
+    }
+    if (endCycleCallback && this._CondCycleEndList) {
+      for (let i = 0; i < this._CondCycleEndList.length; i++) {
+        if (this._CondCycleEndList[i] == endCycleCallback) {
+          this._CondCycleEndList.splice(i, 1);
+          break;
+        }
+      }
+    }
+  }
+
   _OnEchoEvent(retJson: string) {
     // 遇到layout后仍然会因为新broadcast有动作时，一帧中可能会有多次回调
     let retJsonObject: any = JSON.parse(retJson);
     let echoRetList: Array<any> = retJsonObject["retList"];
     if (echoRetList) {
+      if (this._CondCycleStartList && this._CondCycleStartList.length > 0) {
+        for (let startCb of this._CondCycleStartList) {
+          startCb();
+        }
+      }
       for (let echoRet of echoRetList) {
         let renderBreakId = echoRet["rbTkn"];
         if (renderBreakId != 0) {
@@ -172,6 +246,11 @@ class ActorControl {
         }
         this._Callbacks.invokeCallback(echoRet["eTkn"], retJsonObject, echoRet["cds"], echoRet["ncds"]);
       }
+      if (this._CondCycleEndList && this._CondCycleEndList.length > 0) {
+        for (let endCb of this._CondCycleEndList) {
+          endCb();
+        }
+      }
     }
   }
 

package/utils/JsViewVueWidget/JsvFreeMoveActor/SetAction.ts

@@ -484,22 +484,31 @@ class ActorPackBuilder {
    * 只能放在 movementSync 的then中，用于将Sync同步信息按比例转化成
    * (注意): 如果触发链条上有自己发出的信息，则将不再产生动作，规避循环触发
    * 
-   * @param {int} left  运动识别区域的left, 可以为负
-   * @param {int} top  运动识别区域的top, 可以为负
-   * @param {int} right  运动识别区域的right, 可以为负，必须大于left
-   * @param {int} bottom  运动识别区域的bottom, 可以为负，必须大于bottom
+   * @param {int} horizontalStart  横向运动识别区域的0%对应位置, 可以为负
+   * @param {int} horizontalEnd  横向运动识别区域的100%对应位置, 可以为负，可以小于start
+   * @param {int} verticalStart  纵向运动识别区域的0%对应位置, 可以为负
+   * @param {int} verticalEnd  纵向运动识别区域的100%对应位置, 可以为负，可以小于end
    * @param {int} xyEnable  x,y是否都触发, 0b01对应x, 0b10对应y, 可以或运算在一起
    * @param {int} syncType 换算公式: 
    *                        1: 正比公式:selfPercent = givenPercent  
    *                        2: 反比公式:selfPercent = (1 - givenPercent)
    */
-  ackMovementSync(left: number, top: number, right: number, bottom: number, xyEnable: number, syncType: number) {
+  ackMovementSync(
+    horizontalStart: number, horizontalEnd: number,
+    verticalStart: number, verticalEnd: number,
+    xyEnable: number, syncType: number) {
+
     if (!this._BasicPreProcess("ackMovementSync")) {
       return;
     }
 
     let cmdList: Array<Object> = [];
-    cmdList.push(ActionCmdBuilder.AckMovementSync(left, top, right, bottom, xyEnable, syncType));
+    cmdList.push(ActionCmdBuilder.AckMovementSync(
+      horizontalStart,
+      horizontalEnd,
+      verticalStart,
+      verticalEnd,
+      xyEnable, syncType));
     return CmdPackBuilder.InitActCmdPack(this._SpeedKeeps, this._AccKeeps, this._NexusRecv?.token, cmdList);
   }
 

package/utils/JsViewVueWidget/JsvFreeMoveActor/SetCondition.ts

@@ -31,12 +31,14 @@ class ConditionPackBuilder {
   private _CommonInfo: Object;
   private _CommonInfoValid: boolean;
   private _ContorlSlefNexus: NexusNode;
+  private _BuildersFactory: any;
 
-  constructor(callbackManager: CallbackManager, selfNexus: NexusNode) {
+  constructor(callbackManager: CallbackManager, selfNexus: NexusNode, buildersFactory: any) {
     this._Callbacks = callbackManager;
     this._CommonInfo = ConditionSetBuilder.InitCommonInfo();
     this._CommonInfoValid = false;
     this._ContorlSlefNexus = selfNexus;
+    this._BuildersFactory = buildersFactory;
   }
 
   isInUsing() {
@@ -143,7 +145,7 @@ class ConditionPackBuilder {
    * @param {NexusNode} nexusRecv 由 FreeMoveFunc.newNexus() 创建, 作为通讯句柄，类似电话号，被fireNexusEvent调用
    * @param {number} detailEventType 监听的事件类型, 类比与分机号，和fireNexusEvent发出的id约定, 自定义内容要求1000以上
    */
-  onNexusEvent(nexusRecv: NexusNode, detailEventType: number): Object | null {
+  onNexusEvent(nexusRecv: NexusNode, detailEventType: number) {
     // CommonInfo 只能使用一次，规避多次使用问题
     if (!this._CheckCommonInfo()) {
       return null;
@@ -179,6 +181,7 @@ class ConditionPackBuilder {
   /**
    * onNextTick
    * 用于对一些Condition激活进行延迟，例如teleportTo处理后延迟激活 OnHitBlock 动作，规避teleportTo处理直接触发OnHitBlocker
+   * 特别场景: onNextTick(0) 可用于充当前帧命令执行完毕的回调，相当于为命令执行完毕做一个callback
    * 
    */
   onNextTick(tickGap: number = 1) {
@@ -187,8 +190,8 @@ class ConditionPackBuilder {
       return null;
     }
     this._CommonInfoValid = false;
-    if (tickGap <= 0) {
-      tickGap = 1;
+    if (tickGap < 0) {
+      tickGap = 0;
     }
 
     return this._BuildPack(ConditionSetBuilder.OnNextTick(tickGap, this._CommonInfo));
@@ -347,10 +350,19 @@ class ConditionPackBuilder {
 
     // 追加then处理
     let callbackManager = this._Callbacks;
-    cmdPack["then"] = (childCmdPackList: Array<Object>) => {
-      setChildCommnadPackList(conditionSet, callbackManager, childCmdPackList);
+    cmdPack["then"] = (creatorOrArray: Function | Array<Object> | undefined) => {
+      if (creatorOrArray) {
+        let childCmdPackList: Array<Object>;
+        if (typeof creatorOrArray == "function") {
+          childCmdPackList = creatorOrArray(this._BuildersFactory);
+        } else {
+          childCmdPackList = creatorOrArray;
+        }
+        setChildCommnadPackList(conditionSet, callbackManager, childCmdPackList);
+        return cmdPack;
+      }
       return cmdPack;
-    };
+    }
 
     return cmdPack;
   }

package/utils/JsViewVueWidget/JsvFreeMoveActor/SetState.ts

@@ -123,26 +123,30 @@ class StatePackBuilder {
    * 
    * 发出进度同步信号(可以一个FreeMove绑定多个信号发生器，但目前场景估计只需要一个发生器即可)
    * 计算当前freeMove的postion和运动识别区域的比值
-   * xPercent = (xPos - left) / (right - left)
-   * yPercent = (yPos - top) / (bottom - top)
+   * xPercent = (xPos - horizontalStart) / (horizontalEnd - horizontalStart)
+   * yPercent = (yPos - verticalStart) / (verticalEnd - verticalStart)
    * x和y可以为负数，也可能>100%
    * 
    * 当多次调用时，nexusRef相同时，则为更新运动识别区域，nexusRef不同时则为新建信号发起器
    * 
    * @param {NexusNode} nexusRef  绑定的nexus句柄，接受者用这个句柄来进行监听
-   * @param {int} left  运动识别区域的left, 可以为负
-   * @param {int} top  运动识别区域的top, 可以为负
-   * @param {int} right  运动识别区域的right, 可以为负，必须大于left
-   * @param {int} bottom  运动识别区域的bottom, 可以为负，必须大于bottom
+   * @param {int} horizontalStart  横向运动识别区域的0%对应位置, 可以为负
+   * @param {int} horizontalEnd  横向运动识别区域的100%对应位置, 可以为负，可以小于start
+   * @param {int} verticalStart  纵向运动识别区域的0%对应位置, 可以为负
+   * @param {int} verticalEnd  纵向运动识别区域的100%对应位置, 可以为负，可以小于end
    * @param {int} xyEnable  x,y是否都触发, 0b01对应x, 0b10对应y, 可以或运算在一起
    */
-  startMovementSync(nexusRef: NexusNode, left: number, top: number, right: number, bottom: number, xyEnable: number) {
+  startMovementSync(nexusRef: NexusNode,
+    horizontalStart: number, horizontalEnd: number,
+    verticalStart: number, verticalEnd: number,
+    xyEnable: number) {
+
     return CmdPackBuilder.InitStateCmdPack(StateCmdBuilder.StartMovementSync(
       nexusRef?.token ? nexusRef.token : 0,
-      left,
-      top,
-      right,
-      bottom,
+      horizontalStart,
+      horizontalEnd,
+      verticalStart,
+      verticalEnd,
       xyEnable));
   }
 

package/utils/JsViewVueWidget/JsvFreeMoveActor/SyncLinkManager.ts

@@ -0,0 +1,120 @@
+
+import { NexusNode } from "./NexusNode";
+
+interface PendingPromise {
+    promiseRef: Promise<void> | null;
+    promiseResolve: Function | null;
+    linkName: String;
+}
+
+class SyncLinkSource {
+    nexusNode: NexusNode;
+    linkName: String;
+
+    constructor(name: string, node: NexusNode) {
+        this.nexusNode = node;
+        this.linkName = name;
+    }
+}
+
+class SyncLinkManager {
+    // 等待中的未回复的link
+    private pendingPromiseList: Array<PendingPromise> = [];
+    private syncSourceMap: Map<String, SyncLinkSource> = new Map();
+
+    constructor() {
+
+    }
+
+    // 将LinkSource加入map
+    SourceOnMounted(syncSource: SyncLinkSource | null) {
+        if (syncSource != null) {
+            let linkName = syncSource.linkName;
+            if (this.syncSourceMap.has(linkName)) {
+                // 重名内容不要添加，规避引起引用混乱
+                console.error(`Error: sync link name duplicate:${linkName}`);
+                return;
+            }
+
+
+            this.syncSourceMap.set(linkName, syncSource);
+
+            if (this.pendingPromiseList.length != 0) {
+                // 找出pending内容，进行回调
+                for (let index = this.pendingPromiseList.length - 1; index >= 0; index--) {
+                    let promiseItem = this.pendingPromiseList[index];
+                    if (promiseItem.linkName == linkName) {
+                        promiseItem.promiseResolve?.();
+                        this.pendingPromiseList.splice(index, 1);
+                    }
+                }
+            }
+        }
+    }
+
+    // 将LinkSource移出map
+    SourceOnUnmounted(linkName: String) {
+        if (this.syncSourceMap.has(linkName)) {
+            this.syncSourceMap.delete(linkName);
+        } else {
+            console.error(`ERROR: unmount linkname(${linkName}) not found`)
+        }
+    }
+
+    // 加入wait处理在.then中再进行 GetSyncSource, 以保证节点完成了mounted
+    WaitSourceMounted(name: String): Promise<void> {
+        let newPromiseItem: PendingPromise = {
+            promiseRef: null,
+            promiseResolve: null,
+            linkName: name
+        }
+        newPromiseItem.promiseRef = new Promise((resolve) => {
+            newPromiseItem.promiseResolve = resolve;
+            if (this.syncSourceMap.has(name)) {
+                // 若已经有了则直接resolve
+                resolve();
+            } else {
+                // 加入到pending队列中
+                this.pendingPromiseList.push(newPromiseItem);
+            }
+        });
+
+        return newPromiseItem.promiseRef;
+    }
+
+    // 取消 WaitSourceMounted 发起的Promise, 用在unmounted中, 规避内存泄漏
+    UnListen(waitPromise: Promise<void>) {
+        if (this.pendingPromiseList.length != 0) {
+            for (let index = this.pendingPromiseList.length; index >= 0; index--) {
+                let promiseItem = this.pendingPromiseList[index];
+                if (promiseItem.promiseRef == waitPromise) {
+                    this.pendingPromiseList.splice(index, 1);
+                    break;
+                }
+            }
+        }
+    }
+
+    GetSourceNexusNode(linkName: String): NexusNode | null {
+        let sourceItem = this.syncSourceMap.get(linkName);
+        if (sourceItem) {
+            return sourceItem.nexusNode;
+        } else {
+            return null;
+        }
+    }
+}
+
+let sSyncLinkManager: SyncLinkManager | null = null;
+
+function GetSyncLinkManager(): SyncLinkManager {
+    if (sSyncLinkManager == null) {
+        sSyncLinkManager = new SyncLinkManager();
+    }
+    return sSyncLinkManager;
+}
+
+export {
+    GetSyncLinkManager,
+    SyncLinkSource
+}