hj-gis-sdk 1.0.0 → 1.0.2

package/dist/types/hj-gis-sdk/addons/tools/scatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scatter.d.ts","sourceRoot":"","sources":["../../../../../hj-gis-sdk/addons/tools/scatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,QAAQ,CAAA;AACzB,OAAO,KAAK,MAAM,qBAAqB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGtD,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CACjC,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,IAAI;gBAC3B,GAAG,EAAE,KAAK;IAIhB,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA0BlE;AAED,cAAM,mBAAmB;IACvB,OAAO,CAAC,IAAI,CAAO;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAK;IAC7B,IAAI,SAAS,QAKZ;IACD,IAAI,MAAM,QAQT;gBACW,GAAG,EAAE,KAAK;IAItB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAI3B,UAAU,CAAC,EAAE,EAAE,MAAM;IASrB,SAAS;IAOT,WAAW,CAAC,GAAG,EAAE,MAAM;CAO9B;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,IAAI,CAAO;IACnB,KAAK,CAAC,EAAE,mBAAmB,CAAA;gBAEzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;QACN,GAAG,EAAE,KAAK,CAAA;QACV,SAAS,CAAC,EAAE,SAAS,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,mBAAmB,CAAA;KAC5B;IAWH,IAAI,GAAG,WAEN;IACD,IAAI,EAAE,WAEL;IAED,IAAI,SAAS,cAEZ;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAG5B;IAED,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,YAAY;IAYd,MAAM;CASb"}
+{"version":3,"file":"scatter.d.ts","sourceRoot":"","sources":["../../../../../hj-gis-sdk/addons/tools/scatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,QAAQ,CAAA;AACzB,OAAO,KAAK,MAAM,qBAAqB,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGtD,UAAU,UAAU;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CACjC,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,IAAI;gBAC3B,GAAG,EAAE,KAAK;IAIhB,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA0BlE;AAED,cAAM,mBAAmB;IACvB,OAAO,CAAC,IAAI,CAAO;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAK;IAC7B,IAAI,SAAS,QAKZ;IACD,IAAI,MAAM,QAQT;gBACW,GAAG,EAAE,KAAK;IAItB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAI3B,UAAU,CAAC,EAAE,EAAE,MAAM;IASrB,SAAS;IAWT,WAAW,CAAC,GAAG,EAAE,MAAM;CAa9B;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,IAAI,CAAO;IACnB,KAAK,CAAC,EAAE,mBAAmB,CAAA;gBAEzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;QACN,GAAG,EAAE,KAAK,CAAA;QACV,SAAS,CAAC,EAAE,SAAS,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,mBAAmB,CAAA;KAC5B;IAWH,IAAI,GAAG,WAEN;IACD,IAAI,EAAE,WAEL;IAED,IAAI,SAAS,cAEZ;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,EAG5B;IAED,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,YAAY;IAiBd,MAAM;CASb"}

package/dist/types/src/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/common.ts"],"names":[],"mappings":"AAOA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW;;;GA+B1E"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/common.ts"],"names":[],"mappings":"AAQA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW;;;GAsC1E"}

package/hj-gis-sdk/addons/animation/animate-clip.ts

@@ -0,0 +1,93 @@
+import { Transform } from '../transform'
+import AnimationAction from './animation-action'
+
+export type AnimateParam = {
+  Handle: string
+  Rate?: number
+  Loop?: boolean
+}
+
+export interface AnimateClip {
+  _clipCall(): ClipCall
+}
+
+export interface ClipCall {
+  clip: AnimateClip
+  _play(action: AnimationAction, params: AnimateParam): void
+  _pause(action: AnimationAction, params: AnimateParam): void
+  _resume(action: AnimationAction, params: AnimateParam): void
+}
+
+export class PresetAnimateClip implements AnimateClip {
+  animateName: string
+  constructor(animateName: string) {
+    this.animateName = animateName
+  }
+  _clipCall(): ClipCall {
+    return new PresetAnimateClipCall(this)
+  }
+}
+
+class PresetAnimateClipCall implements ClipCall {
+  clip: PresetAnimateClip
+  constructor(clip: PresetAnimateClip) {
+    this.clip = clip
+  }
+
+  _play(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'Play', {
+      ...params,
+      Animation: this.clip.animateName
+    })
+  }
+  _pause(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'Pause', {
+      handle: params.Handle
+    })
+  }
+  _resume(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'Resume', {
+      handle: params.Handle
+    })
+  }
+}
+
+export class KeyFrameAnimateClip implements AnimateClip {
+  startTransform?: Transform
+  endTransform?: Transform
+  constructor(params: {
+    startTransform?: Transform
+    endTransform?: Transform
+  }) {
+    this.startTransform = params.startTransform
+    this.endTransform = params.endTransform
+  }
+  _clipCall() {
+    return new KeyFrameAnimateClipCall(this)
+  }
+}
+
+class KeyFrameAnimateClipCall implements ClipCall {
+  clip: KeyFrameAnimateClip
+  constructor(clip: KeyFrameAnimateClip) {
+    this.clip = clip
+  }
+  _play(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'MoveBetweenTransforms', {
+      Handle: action.handle,
+      StartTransform: this.clip.startTransform?.toRPCJSON(),
+      EndTransform: this.clip.endTransform?.toRPCJSON(),
+      Duration: action.duration
+    })
+  }
+  _pause(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'PauseMoveBetweenTransforms', {
+      Handle: action.handle
+    })
+  }
+  _resume(action: AnimationAction, params: AnimateParam) {
+    action.mixer?.rpc.callModule('Animation', 'ResumeMoveBetweenTransforms', {
+      Handle: action.handle
+    })
+  }
+}

