WordPress 3D 配置器:3D 還沒壞,其他東西先壞了

一個團隊在 WordPress 頁面上放好第一個 3D 產品模型,看起來沒問題。半年後他們想在上面加選項,結果升級花的時間是建模的三倍。3D 從來不是難的那一段。一個WordPress 3D 配置器會壞在 WordPress 對頁面做的事上,而且在模型被要求渲染之前就已經壞了。

下面是那些事,按它們通常出現的順序排。

畫布沒有高度,直到有人給它一個

這是多數專案的第一個小時,而且看起來像模型壞了。

檢視器丟進頁面編輯器的容器裡,就會繼承容器的行為。很多編輯器把內容包在一個高度由子元素決定的 flex 或 grid 格子裡。畫布(canvas)是替換元素,內在尺寸 300×150 像素、沒有內容,在某些容器規則下就塌成零。模型載進來了。畫面上什麼都沒發生。

修法很無聊。外層容器在被掛載之前就要有明確的長寬比或固定高度,渲染器該從那個容器讀尺寸,而不是從視窗讀。把這件事做對,順便也解決了手機瀏覽器隱藏網址列、視窗高度在一百像素內變動所造成的抖動。

快取把 3D 模型當成圖片處理

任何有流量的 WordPress 站至少有一層快取,通常三層:頁面快取、資源優化、CDN。每一層對 `.glb` 檔都有自己的意見,而這些意見不一定一致。

頁面快取在這裡問題不大。資源優化才是重點。那些被當成效能賣點的功能,像是延後執行腳本、延遲載入媒體、產生關鍵 CSS,會把配置器的執行環境延到第一次互動之後,於是產品頁感覺像壞了,而不是感覺很快。延遲載入特別容易踩,因為畫布不是圖片,一般的延遲載入掛鉤套不上去。

CDN 是比較安靜的那個問題。模型檔很大、很少變動、應該被快取很久,但預設設定可能把它當成不可快取的二進位檔。症狀一旦知道就很好認:第一次切換選項時模型重新下載,第二次也一樣。

這些都不稀奇。這是把即時資產放進一個為文件而設計的技術堆疊時,必然會遇到的摩擦。

兩支外掛,搶同一個動畫影格

每個 WebGL 場景都用自己的渲染迴圈驅動。捲動動畫函式庫也是,輪播也是,視差首屏也是,一個典型商業站上大概一半的外掛都是。

它們不互相協調。兩個迴圈同時對一支中階 Android 手機呼叫 `requestAnimationFrame`,產生出來的影格預算兩邊都達不到,症狀看起來像模型很慢,實際上是主執行緒太擠。模型沒問題。是頁面在跟自己打架。

診斷要靠效能分析而不是看程式碼,修法通常是在配置器進入視窗時暫停其他動畫。這是範圍決策,所以它該寫在專案計畫裡,不是躺在問題清單上。

雙螢幕顯示網路請求瀑布圖與 3D 椅子模型 手機同步預覽

多語言外掛複製頁面,不複製狀態

跑 WPML 或 Polylang 的站會為每個語言複製頁面,對文字來說正確,對任何有狀態的東西都很麻煩。同一個產品頁的兩個語言版本,可能各自載入同一個模型的兩個實例,而在慢一點的連線上,第二個會在第一個還沒初始化完的時候到達。

相關的陷阱是已儲存的配置。一個在德文頁重開建置的連結,必須解析出跟英文頁一樣的選項識別碼,否則客人會落到一個圖對、選項錯的頁面。選項值如果用翻譯後的標籤儲存,而不是用穩定代碼,跨語言立刻斷。

選項資料該住在哪裡

第一個直覺是把選項清單放進頁面,塞在文章內容或短代碼參數裡。六個選項可以,六十個就無法維護。

一個長成配置器的 WordPress 3D 產品檢視器,需要把選項資料放在非開發人員也能改、又碰不到渲染器的地方:自訂內容類型、一組欄位,或一張自己的小表。渲染器讀那份資料。頁面嵌入渲染器。這是兩件不同的工作,把它們分開,才是讓專案第二年還養得起的關鍵。

價格是同一套論證,後果更嚴重。如果配置器自己存一份價目表,一季之內就會跟 WooCommerce 對不上。讓商店持有價格、配置器讀它並計算選項差額,才能保住單一真實來源;這個交接的欄位設計在 WooCommerce 的訂單資料裡寫過。

從檢視器到配置器,才是真正的專案

多數 WordPress 團隊帶著一個 WordPress 3D 產品檢視器進來,不是配置器,而兩者之間的差距不是功能差距。檢視器把一個模型展示好。配置器要握住一個產品的選項空間、拒絕做不出來的組合、再把結構化的結果交給下一個步驟。

那是另一種工作,而且跟平台無關。這讓平台問題看起來比實際上簡單:選項空間小又彼此獨立,嵌入就夠了;選項空間大而且互相牽制,平台從來就不是那個限制。

模型準備是團隊在 WordPress 上特別容易低估的另一塊,因為外掛生態鼓勵你把設計師輸出的東西直接上傳。壓縮與簡化那一道在為網站 3D 配置器準備 CAD 檔案裡有完整流程,跳過它,就是「筆電上測都正常、客人手機上很卡」最常見的原因。

說完工之前該驗什麼

關於上線檢查清單,明理的人會有不同版本,所以這裡只放我們自己做過的專案裡抓過最多問題的那幾項。

一支中階 Android、走手機網路、冷快取載入,計時到模型可以被拖動為止,這一項就能抓到大部分。切換一個選項、開著網路面板看,也一樣有效,因為一個每次選取都重新抓模型的配置器,會通過清單上其他所有測試。第二個語言版本也值得同樣看一遍,確認選項識別碼對得上。再把快取外掛關掉一次,看它到底藏了什麼。

這四項過關,剩下的都是細節。任何一項沒過,它會在客人身上再失敗一次,而且那時候更難查。

一個能在真實站上存活的 WordPress 嵌入 3D 模型做法,講的其實是這四件事,不是模型本身。某種程度上這是好消息:專案真正貴的部分是產品規則,而平台摩擦如果有先規劃,是一週的工作;如果是被發現的,就是一個月。

如果你正卡在一個 WordPress 3D 配置器的中間,模型出得來但選項出不來,描述一下你的環境,我們會告訴你最可能是這四項裡的哪一項。

FAQ

Q:WordPress 3D 配置器能跟頁面編輯器一起用嗎?

可以,但有一個條件。編輯器必須給畫布一個尺寸明確的容器,並讓渲染器以那個容器為尺寸來源。用內容撐高度的編輯器會把 canvas 壓成零,這種情況下優化多少模型都沒用。

Q:模型應該放在 WordPress 媒體庫嗎?

通常不建議。媒體庫對小素材很方便,對需要長快取與 CDN 的數十 MB 二進位檔就很彆扭。放在獨立的 bucket 或資料夾、設定明確的快取標頭,可以避開「每次切換選項就重新下載」的預設行為。

Q:需要把快取外掛關掉嗎?

關掉是錯的方向。要設定它:把執行環境排除在延後執行之外、把模型檔當成可快取資源、在配置器進入視窗時暫停較重的動畫。為了一個頁面把整站快取關掉,是多數站會後悔的交易。

Q:價格怎麼跟 WooCommerce 保持同步?

讀它,不要複製它。價格由商店持有,配置器讀取後加上所選選項的差額,完成的配置再以結構化資料回到購物車。兩份價目表存在兩個系統裡一定會分歧,而發現分歧的永遠是客人。