2026年11月18日 星期三

從 Choo-Choo World 認識 Three.js 互動式 3D 世界的十大技術

從 Choo-Choo World 認識 Three.js 互動式 3D 世界的十大技術

從一個可以自由拼接鐵軌、觀看火車行駛的互動網站,認識 Three.js 如何處理場景、物件、攝影機、滑鼠選取、曲線動畫與效能最佳化。

適用:科技大學《網際網路應用》與 Three.js 入門延伸課程

開啟 Choo-Choo World 體驗網站

一、為什麼選擇 Choo-Choo World?

Choo-Choo World 是 Lusion 製作的互動式 3D 火車軌道建構網站。使用者可以拼接軌道、控制火車播放、切換日夜及調整觀看視角。作品相關介紹提及 Three.js、Angular、Blender、Cinema 4D 與紋理最佳化等技術。

閱讀提醒:本文的程式碼是為了理解技術而自行設計的教學示例,不是 Choo-Choo World 原始碼。網站功能與可能採用的 Three.js API 應分開理解;部分程式片段需置於已建立 scene、camera、renderer 等變數的專案中。

二、十大技術總覽

技術學習重點
01 Scene 與 Scene GraphScene、Group、Mesh、position
02 3D 座標、旋轉與方向Vector3、Euler、Quaternion
03 Camera 與 OrbitControlsPerspectiveCamera、OrbitControls
04 Geometry、Material 與 GroupBoxGeometry、CylinderGeometry、MeshStandardMaterial
05 Raycaster 與 Pointer EventsRaycaster、Vector2、pointerdown
06 Curve 與動畫CatmullRomCurve3、getPointAt、getTangentAt
07 Animation Loop 與 Delta TimesetAnimationLoop、Clock、delta
08 Light、Texture 與日夜場景AmbientLight、DirectionalLight、Texture
09 資料結構、Undo 與場景分享JSON、URLSearchParams、localStorage
10 效能最佳化與跨裝置操作InstancedMesh、LOD、Texture Baking

三、逐項解析與程式練習

01|Scene 與 Scene Graph:建立完整的 3D 世界

場景不是一張圖片,而是由地面、樹木、鐵軌、火車與光源等物件構成的階層結構。Group 可以把車身和車輪視為一個整體。

核心 API:Scene、Group、Mesh、position

const scene = new THREE.Scene();
const train = new THREE.Group();
const body = new THREE.Mesh(
  new THREE.BoxGeometry(2, 0.8, 1),
  new THREE.MeshStandardMaterial({ color: 0xe85d3f })
);
train.add(body);
scene.add(train);
train.position.set(0, 0.5, 0);

學生練習:把車身換成兩節車廂,觀察移動父群組與移動單一車廂的差異。

02|3D 座標、旋轉與方向:鐵軌為什麼能接起來?

在三維世界中,X、Y、Z 分別描述左右、上下及前後。旋轉角度使用弧度;軌道拼接還需要考慮端點位置與朝向。

核心 API:Vector3、Euler、Quaternion

const track = new THREE.Group();
track.position.set(2, 0, -1);
track.rotation.y = Math.PI / 2; // 旋轉 90 度
scene.add(track);
const endpoint = new THREE.Vector3(1, 0, 0);
track.localToWorld(endpoint);
console.log('世界座標端點', endpoint);

學生練習:比較局部座標與世界座標;試著讓兩段直線鐵軌的端點對齊。

03|Camera 與 OrbitControls:自由觀看火車世界

網站支援旋轉、縮放與平移視角。教學可使用 OrbitControls 建立類似互動,但不能據此斷定原網站使用相同的控制器。

核心 API:PerspectiveCamera、OrbitControls

import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
const camera = new THREE.PerspectiveCamera(55, width / height, 0.1, 100);
camera.position.set(5, 6, 9);
const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = true;
controls.target.set(0, 0, 0);
// 在動畫迴圈內呼叫 controls.update();

學生練習:改變 camera.position 與 controls.target,觀察視角與注視目標的差異。

04|Geometry、Material 與 Group:組合小火車

Geometry 定義形狀,Material 定義表面,Mesh 把兩者組合;Group 則用來組織多個 Mesh。

核心 API:BoxGeometry、CylinderGeometry、MeshStandardMaterial

const wheels = new THREE.Group();
for (const x of [-0.65, 0.65]) {
  const wheel = new THREE.Mesh(
    new THREE.CylinderGeometry(0.25, 0.25, 0.15, 24),
    new THREE.MeshStandardMaterial({ color: 0x222222 })
  );
  wheel.rotation.z = Math.PI / 2;
  wheel.position.set(x, -0.35, 0);
  wheels.add(wheel);
}
train.add(wheels);

學生練習:替火車加入車窗、煙囪與不同顏色的車輪。

05|Raycaster 與 Pointer Events:用滑鼠選取鐵軌

在 3D 編輯器中,滑鼠的二維位置需要換算成攝影機射線,才能找到被點擊的物件。這是可用來重現選取操作的教學方法。

核心 API:Raycaster、Vector2、pointerdown

const raycaster = new THREE.Raycaster();
const pointer = new THREE.Vector2();
renderer.domElement.addEventListener('pointerdown', (event) => {
  const rect = renderer.domElement.getBoundingClientRect();
  pointer.x = ((event.clientX - rect.left) / rect.width) * 2 - 1;
  pointer.y = -((event.clientY - rect.top) / rect.height) * 2 + 1;
  raycaster.setFromCamera(pointer, camera);
  const hits = raycaster.intersectObjects(scene.children, true);
  if (hits.length) console.log('選到:', hits[0].object.name);
});

