npm - hj-gis-sdk - Versions diffs - 1.0.0 - Mend

hj-gis-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (93) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,824 @@
+# GIS SDK 文档
+## 1. 简介
+GIS SDK 是一个基于 Unreal Engine Pixel Streaming 技术的地理信息系统开发工具包，提供了与 Unreal Engine 进行 RPC 通信的能力，支持加载地图、生成静态网格体、操作相机、创建热力图、电子围栏等丰富功能。
+### 1.1 主要特性
+- **Unreal Engine 通信**：基于 Pixel Streaming DataChannel 的 RPC 通信机制
+- **地图管理**：加载、卸载地图和关卡
+- **对象管理**：生成、销毁静态网格体和蓝图对象
+- **相机控制**：管理相机位置、旋转和变换
+- **屏幕拾取**：支持屏幕坐标到 3D 世界坐标的转换
+- **建筑分解**：支持建筑整体或分层展开、折叠动画
+- **动画系统**：支持骨骼动画播放、关键帧动画控制
+- **热力图**：基于灰度图或点集生成热力图
+- **电子围栏**：创建和管理多边形电子围栏
+- **天气系统**：控制场景天气效果
+- **散点图**：创建和管理散点标记
+- **测量工具**：支持距离、面积、高度测量
+## 2. 安装
+### 2.1 依赖项
+- Node.js 18.14.0+ 或 20.0.0+ 或 22.0.0+ 或 24.0.0+
+- @epicgames-ps/lib-pixelstreamingfrontend-ue5.5
+### 2.2 安装 SDK
+```bash
+npm install @epicgames-ps/lib-pixelstreamingfrontend-ue5.5 @epicgames-ps/lib-pixelstreamingcommon-ue5.5 hj-gis-sdk
+```
+### 2.3 引入 SDK
+```javascript
+import { Core, Addons } from 'hj-gis-sdk'
+```
+## 3. 核心概念
+### 3.1 UERPCNode
+UERPCNode 类代表场景中的一个对象节点，如地图、静态网格体或蓝图对象。它提供了对象的基本操作，如添加、移除和变换设置。每个 UERPCNode 实例都有一个唯一的句柄(Handle)，用于与 Unreal Engine 进行通信。
+### 3.2 World
+World 类代表整个场景世界，是场景中所有对象的根容器。它管理场景中的地图、静态网格体、蓝图对象等，并提供了丰富的工具类访问接口，如建筑分解、热力图、电子围栏等。
+### 3.3 Camera
+Camera 类代表场景中的相机，用于控制视角和观察场景。它支持位置、旋转、缩放和相机参数(如 FOV、焦距)的设置和获取。SDK 提供了 PerspectiveCamera 等不同类型的相机实现。
+### 3.4 Transform
+Transform 类代表对象的变换信息，包括位置(Location)、旋转(Rotation)和缩放(Scale)。每个属性都包含 X、Y、Z 三个分量，用于精确控制对象的空间状态。
+### 3.5 UERPC
+UERPC 是 SDK 的核心通信类，负责与 Unreal Engine 进行 RPC 通信。它封装了 Pixel Streaming 的 DataChannel，提供了发送命令和接收响应的机制。所有与 Unreal Engine 的交互都通过 UERPC 类进行。
+## 4. 快速开始
+### 4.1 初始化应用
+```javascript
+import {
+  PixelStreaming,
+  Config,
+  Flags
+} from '@epicgames-ps/lib-pixelstreamingfrontend-ue5.5'
+import { Addons } from 'hj-gis-sdk'
+import { Logger, LogLevel } from '@epicgames-ps/lib-pixelstreamingcommon-ue5.5'
+// 初始化日志
+Logger.InitLogging(LogLevel.Info, false)
+const { World, PerspectiveCamera } = Addons
+async function initializeApp() {
+  // 创建 PixelStreaming 实例
+  const url = `ws://your-server-url:9001/player`
+  const config = new Config({
+    initialSettings: {
+      ss: url,
+      StreamerId: '',
+      AutoPlayVideo: true,
+      StartVideoMuted: true,
+      [Flags.HoveringMouseMode]: true, // 启用悬停鼠标模式
+      [Flags.TouchInput]: true, // 启用触摸输入
+      [Flags.FakeMouseWithTouches]: true // 使用触摸模拟鼠标
+    }
+  })
+  // 创建 PixelStreaming 实例并设置视频元素容器
+  const stream = new PixelStreaming(config, {
+    videoElementParent: document.querySelector('#ue')
+  })
+  // 连接到 Pixel Streaming 服务
+  stream.connect()
+  // 等待流播放事件
+  let { resolve, promise } = Promise.withResolvers()
+  stream.addEventListener('playStream', () => resolve(null))
+  await promise
+  // 创建 World 和 Camera 实例
+  const world = new World(stream)
+  // 匹配视图
+  world.tools.matchView.excute()
+  // 创建相机实例
+  const camera = new PerspectiveCamera(world.rpc)
+  // 设置相机初始位置
+  camera.transform.position.set(0, 0, 2)
+  return { world, camera }
+}
+// 初始化应用
+initializeApp()
+  .then(({ world, camera }) => {
+    console.log('应用初始化完成')
+    // 在这里可以使用 world 和 camera 对象
+  })
+  .catch((err) => console.error('应用初始化失败:', err))
+```
+### 4.2 基本使用流程
+1. **创建 HTML 容器**
+```html
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>GIS SDK - 示例</title>
+    <style>
+      .ue-wrap {
+        position: fixed;
+        width: 100vw;
+        height: 100vh;
+      }
+    </style>
+  </head>
+  <body style="margin: 0">
+    <div class="ue-wrap">
+      <div id="ue"></div>
+    </div>
+    <!-- 引入SDK -->
+    <script type="module">
+      // 导入初始化代码
+      import './src/common.js'
+    </script>
+  </body>
+</html>
+```
+2. **使用模块化功能**
+```javascript
+// 导入需要的模块
+import { Addons } from 'hj-gis-sdk'
+import { initializeApp } from './common'
+const { World, PerspectiveCamera } = Addons
+// 初始化应用
+const { world, camera } = await initializeApp(
+  'ws://your-server-url:9001/player',
+  document.querySelector('#ue')
+)
+// 加载地图
+const map = await world.loadLevelByName('plgz')
+// 创建热力图
+const heatmap = await world.tools.heatMap.create({
+  url: 'http://example.com/heatmap.png',
+  X: 0,
+  Y: 0,
+  Z: 0,
+  ScaleX: 100,
+  ScaleY: 100,
+  ScaleZ: 100
+})
+```
+## 5. 详细使用示例
+### 5.1 地图管理
+地图管理功能用于加载、卸载和管理场景中的地图。
+```javascript
+// 加载地图
+const map = await world.loadLevelByName('plgz')
+// 设置地图位置
+map.transform.position.set(100, 200, 300)
+// 销毁地图
+map.remove()
+```
+### 5.2 静态网格体管理
+静态网格体是场景中最基本的可见对象，可以是模型、建筑等。
+```javascript
+// 生成静态网格体
+const staticMesh = await world.spawnStaticMeshActor({
+  assetPath: '/Game/Mesh/test/63',
+  transform: new Transform({
+    position: { x: 100, y: 100, z: 100 },
+    rotation: { pitch: 0, yaw: 0, roll: 0 },
+    scale: { x: 1, y: 1, z: 1 }
+  })
+})
+// 修改静态网格体位置
+staticMesh.transform.position.x = 200
+// 修改静态网格体旋转
+staticMesh.transform.rotation.yaw = 45
+// 修改静态网格体缩放
+staticMesh.transform.scale.set(2, 2, 2)
+// 销毁静态网格体
+staticMesh.remove()
+// 通过对象直接设置变换
+staticMesh.transform.position.set(300, 300, 300)
+staticMesh.transform.rotation.set(0, 90, 0)
+staticMesh.transform.scale.set(1.5, 1.5, 1.5)
+```
+### 5.3 蓝图对象管理
+蓝图对象是基于 Unreal Engine 蓝图创建的复杂对象，可以包含多个组件和自定义逻辑。
+```javascript
+// 生成本地蓝图对象
+const blueprint = await world.spawnLocalBlueprintActor({
+  assetPath: '/Game/levels/smith/SHQPXJ_Blueprint'
+})
+// 设置蓝图对象位置
+blueprint.transform.position.set(300, 400, 500)
+// 销毁蓝图对象
+blueprint.remove()
+// 生成带初始变换的蓝图对象
+const blueprintWithTransform = await world.spawnLocalBlueprintActor({
+  assetPath: '/Game/Blueprints/BP_TestActor',
+  transform: {
+    Location: { X: 0, Y: 0, Z: 200 },
+    Rotation: { Pitch: 0, Yaw: 90, Roll: 0 },
+    Scale: { X: 1, Y: 1, Z: 1 }
+  }
+})
+```
+### 5.4 相机控制
+相机控制用于调整场景的观察视角，可以设置位置、旋转和相机参数。
+```javascript
+// 设置相机位置
+camera.transform.position.set(1000, 2000, 3000)
+// 设置相机旋转
+camera.transform.rotation.set(-12.26, 126.94, 0)
+// 设置相机缩放
+camera.transform.scale.set(1, 1, 1)
+// 强制同步远程相机参数到本地
+await camera.forceSyncRemoteToLocal()
+// 保存相机复位位姿
+await camera.setResetTransform({
+  Location: { X: 0, Y: 0, Z: 500 },
+  Rotation: { Pitch: -20, Yaw: 0, Roll: 0 }
+})
+// 复位相机到保存的位姿
+await camera.resetToSavedTransform()
+```
+### 5.5 屏幕拾取
+屏幕拾取功能用于将屏幕坐标转换为 3D 世界坐标，并获取该位置的对象信息。
+```javascript
+// 设置屏幕拾取回调
+const hoverHandle = world.tools.pickCast.hover((data) => {
+  console.log('拾取到的对象:', data)
+  console.log('世界坐标:', data.World)
+  console.log('地理坐标:', data.Geo)
+})
+// 取消屏幕拾取
+hoverHandle()
+// 世界坐标可以通过屏幕拾取回调获取
+```
+### 5.6 视觉虚化
+视觉虚化功能用于将场景中的对象设置为半透明状态，便于查看复杂场景。
+```javascript
+// 将对象设置为虚化状态
+let ghostHandle = await world.tools.ghost.ghost(staticMesh)
+// 恢复对象正常显示
+if (ghostHandle) {
+  ghostHandle.restore()
+}
+```
+### 5.7 建筑分解
+建筑分解功能用于将建筑模型按照楼层或部分进行展开和折叠，便于查看内部结构。
+```javascript
+// 加载建筑蓝图
+const building = await world.spawnLocalBlueprintActor({
+  assetPath: '/Game/Mesh/Lou/Lou.Lou'
+})
+// 展开建筑
+const expandHandler = await world.tools.building.expand(building.key!, {
+  spacing: 50, // 展开间距
+  duration: 2.0 // 动画时长
+})
+// 展开特定楼层
+await expandHandler.expandFloor({
+  floorIndex: 2, // 楼层索引
+  direction: { X: -1, Y: 0, Z: 0 }, // 展开方向
+  distance: 100, // 展开距离
+  duration: 1.5 // 动画时长
+})
+```
+### 5.8 动画系统
+动画系统支持骨骼动画播放和基于关键帧的动画控制。
+```javascript
+// 加载骨骼网格体
+const skeletalMesh = await world.spawnSkeletalMesh({
+  assetPath: '/Game/Mesh/Human/Jog_In_Circle.Jog_In_Circle'
+})
+// 创建动画混合器
+const animationMixer = new Animation.AnimationMixer(world.rpc)
+// 创建动画片段
+const animateClip = new Animation.PresetAnimateClip('/Game/Mesh/Human/Jog_In_Circle_Anim.Jog_In_Circle_Anim')
+// 创建动画动作
+const animateAction = animationMixer.clipAction(animateClip, skeletalMesh)
+// 设置动画参数
+animateAction.type = 'loop' // 循环播放
+animateAction.rate = 1.0 // 播放速度
+// 播放动画
+animateAction.play()
+// 暂停动画
+animateAction.pause()
+// 创建关键帧动画
+const keyframeClip = new Animation.KeyFrameAnimateClip({
+  startTransform: Transform.default(),
+  endTransform: Transform.fromRPCObject({
+    Location: {
+      X: 100,
+      Y: 100,
+      Z: 0
+    },
+    Rotation: {
+      Pitch: 0,
+      Yaw: 180,
+      Roll: 0
+    }
+  })
+})
+// 创建关键帧动画动作
+const keyframeAction = animationMixer.clipAction(keyframeClip, skeletalMesh)
+keyframeAction.duration = 3.0 // 动画时长
+// 播放关键帧动画
+keyframeAction.play()
+```
+### 5.9 热力图
+热力图功能用于基于数据创建可视化的热力分布效果。
+```javascript
+// 创建Transform对象
+const transform = Transform.default()
+transform.scale.scale(100) // 设置缩放
+// 从灰度图创建热力图
+const heatmapFromImage = await world.tools.heatMap.create({
+  url: 'http://example.com/heatmap.png',
+  transform: transform
+})
+// 从点集创建热力图
+const heatmapFromPoints = await world.tools.heatMap.create({
+  transform: transform,
+  points: [
+    { x: 0, y: 0, count: 100 },
+    { x: 10, y: 10, count: 200 },
+    { x: 20, y: 20, count: 150 }
+  ]
+})
+// 销毁热力图
+heatmapFromImage.remove()
+```
+### 5.10 电子围栏
+电子围栏功能用于创建和管理多边形的虚拟围栏。
+```javascript
+// 创建电子围栏
+const fence = await world.tools.fence.create({
+  vectorArray: [
+    { X: 0, Y: 0, Z: 0 },
+    { X: 1000, Y: 0, Z: 0 },
+    { X: 1000, Y: 1000, Z: 0 },
+    { X: 0, Y: 1000, Z: 0 }
+  ],
+  height: 10, // 围栏高度
+  color: { R: 0, G: 0, B: 255, A: 255 } // 围栏颜色
+})
+// 删除围栏
+await fence.remove()
+```
+### 5.11 天气系统
+天气系统用于控制场景中的天气效果，如晴天、雨天、雪天等。
+```javascript
+// 设置天气类型
+await world.tools.weather.setWeather({
+  Preset: 'Rain' // 可选：'Sunny', 'Rain', 'Snow', 'Foggy'
+})
+// 设置时间
+await world.tools.weather.setDayTime({
+  value: 1430 // 时间格式：HHMM，1430表示14:30
+})
+```
+### 5.12 散点图
+散点图功能用于在场景中创建和管理标记点。
+```javascript
+// 创建散点
+const scatter = await world.tools.scatter.create({
+  pointParams: [
+    {
+      location: { X: 0, Y: 0, Z: 10 },
+      textContent: '标记点1',
+      tag: 'Demo'
+    },
+    {
+      location: { X: 100, Y: 100, Z: 10 },
+      textContent: '标记点2',
+      tag: 'Demo'
+    }
+  ]
+})
+// 删除所有散点
+await scatter.removeAll()
+```
+### 5.13 测量工具
+测量工具用于测量场景中的距离、面积和高度。
+```javascript
+// 开始路径测量
+await world.tools.measurement.draw(MeasurementType.Path)
+// 开始面积测量
+await world.tools.measurement.draw(MeasurementType.Area)
+// 开始高度测量
+await world.tools.measurement.draw(MeasurementType.Height)
+// 取消测量
+await world.tools.measurement.clean()
+```
+## 6. 核心功能实现代码
+以下是从 GUI 示例中提取的核心功能实现代码（不包含 GUI 部分）：
+### 6.1 初始化应用
+```javascript
+import { PixelStreaming, Config, Logger, LogLevel, Flags } from '@epicgames-ps/lib-pixelstreamingfrontend-ue5.5'
+import { Addons } from 'hj-gis-sdk'
+const { World, PerspectiveCamera, UERPCNode } = Addons
+Logger.InitLogging(LogLevel.Info, false)
+const AppElement = document.querySelector('#ue')! as HTMLElement
+let world: InstanceType<typeof World> | undefined = undefined
+let camera: InstanceType<typeof PerspectiveCamera> | undefined = undefined
+let blueprint: InstanceType<typeof UERPCNode> | undefined = undefined
+let staticmesh: InstanceType<typeof UERPCNode> | undefined = undefined
+let map: InstanceType<typeof UERPCNode> | undefined = undefined
+/**
+ * 初始化应用
+ */
+async function initializeApp() {
+  const url = `ws://120.27.198.158:9001/player`
+  const config = new Config({
+    initialSettings: {
+      ss: url,
+      StreamerId: '',
+      AutoPlayVideo: true,
+      StartVideoMuted: true,
+      [Flags.HoveringMouseMode]: true,
+      [Flags.TouchInput]: true,
+      [Flags.FakeMouseWithTouches]: true
+    }
+  })
+  const stream = new PixelStreaming(config, {
+    videoElementParent: AppElement
+  })
+  stream.connect()
+  let { resolve, promise } = Promise.withResolvers()
+  stream.addEventListener('playStream', () => {
+    console.log('PlayStreamEvent')
+    resolve(null)
+  })
+  await promise
+  world = new World(stream)
+  world.tools.matchView.excute()
+  camera = new PerspectiveCamera(world.rpc)
+  camera.transform.position.set(0, 0, 2)
+}
+```
+### 6.2 地图加载与销毁
+```javascript
+// 加载地图
+async function loadMap(selectedMap: string) {
+  map = await world!.loadLevelByName(selectedMap)
+  // 设置相机视角
+  camera!.transform.rotation.pitch = -12.259792797845645
+  camera!.transform.rotation.yaw = 126.9423080594274
+  camera!.transform.rotation.roll = 0.00003001662846458654
+  camera!.transform.position.set(
+    -234809.24784008358,
+    -74593.71088085348,
+    13755.085257765979
+  )
+}
+// 销毁地图
+function destroyMap() {
+  map!.remove()
+}
+```
+### 6.3 蓝图对象加载与销毁
+```javascript
+// 加载蓝图对象
+async function loadBlueprint(assetPath: string) {
+  blueprint = await world!.spawnLocalBlueprintActor({
+    assetPath: assetPath
+  })
+}
+// 销毁蓝图对象
+function destroyBlueprint() {
+  blueprint!.remove()
+}
+```
+### 6.4 静态网格体加载与销毁
+```javascript
+// 加载静态网格体
+async function loadStaticMesh(assetPath: string) {
+  staticmesh = await world!.spawnStaticMeshActor({
+    assetPath: assetPath
+  })
+}
+// 销毁静态网格体
+function destroyStaticMesh() {
+  staticmesh!.remove()
+}
+```
+### 6.5 相机参数控制
+```javascript
+// 设置相机位置
+function setCameraPosition(x: number, y: number, z: number) {
+  if (camera) {
+    camera.transform.position.x = x
+    camera.transform.position.y = y
+    camera.transform.position.z = z
+  }
+}
+// 设置相机旋转
+function setCameraRotation(pitch: number, yaw: number, roll: number) {
+  if (camera) {
+    camera.transform.rotation.pitch = pitch
+    camera.transform.rotation.yaw = yaw
+    camera.transform.rotation.roll = roll
+  }
+}
+```
+### 6.6 静态网格体参数控制
+```javascript
+// 设置静态网格体位置
+function setStaticMeshPosition(x: number, y: number, z: number) {
+  if (staticmesh) {
+    staticmesh.transform.position.x = x
+    staticmesh.transform.position.y = y
+    staticmesh.transform.position.z = z
+  }
+}
+// 设置静态网格体旋转
+function setStaticMeshRotation(pitch: number, yaw: number, roll: number) {
+  if (staticmesh) {
+    staticmesh.transform.rotation.pitch = pitch
+    staticmesh.transform.rotation.yaw = yaw
+    staticmesh.transform.rotation.roll = roll
+  }
+}
+// 设置静态网格体缩放
+function setStaticMeshScale(x: number, y: number, z: number) {
+  if (staticmesh) {
+    staticmesh.transform.scale.x = x
+    staticmesh.transform.scale.y = y
+    staticmesh.transform.scale.z = z
+  }
+}
+```
+### 6.7 屏幕拾取功能
+```javascript
+let hoverHandle: any
+// 开始屏幕拾取
+function startHover() {
+  console.log(`pick`)
+  hoverHandle = world!.tools.pickCast.hover((data) => {
+    console.log(`hover data`, data)
+  })
+}
+// 结束屏幕拾取
+function stopHover() {
+  if (hoverHandle) {
+    hoverHandle()
+  }
+}
+```
+### 6.8 应用初始化
+```javascript
+// 判断 window 是否初始化完成
+if (document.readyState === 'loading') {
+  // 文档正在加载，等待DOMContentLoaded事件
+  document.addEventListener('DOMContentLoaded', initializeApp)
+} else {
+  // 文档已经加载完成，直接初始化应用
+  initializeApp()
+}
+```
+## 7. 常见问题
+### 7.1 连接失败
+- 确保 Pixel Streaming 服务器正在运行
+- 检查 URL 是否正确，格式应为 `ws://your-server-url:9001/player`
+- 确保服务器端口未被防火墙阻止
+- 检查网络连接是否正常
+### 7.2 对象不显示
+- 确保对象的资源路径正确，格式应为 `/Game/Path/To/Asset`
+- 检查对象的位置是否在相机的可见范围内
+- 确保对象的缩放比例合适，避免过大或过小
+- 检查对象的材质和渲染设置是否正确
+### 7.3 性能问题
+- 优化 RPC 调用频率，避免频繁的远程操作
+- 减少同时显示的对象数量，特别是复杂模型
+- 合理设置相机的视锥体和渲染距离
+- 避免在短时间内创建和销毁大量对象
+- 使用批量操作代替单个操作
+### 7.4 动画不播放
+- 确保骨骼动画资源路径正确
+- 检查动画名称是否与 Unreal Engine 中的动画名称一致
+- 确保动画组件已正确配置在蓝图中
+- 检查是否有其他动画正在播放并冲突
+### 7.5 屏幕拾取不工作
+- 确保鼠标坐标转换正确，考虑画布的缩放和偏移
+- 检查拾取的最大距离设置是否足够
+- 确保场景中有可拾取的对象
+- 检查 Unreal Engine 中的碰撞设置是否正确
+### 7.6 建筑分解失败
+- 确保建筑蓝图支持分解功能
+- 检查 BuildingID 是否正确
+- 确保建筑模型的楼层数据已正确配置
+- 检查展开参数是否在合理范围内
+### 7.7 热力图显示异常
+- 确保灰度图 URL 可访问且格式正确
+- 检查 MeshSize 和 MeshSegment 参数设置是否合理
+- 调整 Opacity 和 EmissiveStrength 参数以获得更好的视觉效果
+- 确保热力图的位置和缩放设置正确
+## 8. 底层API参考
+本GIS SDK是对底层UERPC功能的封装，旨在为开发者提供更便捷、更友好的调用接口。
+### 8.1 UERPC文档链接
+如果您需要了解更多底层功能或希望构建更灵活的架构，可以参考完整的UERPC文档：
+[UERPC前端API使用指南](./README_UERPC.md)
+### 8.2 关于封装说明
+GIS SDK的所有接口调用均基于UERPC文档中提供的功能进行封装。这些封装旨在简化开发流程，提供更直观的API设计和更强大的类型支持。
+如果您对当前架构不满意，或需要实现更复杂的功能，可以直接基于`README_UERPC.md`文档中提供的UERPC核心功能进行自定义封装，以满足您的特定需求。
+### 8.3 封装与原生API的关系
+- **便捷性**：GIS SDK将复杂的UERPC调用封装为简单的对象方法
+- **类型安全**：提供完整的TypeScript类型定义，减少开发错误
+- **架构优化**：采用面向对象的设计，使代码更易于维护和扩展
+- **灵活性**：保留了UERPC的核心功能，同时提供了更高级的抽象
+无论您选择使用GIS SDK的封装接口还是直接使用UERPC原生API，都可以实现与Unreal Engine的高效通信和交互。
+## 9. 更新日志
+### 1.0.0
+- 初始版本发布
+- 支持地图管理
+- 支持静态网格体和蓝图对象管理
+- 支持相机控制
+- 支持屏幕拾取
+### 1.1.0
+- 新增建筑分解功能
+- 新增动画系统（骨骼动画和关键帧动画）
+- 新增热力图功能
+- 新增电子围栏功能
+### 1.2.0
+- 新增天气系统
+- 新增散点图功能
+- 新增测量工具
+- 新增视觉虚化功能
+### 1.3.0
+- 优化 RPC 通信性能
+- 改进文档和示例
+- 修复已知 bug
+- 增强跨浏览器兼容性