package/hj-gis-sdk/addons/animation/animation-action.ts

@@ -0,0 +1,93 @@
+import type { AnimateClip } from './animate-clip'
+import AnimationMixer from './animation-mixer'
+
+enum Status {
+  Playing = 'playing',
+  Paused = 'paused',
+  Stopped = 'stopped'
+}
+
+enum PlaybackType {
+  Loop = 'loop',
+  Once = 'once'
+}
+
+export default class AnimationAction {
+  private _status: Status
+  private _handle: string
+  type: PlaybackType | string
+  rate: number
+  clip: AnimateClip
+  mixer?: AnimationMixer
+  private _duration?: number
+  playDuration: number
+
+  constructor(handle: string, clip: AnimateClip, mixer?: AnimationMixer) {
+    this._status = Status.Stopped
+    this._handle = handle
+    this.type = PlaybackType.Once
+    this.rate = 1
+    this.clip = clip
+    this.playDuration = 0
+    this.mixer = mixer
+  }
+
+  get duration(): number | undefined {
+    return this._duration
+  }
+
+  set duration(duration: number) {
+    this._duration = duration
+  }
+
+  get handle() {
+    return this._handle
+  }
+
+  get status() {
+    return this._status
+  }
+  async play() {
+    if (this._status == Status.Paused) {
+      let clipCall = this.clip._clipCall()
+      return clipCall._resume(this, {
+        Handle: this._handle
+      })
+    }
+    let obj = {
+      Handle: this._handle,
+      Rate: this.rate,
+      Loop: this.type == PlaybackType.Loop
+    }
+    let clipCall = this.clip._clipCall()
+    this.playDuration = 0
+    this._status = Status.Playing
+
+    let result = clipCall._play(this, obj)
+
+    return
+  }
+  pause() {
+    let obj = {
+      Handle: this._handle,
+      Rate: this.rate,
+      Loop: this.type == PlaybackType.Loop
+    }
+    let clipCall = this.clip._clipCall()
+    this._status = Status.Paused
+    return clipCall._pause(this, obj)
+  }
+  update(delta: number) {
+    if (this.status != Status.Playing) {
+      return
+    }
+    this.playDuration += delta
+    if (
+      this.type === PlaybackType.Once &&
+      this.duration &&
+      this.playDuration >= this.duration!
+    ) {
+      this._status = Status.Stopped
+    }
+  }
+}

package/hj-gis-sdk/addons/animation/animation-mixer.ts

@@ -0,0 +1,51 @@
+import UERPCNode from '../node/ue-node'
+import UERPC from '../../core/ue-rpc'
+import AnimationAction from './animation-action'
+import { Clock } from '../clock'
+import { AnimateClip } from './animate-clip'
+export default class AnimationMixer {
+  private _rpc: UERPC
+  private _duration: number
+  private _clock?: Clock
+  private _actions: AnimationAction[] = []
+  constructor(rpc: UERPC) {
+    this._rpc = rpc
+    this._duration = 0
+    this._actions = []
+    this.init()
+  }
+
+  get rpc() {
+    return this._rpc
+  }
+
+  init() {
+    this._clock = new Clock()
+    this._clock.start()
+    setTimeout(() => {
+      this._duration += this._clock!.getDelta()
+      this.updateAction()
+    }, 1000 / 60)
+  }
+
+  get duration() {
+    return this._duration
+  }
+
+  updateAction() {
+    this._actions.forEach((action) => {
+      action.update(this._duration)
+    })
+  }
+
+  clipAction(clip: AnimateClip, node: UERPCNode) {
+    return new AnimationAction(node.key!, clip, this)
+  }
+  removeAction(action: AnimationAction) {
+    // this._actions = this._actions.filter((item) => item !== action)
+    let index = this._actions.findIndex((item) => item === action)
+    if (index > -1) {
+      this._actions.splice(index, 1)
+    }
+  }
+}

