Community程式設計與開發github.com

3D 英雄區域互動效果

讓英雄區域的 3D 模型對使用者做出反應:指標追蹤視差、懸停發光與游標狀態、點擊反應(衝量、粒子爆發、型態改變)、拖曳旋轉、磁性按鈕與游標響應背景。

3D 英雄區域互動效果 是什麼?

此技能專注於為網站英雄區域中的 3D 模型注入生命力,使其不再只是靜態或單純旋轉的螢幕保護程式。它建立一個層次分明的互動系統:優先回應游標懸停,其次是用戶點擊,最後才是閒置時的環境運動。核心機制包括使用阻尼追蹤單一標準化 NDC 向量來驅動所有視差、傾斜效果;透過精簡的射線投射(僅針對互動網格)來實現高效的懸停狀態切換與游標變化;並根據點擊意圖觸發腳本化的反應,如物理衝量、彈簧反彈、粒子爆發或模型變形。此外,它還涵蓋了拖曳旋轉、磁性 DOM 按鈕,以及有意義的自訂游標功能。此技能特別適合與 threejs-interaction、3d-physics-simulations 等技能搭配使用,以打造深度互動的 3D 體驗。

相容平台~Claude Code~Codex CLI✓Cursor
Part ofReact
npx skills add https://github.com/BLACKNIGHT-cloud12/3d-hero-interactions/tree/HEAD

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

3D 英雄區域互動效果 是做什麼的?

只會旋轉的英雄模型就像一個螢幕保護程式。「感覺有生命力」的層次為:回應游標(懸停)> 回應輸入(點擊)> 回應閒置(環境運動)。請按照此順序建構。

指標追蹤:一個標準化向量,全域阻尼

只追蹤一次指標;每個反應都透過一個阻尼跟隨器讀取相同的 NDC 向量。切勿讓元件添加自己的監聽器。

const pointer = new THREE.Vector2(0, 0);     // 原始值, -1..1
const smooth = new THREE.Vector2(0, 0);      // 阻尼值
addEventListener('pointermove', e => {
  pointer.set((e.clientX / innerWidth) * 2 - 1, -(e.clientY / innerHeight) * 2 + 1);
});
function tick(dt) {
  smooth.lerp(pointer, 1 - Math.pow(0.001, dt)); // 幀率無關的阻尼
}
  • 視差效果:圍繞一個注視點,將攝影機(或場景群組)偏移 smooth * 0.3 — 產生深度錯覺,3 行程式碼。
  • 傾斜效果:將英雄網格向游標方向旋轉,角度上限較小(±0.15 弧度) — 給人一種「正在注視你」的感覺。
  • 阻尼常數約為 0.001–0.01:值越小,感覺越沉重、越優質。原始追蹤會顯得廉價。

懸停效果:對精簡清單進行射線投射,設定游標狀態

僅對英雄的互動網格進行射線投射(傳入明確的陣列),絕不對整個場景進行 — 每次指標移動都對一個 20 萬三角形的場景進行射線投射,正是英雄區域掉幀的原因。

raycaster.setFromCamera(pointer, camera);
const hit = raycaster.intersectObjects(interactives, false)[0];
canvas.style.cursor = hit ? 'pointer' : 'default';
// 進入/離開時:過渡 emissiveIntensity 或 scale(1 → 1.04),詳見 threejs-interaction

對 pointerenter/leave 轉換使用補間動畫(在約 150ms 內進行 lerp),而非即時切換。在觸控裝置上沒有懸停狀態 — 將點擊視為點擊操作,完全跳過懸停狀態。

點擊反應(最有趣的部分)

根據意圖選擇 — 點擊 ⇒ 該物件的腳本化回應:

  1. 衝量(有物理本體):applyImpulse — 參見 3d-physics-simulations。
  2. 彈簧反彈(無引擎):位移 + 彈簧回歸靜止姿態(v += k*(rest - x); v *= damp)。最穩健的英雄模式。
  3. 粒子爆發:從擊中點發射 N 個粒子,帶有徑向速度、重力與淡出效果,使用一個 InstancedMesh/Points 池(回收,絕不重新分配)。範本:3d-physics-simulations → references/gpgpu-particles.md。
  4. 型態改變/組裝:推進混合值或重新執行動畫(GSAP 作用於 uniform 或型態目標)。

點擊後回饋時間需 ≤16ms,否則會感覺斷開連接:在 pointerdown 時就開始回應,而不是等到 click 解析完成後。

拖曳旋轉

透過移動閾值(5px)和按壓持續時間來區分拖曳與點擊。使用阻尼速度旋轉網格的父層群組;釋放時套用慣性,然後平緩回歸閒置旋轉。禁用英雄上的 OrbitControls 式自由攝影機 — 構圖必須保持不變。

磁性 DOM 元素

游標約 80px 範圍內的按鈕會向其平移(上限 6–8px),離開時會彈回 — 與 3D 視差效果配合,將平面元素統一起來。使用相同的阻尼跟隨器,套用於 transform: translate()。

自訂游標

僅在自訂游標能增加意義時才使用(例如,在英雄上變成「抓取」提示):一個小點加上一個追蹤環,使用 mix-blend-mode: difference,在觸控裝置上隱藏。保持原生游標可見,直到情境證明需要自訂游標 — 一個與網站本身游標衝突的自訂游標比沒有更糟。

常見錯誤

  • 每次指標移動都對整個場景進行射線投射 — 應使用網格精簡清單,或限制為每幀一次。
  • 每次熱重載/路由變更都添加監聽器 — 應在註冊監聽器的同一個地方進行清理。
  • Canvas 疊加層搶佔原本應由 DOM 處理的點擊:除非 Canvas 本身就是互動表面,否則應設定 pointer-events: none;DOM 應透過自己的 z-index 浮於其上。
  • 在僅支援 pointerdown 的裝置上,懸停效果會閃爍 — 將懸停程式碼限制在 matchMedia('(hover: hover)') 條件內。
  • 視差效果疊加在 scroll-driven-3d-story 的滾動驅動攝影機上,卻沒有單一擁有者 — 應在一個地方(攝影機 rig 群組)添加偏移量,否則效果會彼此衝突。

相關技能

  • threejs-interaction — 射線投射器/控制器基礎
  • 3d-physics-simulations — 衝量與爆發
  • scroll-driven-3d-story — 此效果所整合的攝影機編排
  • ai-website-aesthetics — 英雄區域應有的外觀

相關技能