@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.9

package/{documention → documentation}/KeyboardCameraController.html

@@ -528,7 +528,54 @@
     
 
     
-    <pre class="prettyprint"><code>// 参考示例：
  new Cesium.Cesium3DTileset({
    url: 'http://192.168.82.89:8200/3DData/ModelCache/3DTileset/1.0/dayantaresult/tileset.json'
  })
  enableMouseLook: false,
  enableDynamicMoveStep: false,
  moveStep: 0.2,
  initView: {
    destination: Cesium.Cartesian3.fromDegrees(108.9594, 34.2184, 8),
    orientation: {
      heading: 0,
      pitch: 0,
      roll: 0
    }
  }
+    <pre class="prettyprint"><code>// 参考示例：
+http://10.10.130.72:8086/#/modules/cesium/sceneControl/camera/keyboard-roaming
+
+// ES5引入方式
+const { KeyboardCameraController } = zondy
+
+// ES6引入方式
+import { KeyboardCameraController } from "@mapgis/webclient-cesium-plugin"
+
+// 初始化视图对象
+let viewer = new Cesium.Viewer("cesiumContainer");
+
+// 加载模型
+let tilesetModel = viewer.scene.primitives.add(
+  new Cesium.Cesium3DTileset({
+    url: 'http://192.168.82.89:8200/3DData/ModelCache/3DTileset/1.0/dayantaresult/tileset.json'
+  })
+);
+
+// 视角定位到模型
+viewer.zoomTo(tilesetModel);
+
+// 实例化CameraRoamingTool对象
+let cameraRoaming = new KeyboardCameraController(viewer, {
+  enableMouseLook: false,
+  enableDynamicMoveStep: false,
+  moveStep: 0.2,
+  initView: {
+    destination: Cesium.Cartesian3.fromDegrees(108.9594, 34.2184, 8),
+    orientation: {
+      heading: 0,
+      pitch: 0,
+      roll: 0
+    }
+  }
+});
+
+// 开启碰撞检测
+cameraRoaming.enableCollisionDetection = true;
+
+// 说明：当enableMouseLook参数为true时，开启漫游后页面将进入全屏模式，由于浏览器安全策
+// 略的限制，此时start()方法必需由一个用户手势触发（如主动点击按钮），而不能由程序被动触发
+
+// 开始漫游
+cameraRoaming.start();
+
+// 停止漫游
+cameraRoaming.stop();</code></pre>
     
 
     
@@ -885,7 +932,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/tools/KeyboardCameraController.js, line 293
+            engineExtensions/tools/KeyboardCameraController.js, line 283
         </div>
         
     </div>
@@ -896,7 +943,7 @@
     
     
     <div class="description">
-        <p>开始场景相机漫游</p>
+        <p>开始场景相机漫游并注册键盘、鼠标和时钟监听。</p>
     </div>
     
 
@@ -956,7 +1003,7 @@
     
         
         <div class="tag-source">
-            engineExtensions/tools/KeyboardCameraController.js, line 553
+            engineExtensions/tools/KeyboardCameraController.js, line 520
         </div>
         
     </div>
@@ -967,7 +1014,8 @@
     
     
     <div class="description">
-        <p>停止场景相机漫游，若在全屏状态下，则无需调用该方法停止场景相机漫游，只需要按下<code>ESC</code>或<code>F11</code></p>
+        <p>停止场景相机漫游并解除键盘、时钟和碰撞检测相关监听。
+若当前处于全屏模式，也可以直接按下 <code>ESC</code> 或 <code>F11</code> 退出。</p>
     </div>
     
 
@@ -1030,7 +1078,7 @@
 
 
         <footer>
-            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Fri Feb 06 2026 14:59:54 GMT+0800 (中国标准时间)
+            Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> on Sat Sep 12 2026 11:55:59 GMT+0800 (中国标准时间)
         </footer>
     </div>
 </div>