package/hj-gis-sdk/addons/animation/index.ts

@@ -0,0 +1,17 @@
+import {
+  AnimateClip,
+  ClipCall,
+  PresetAnimateClip,
+  KeyFrameAnimateClip
+} from './animate-clip'
+import AnimationMixer from './animation-mixer'
+import AnimationAction from './animation-action'
+
+export {
+  AnimationMixer,
+  AnimationAction,
+  AnimateClip,
+  PresetAnimateClip,
+  KeyFrameAnimateClip,
+  ClipCall
+}

package/hj-gis-sdk/addons/camera.ts

@@ -0,0 +1,173 @@
+/**
+ * 相机模块，提供相机相关的类和功能
+ * 该模块定义了相机基类和透视相机类，用于在3D场景中管理相机的属性和变换
+ */
+import UERPC from '../core/ue-rpc'
+import UERPCNode from './node/ue-node'
+import { Collector, createDeepProxy } from './proxy'
+import { Transform } from './transform'
+import World from './world'
+
+/**
+ * 相机基类，继承自UERPCNode
+ * 定义了相机的基本结构，所有具体相机类型的父类
+ */
+export class Camera extends UERPCNode {
+  /**
+   * 相机基类构造函数
+   * @param rpc UERPC实例，用于与远程服务通信
+   * @param type 相机类型
+   */
+  constructor(rpc: UERPC, type: string) {
+    super(rpc, type)
+  }
+}
+
+/**
+ * 透视相机类，用于表示3D场景中的透视相机
+ * 实现了透视相机的属性和变换管理
+ */
+export class PerspectiveCamera extends Camera {
+  /** 所属世界实例，用于关联相机与场景 */
+  world?: World
+  // /** 视场角，单位为度，控制相机的视野范围 */
+  // _fov: number
+  // /** 焦距，单位为毫米，影响相机的缩放效果 */
+  // _focalLength: number
+  // /** 光圈，影响相机的景深效果 */
+  // _aperture: number
+  // /** 焦距离，单位为世界单位，定义焦点所在的距离 */
+  // _focusDistance: number
+  /** 相机变换，包含位置、旋转和缩放信息 */
+  _transform: Transform
+  /** 变换收集器，用于收集相机变换的变化并触发更新 */
+  protected _collector: Collector
+  /** 远程更新标志，用于标记相机属性是否需要同步到远程 */
+  protected _remoteUpdateFlag: boolean
+
+  /**
+   * 构造函数
+   * @param rpc UERPC实例，用于与远程服务通信
+   */
+  constructor(rpc: UERPC) {
+    super(rpc, 'camera')
+    // // 初始化相机默认属性
+    // this._fov = 75
+    // this._focalLength = 50
+    // this._aperture = 35
+    // this._focusDistance = 100
+    // 创建默认变换
+    this._transform = Transform.default()
+    // 初始化变换收集器
+    this._collector = new Collector(this._triggerRemoteUpdate.bind(this))
+    // 初始化远程更新标志
+    this._remoteUpdateFlag = false
+  }
+
+  // /**
+  //  * 获取焦距值
+  //  * @returns {number} 焦距值，单位为毫米
+  //  */
+  // get focalLength() {
+  //   return this._focalLength
+  // }
+
+  // /**
+  //  * 设置焦距值
+  //  * @param focalLength 新的焦距值，单位为毫米
+  //  */
+  // set focalLength(focalLength: number) {
+  //   this._focalLength = focalLength
+  //   this._triggerRemoteUpdate()
+  // }
+
+  // /**
+  //  * 获取光圈值
+  //  * @returns {number} 光圈值
+  //  */
+  // get aperture() {
+  //   return this._aperture
+  // }
+
+  // /**
+  //  * 设置光圈值
+  //  * @param aperture 新的光圈值
+  //  */
+  // set aperture(aperture: number) {
+  //   this._aperture = aperture
+  //   this._triggerRemoteUpdate()
+  // }
+
+  // /**
+  //  * 获取视场角
+  //  * @returns {number} 视场角，单位为度
+  //  */
+  // get fov() {
+  //   return this._fov
+  // }
+
+  // /**
+  //  * 设置视场角
+  //  * @param fov 新的视场角，单位为度
+  //  */
+  // set fov(fov: number) {
+  //   this._fov = fov
+  //   this._triggerRemoteUpdate()
+  // }
+
+  // /**
+  //  * 获取焦距离
+  //  * @returns {number} 焦距离，单位为世界单位
+  //  */
+  // get focusDistance() {
+  //   return this._focusDistance
+  // }
+
+  // 同步远程相机参数到本地
+  async forceSyncRemoteToLocal() {
+    let response = await this._rpc.getCameraTransform()
+    console.log(response)
+    if (response.Transform) {
+      let transform = Transform.fromRPCObject(response.Transform)
+      this._transform = transform
+    }
+  }
+
+  // /**
+  //  * 设置焦距离
+  //  * @param focusDistance 新的焦距离，单位为世界单位
+  //  */
+  // set focusDistance(focusDistance: number) {
+  //   this._focusDistance = focusDistance
+  //   this._triggerRemoteUpdate()
+  // }
+
+  /**
+   * 获取相机变换的代理对象
+   * 通过深度代理实现对变换属性的监听，当变换属性变化时自动触发远程更新
+   * @returns {Transform} 相机变换的代理对象
+   */
+  get transform() {
+    return createDeepProxy(this._transform, {}, this._collector)
+  }
+
+  /**
+   * 触发远程更新
+   * 该方法在相机属性或变换变化时被调用，用于标记相机需要同步到远程
+   */
+  protected _triggerRemoteUpdate() {
+    this._remoteUpdateFlag = true
+    this._remoteUpdate()
+  }
+
+  /**
+   * 远程更新处理方法
+   * 用于将相机的属性和变换同步到远程服务器
+   * TODO: 实现具体的远程同步逻辑
+   */
+  protected _remoteUpdate() {
+    // TODO: 实现相机属性和变换的远程同步逻辑
+    this._rpc.setCameraTransform(this._transform.toRPCJSON())
+    this._remoteUpdateFlag = true
+  }
+}