學生練習:讓被點選的立方體變色,並思考如何避免點擊地面時誤選其他物件。

06|Curve 與動畫:讓火車沿著鐵軌行駛

火車需要沿著路徑移動,同時調整車頭方向。Three.js 的 Curve 可取得路徑位置及切線;實際拼軌系統還需要處理軌道連接。

核心 API:CatmullRomCurve3、getPointAt、getTangentAt

const path = new THREE.CatmullRomCurve3([
  new THREE.Vector3(-3, 0, 0),
  new THREE.Vector3(-1, 0, 2),
  new THREE.Vector3(2, 0, 2),
  new THREE.Vector3(4, 0, 0)
]);
let progress = 0;
function updateTrain(delta) {
  progress = (progress + delta * 0.08) % 1;
  train.position.copy(path.getPointAt(progress));
  const tangent = path.getTangentAt(progress);
  train.rotation.y = Math.atan2(tangent.x, tangent.z);
}

學生練習:調整控制點,觀察彎道形狀;比較 getPoint() 與 getPointAt()。

07|Animation Loop 與 Delta Time:讓動畫平順

連續動畫的核心是每次更新位置、方向,再重新渲染。使用時間差可減少不同裝置影格率造成的速度差異。

核心 API:setAnimationLoop、Clock、delta

const clock = new THREE.Clock();
renderer.setAnimationLoop(() => {
  const delta = Math.min(clock.getDelta(), 0.05);
  updateTrain(delta);
  controls.update();
  renderer.render(scene, camera);
});

學生練習:嘗試移除 delta,觀察不同影格率下動畫速度為何可能改變。

08|Light、Texture 與日夜場景

網站有日夜切換;技術介紹提到使用烘焙紋理。初學者可先透過背景色與光照強度學習日夜差異,再理解 Texture Baking 的最佳化意義。

核心 API:AmbientLight、DirectionalLight、Texture

const sun = new THREE.DirectionalLight(0xffffff, 2);
scene.add(sun);
function setNight(isNight) {
  scene.background = new THREE.Color(isNight ? 0x101a35 : 0x87ceeb);
  sun.intensity = isNight ? 0.2 : 2;
}
setNight(false);

學生練習:設計白天與夜晚按鈕,記錄背景與光源改變後的視覺差異。

09|資料結構、Undo 與場景分享

網站能編輯與分享鐵軌作品。教學可將軌道類型、座標及旋轉角度轉成 JSON,並使用 URL 或本機儲存。網址中的 DATA 參數不能直接當作已知編碼規則。

核心 API:JSON、URLSearchParams、localStorage

const tracks = [
  { type: 'straight', x: 0, z: 0, angle: 0 },
  { type: 'curve', x: 1, z: 0, angle: 90 }
];
const saved = JSON.stringify(tracks);
localStorage.setItem('myTracks', saved);
const restored = JSON.parse(localStorage.getItem('myTracks') || '[]');
console.log(restored);

學生練習:增加「新增一段」、「復原上一段」、「清空場景」三種功能。

10|效能最佳化與跨裝置操作

複雜 3D 場景需要考慮模型面數、紋理、繪製呼叫與手機效能。重複物件可評估 InstancedMesh;也可限制像素比。

核心 API:InstancedMesh、LOD、Texture Baking

renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
// 重複的相同幾何物件可考慮 InstancedMesh
const trees = new THREE.InstancedMesh(treeGeometry, treeMaterial, 100);
const matrix = new THREE.Matrix4();
for (let i = 0; i < 100; i++) {
  matrix.makeTranslation((i % 10) * 2, 0, Math.floor(i / 10) * 2);
  trees.setMatrixAt(i, matrix);
}
trees.instanceMatrix.needsUpdate = true;
scene.add(trees);

學生練習:比較 100 個獨立 Mesh 與一個 InstancedMesh 的繪製效能;先建立 treeGeometry、treeMaterial。

四、實際操作觀察表

操作觀察問題
拖曳與縮放視角是攝影機移動,還是場景中的物件移動?
新增彎曲鐵軌每一段軌道如何決定位置、角度與接點?
啟動火車火車如何依路徑更新位置與方向?
切換日夜哪些光照、背景及材質效果發生變化?
分享作品如何用資料描述場景,讓另一台電腦重建?

五、建議的課程安排

第一堂課(2 小時):體驗網站、認識 Scene Graph、Group、Camera 與 3D 座標。第二堂課(2 小時):練習 Raycaster、曲線路徑與動畫。第三堂課(2 小時):日夜場景、JSON 儲存與效能最佳化。

六、課後思考

  1. 為什麼火車適合使用 Group,而不只是一個 Mesh?
  2. Raycaster 與一般 HTML 按鈕事件有何不同?
  3. 如何同時更新火車位置與車頭方向?
  4. 為什麼動畫速度需要考慮 delta time?
  5. 為什麼大量重複物件需要效能最佳化?

七、延伸閱讀

Choo-Choo World 官方網站|Three.js 官方基礎教學|Three.js API 文件|Choo-Choo World 技術介紹

結語:Three.js 的學習可以從一個旋轉立方體開始,但真正的互動世界需要把物件組合、視角、事件、路徑、動畫與資料結構連結起來。理解這十大技術,將有助於學生進一步自行設計 3D 互動網頁。

沒有留言:

張貼留言