Cult3D 是早期 Web 3D 互動技術,透過瀏覽器外掛 (Netscape) 或 ActiveX (IE) 嵌入網頁。雖已被 WebGL 取代,但維護舊系統時仍需理解其腳本交互機制。本文整理 Cult3D 事件模型、JavaScript/VBScript 呼叫方式與跨瀏覽器相容策略。
| 特性 | Netscape / Firefox (Plugin) | Internet Explorer (ActiveX) |
|---|---|---|
| 嵌入標籤 | <EMBED> | <OBJECT> |
| 腳本語言 | JavaScript (JS) | VBScript (VBS) / JavaScript |
| 事件綁定 | 屬性內嵌 ONSCENELOADED="..." | <SCRIPT FOR=obj EVENT=evt> 或 JS 事件屬性 |
| 方法呼叫 | document.embeds["name"].method() | document.getElementById("id").method() |
統一策略:全面使用 **JavaScript**,僅在 IE 專用環境考慮 VBScript。Cult3D 官方提供 Cult3D.js 封裝跨瀏覽器差異。
四大事件類型:
getLastMessage() 取得<!-- 通用 JavaScript 事件處理函數 -->
<script language="javascript">
function onSceneLoaded() { console.log('場景開始載入'); }
function onLoadFinished() { console.log('場景完全就緒'); initApp(); }
function onLoadAborted() { alert('3D 內容載入失敗'); }
function onSendMessage() {
var msg = cult3dObject.getLastMessage();
handleCustomMessage(msg);
}
</script>
<!-- IE ActiveX 綁定 -->
<object id="cult3dObject" classid="clsid:31B7EB4E-8B4B-11D1-A789-00A0CC6651A8" width="400" height="300">
<param name="SRC" value="scene.co">
<!-- IE 專用事件綁定 (VBScript 或 JS for=event) -->
<script language="javascript" for="cult3dObject" event="OnSceneLoaded">onSceneLoaded();</script>
<script language="javascript" for="cult3dObject" event="OnLoadFinished">onLoadFinished();</script>
<script language="javascript" for="cult3dObject" event="OnLoadAborted">onLoadAborted();</script>
<script language="javascript" for="cult3dObject" event="OnSendMessage">onSendMessage();</script>
</object>
<!-- Netscape/Firefox Plugin 綁定 -->
<embed name="cult3dEmbed"
pluginspage="https://www.cult3d.com/newuser/index.html"
src="scene.co" width="400" height="300"
onsceneloaded="onSceneLoaded()"
onloadfinished="onLoadFinished()"
onloadaborted="onLoadAborted()"
onsendmessage="onSendMessage()">
</embed>
透過物件參考呼叫方法 (IE: document.getElementById('cult3dObject'), NS: document.embeds['cult3dEmbed']):
play() / stop() / rewind():動畫播放控制setView(viewName):切換預定義視角setRenderMode(mode):渲染模式 (wireframe, solid, textured...)setBackgroundColor(r, g, b):背景顏色sendMessage(msg):從網頁向 Cult3D 發送訊息 (觸發內部動作)getLastMessage():取得最近一次 OnSendMessage 事件的訊息triggerEvent(eventName):觸發 Cult3D 內部自訂事件function getCult3DObject() {
if (navigator.appName.indexOf("Microsoft") != -1) {
return document.getElementById("cult3dObject"); // IE ActiveX
} else {
return document.embeds["cult3dEmbed"]; // Netscape Plugin
}
}
// 使用範例
function changeColor(r, g, b) {
var obj = getCult3DObject();
if (obj && obj.setBackgroundColor) {
obj.setBackgroundColor(r, g, b);
}
}
user_clicked_button_A)onSendMessage 接收後解析訊息,執行對應邏輯 (如播放特定動畫、彈出網頁提示、提交表單).co) 必須包含此類互動定義,網頁腳本才能響應Cult3D 技術已停止更新 (ActiveX 在 Edge/Chrome 不支援,NPAPI Plugin 在 Firefox 52+ 移除)。現有專案遷移路徑:
.co → glTF/GLB (需重新匯出或轉換工具)iframe 隔離載入舊頁面 (臨時方案)Cult3D 以 ActiveX/Plugin 架構實現 3D 網頁互動,其事件驅動模型 (OnLoadFinished, OnSendMessage) 與雙向方法呼叫 (sendMessage/getLastMessage) 為當時 Web 3D 互動奠定基礎。理解此架構有助於維護舊系統及規劃現代化遷移。