package/hj-gis-sdk/addons/clock.ts

@@ -0,0 +1,85 @@
+// 创建一个 Clock ， 计算每次的时间差 ， 同时保存开始的时间
+export class Clock {
+  private startTime: number;
+  private previousTime: number;
+  private elapsedTime: number;
+  private isRunning: boolean;
+
+  constructor() {
+    this.startTime = 0;
+    this.previousTime = 0;
+    this.elapsedTime = 0;
+    this.isRunning = false;
+  }
+
+  /**
+   * 开始计时
+   */
+  start(): void {
+    this.startTime = performance.now();
+    this.previousTime = this.startTime;
+    this.elapsedTime = 0;
+    this.isRunning = true;
+  }
+
+  /**
+   * 停止计时
+   */
+  stop(): void {
+    this.getDelta(); // 更新 elapsedTime
+    this.isRunning = false;
+  }
+
+  /**
+   * 获取自上次调用 getDelta() 以来经过的时间（时间差）
+   * @returns 时间差（毫秒）
+   */
+  getDelta(): number {
+    let currentTime = performance.now();
+    let delta = 0;
+
+    if (this.isRunning) {
+      delta = currentTime - this.previousTime;
+      this.elapsedTime += delta;
+      this.previousTime = currentTime;
+    }
+
+    return delta;
+  }
+
+  /**
+   * 获取自开始计时以来经过的总时间
+   * @returns 经过的总时间（毫秒）
+   */
+  getElapsedTime(): number {
+    if (this.isRunning) {
+      this.getDelta(); // 更新 elapsedTime
+    }
+    return this.elapsedTime;
+  }
+
+  /**
+   * 获取开始时间
+   * @returns 开始时间（毫秒）
+   */
+  getStartTime(): number {
+    return this.startTime;
+  }
+
+  /**
+   * 检查是否正在运行
+   * @returns 是否正在运行
+   */
+  isRunningState(): boolean {
+    return this.isRunning;
+  }
+
+  /**
+   * 重置计时器
+   */
+  reset(): void {
+    this.startTime = performance.now();
+    this.previousTime = this.startTime;
+    this.elapsedTime = 0;
+  }
+}

package/hj-gis-sdk/addons/commander/context.ts

