Three.js 物理ammo使用教程

2026/7/23 10:34:58

物理ammo使用 ·Ammo Physics· ▶ 在线运行案例

案例合集：三维可视化功能案例（threehub.cn）
开源仓库github地址：https://github.com/z2586300277/three-cesium-examples
400个案例代码:网盘链接

你将学到什么

OrbitControls 相机轨道交互
requestAnimationFrame渲染循环与resize自适应

效果说明

本案例演示物理ammo使用效果：基于 WebGL 实现「物理ammo使用」可视化效果，附完整可运行源码；核心用到 OrbitControls。建议先打开文首在线案例查看动态画面，再对照下方源码逐步理解。

核心概念

Scene / Camera / WebGLRenderer构成最小渲染闭环；大场景可开logarithmicDepthBuffer缓解 Z-fighting。
OrbitControls提供轨道旋转/缩放；开启enableDamping后需在 animate 中controls.update()。
阅读下方完整源码时，建议从init/load/animate三条主线入手，再深入 shader 与工具函数。

实现步骤

搭建 Scene、PerspectiveCamera、WebGLRenderer，挂载 canvas 并处理resize
创建 OrbitControls（及 Raycaster 等交互控件，若源码包含）
在requestAnimationFrame循环中更新状态并 render（Cesium 为viewer.render或自动渲染）

代码要点

import * as THREE from 'three'import { OrbitControls } from 'three/addons/controls/OrbitControls.js' import { AmmoPhysics } from 'three/addons/physics/AmmoPhysics.js'
const box = document.getElementById('box')
const scene = new THREE.Scene()
const camera = new THREE.PerspectiveCamera(60, box.clientWidth / box.clientHeight, 1, 10000)
camera.position.set(15, 15, 15)
const renderer = new THREE.WebGLRenderer({ antialias: true })
renderer.setSize(box.clientWidth, box.clientHeight)
box.appendChild(renderer.domElement)
new OrbitControls(camera, renderer.domElement)
scene.add(new THREE.DirectionalLight(0xffffff, 3))
// 安装 const physics = await AmmoPhysics()
const floor = new THREE.Mesh(new THREE.BoxGeometry(60, 5, 60), new THREE.MeshLambertMaterial({ color: 0x444444 }))
floor.position.y -= 20
floor.userData.physics = { mass: 0 }
scene.add(floor)
for (let i = 0; i < 100; i++) {
const geometry = Math.random() > 0.5 ? new THREE.IcosahedronGeometry() : new THREE.SphereGeometry()
const material = new THREE.MeshLambertMaterial({ color: 0xffffff * Math.random() })
const mesh = new THREE.Mesh(geometry, material)
mesh.position.set(Math.random() - 0.5, Math.random() * 2, Math.random() - 0.5)
mesh.userData.physics = { mass: 1 }
scene.add(mesh)
}
physics.addScene(scene) // 启动物理引擎
animate()
function animate() {
renderer.render(scene, camera)requestAnimationFrame(animate) }