@@ -0,0 +1,70 @@
+import mitt, { Emitter } from 'mitt'
+
+interface Viewport {
+  width: number
+  height: number
+}
+
+export class Context {
+  private hover: any = null
+  private click: any = null
+  private viewport: Viewport = { width: 0, height: 0 }
+  private emitter: Emitter<any>
+  private clickLastZone: string | null = null
+
+  constructor() {
+    this.emitter = mitt<any>()
+  }
+
+  on<T extends keyof any>(event: T, handler: (data: any[T]) => void): void {
+    this.emitter.on(event, handler)
+  }
+
+  off<T extends keyof any>(event: T, handler: (data: any[T]) => void): void {
+    this.emitter.off(event, handler)
+  }
+
+  emit<T extends keyof any>(event: T, data: any[T]): void {
+    this.emitter.emit(event, data)
+  }
+
+  getHover(): any {
+    return this.hover
+  }
+
+  getClick(): any {
+    return this.click
+  }
+
+  getViewport(): Viewport {
+    return { ...this.viewport }
+  }
+
+  setHover(hover: any): void {
+    this.hover = hover
+    this.emit('hover', hover)
+  }
+
+  setClick(click: any): void {
+    this.click = click
+    this.emit('click', click)
+  }
+
+  setClickLastZone(str: string): void {
+    this.clickLastZone = str
+  }
+
+  setViewport(viewport: Viewport): void {
+    const isChanged =
+      viewport.width !== this.viewport.width ||
+      viewport.height !== this.viewport.height
+
+    this.viewport = { ...viewport }
+
+    if (isChanged) {
+      this.emit('viewport', this.viewport)
+    }
+  }
+}
+
+export default Context

package/hj-gis-sdk/addons/commander/dispatcher.ts

@@ -0,0 +1,68 @@
+import IGISExecutor, { Message } from './excutor/base'
+import { Logger } from '@epicgames-ps/lib-pixelstreamingcommon-ue5.5'
+/**
+ * 定义命令类型枚举
+ */
+export type CommandType =
+  | 'POIClicked'
+  | 'POICollapsed'
+  | 'POIExpanded'
+  | 'POIHoverBegin'
+  | 'POIHoverEnd'
+
+/**
+ * 屏幕位置接口
+ */
+export interface ScreenPosition {
+  relativeX: number
+  relativeY: number
+  x: number
+  y: number
+  viewportWidth: number
+  viewportHeight: number
+}
+
+/**
+ * 地理位置接口
+ */
+export interface GeoLocation {
+  latitude: number
+  longitude: number
+}
+
+/**
+ * GIS 事件的分发器
+ * 1. 事件的注册
+ * 2. 事件的分发
+ */
+export default class Dispatcher {
+  private excutors: IGISExecutor[] = []
+
+  /**
+   * 注册执行器
+   * @param excutor 单个执行器或执行器数组
+   */
+  register(excutor: IGISExecutor | IGISExecutor[]): void {
+    if (Array.isArray(excutor)) {
+      this.excutors.push(...excutor)
+    } else {
+      this.excutors.push(excutor)
+    }
+  }
+
+  /**
+   * 分发消息到匹配的执行器
+   * @param rawMessage 原始JSON消息字符串
+   * @returns 无返回值
+   */
+  dispatch(rawMessage: string): void {
+    const message: Message = JSON.parse(rawMessage)
+    Logger.Info(`dispatcher message: ${rawMessage}`)
+    for (const excutor of this.excutors) {
+      const matched = excutor.match(message)
+      if (matched) {
+        excutor.execute(message)
+      }
+    }
+  }
+}

package/hj-gis-sdk/addons/commander/excutor/base.ts

@@ -0,0 +1,26 @@
+import Context from '../context'
+export type Message = any
+/**
+ * GIS 事件执行器 Interface
+ * 1. 判断事件是否属于这个执行器
+ * 2. 执行事件
+ */
+export default abstract class IGISExecutor {
+  protected context: Context
+
+  constructor(context: Context) {
+    this.context = context
+  }
+
+  /**
+   * 判断事件是否属于这个执行器
+   * @param message 消息对象
+   */
+  abstract match(message: Message): boolean
+
+  /**
+   * 执行事件
+   * @param message 消息对象
+   */
+  abstract execute(message: Message): void
+}

package/hj-gis-sdk/addons/loader/index.ts

@@ -0,0 +1,7 @@
+import { Loader } from './loader'
+import Node from '../node/base'
+export class URLLoader implements Loader<Node> {
+  async loader(url: string): Promise<Node> {
+    throw new Error('Method not implemented.')
+  }
+}