萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Cult3D 與網頁腳本交互開發指南:事件、方法與跨瀏覽器相容實作

前言

Cult3D 是早期 Web 3D 互動技術,透過瀏覽器外掛 (Netscape) 或 ActiveX (IE) 嵌入網頁。雖已被 WebGL 取代,但維護舊系統時仍需理解其腳本交互機制。本文整理 Cult3D 事件模型、JavaScript/VBScript 呼叫方式與跨瀏覽器相容策略。

一、架構差異:Netscape Plugin vs IE ActiveX

特性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 封裝跨瀏覽器差異。

二、核心事件模型

四大事件類型:

  1. OnSceneLoaded:場景開始載入 (材質/游標可能未就緒)
  2. OnLoadFinished:檔案下載、解壓、場景完全就緒
  3. OnLoadAborted:下載失敗、檔案不存在、格式錯誤
  4. OnSendMessage:Cult3D Designer 設定的「Send Message to Host」動作觸發,或 Java 程式呼叫,訊息透過 getLastMessage() 取得

事件綁定範例 (跨瀏覽器統一 JS 寫法)

<!-- 通用 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>

三、JavaScript 方法控制 Cult3D 物件

透過物件參考呼叫方法 (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);
    }
}

四、Cult3D Designer 端設定 (關鍵)

  • 在 Cult3D Designer 中為物件/動畫添加 「Send Message to Host」 動作,指定訊息字串 (如 user_clicked_button_A)
  • 網頁端 onSendMessage 接收後解析訊息,執行對應邏輯 (如播放特定動畫、彈出網頁提示、提交表單)
  • 場景檔 (.co) 必須包含此類互動定義,網頁腳本才能響應

五、現代化遷移建議

Cult3D 技術已停止更新 (ActiveX 在 Edge/Chrome 不支援,NPAPI Plugin 在 Firefox 52+ 移除)。現有專案遷移路徑:

  1. Three.js / Babylon.js + WebGL:標準化、無外掛、跨平台、效能強
  2. 資產轉換:.co → glTF/GLB (需重新匯出或轉換工具)
  3. 互動邏輯重寫:Designer 動作 → JavaScript 事件監聽器
  4. 漸進式遷移:新功能用 WebGL,舊場景用 iframe 隔離載入舊頁面 (臨時方案)

結語

Cult3D 以 ActiveX/Plugin 架構實現 3D 網頁互動,其事件驅動模型 (OnLoadFinished, OnSendMessage) 與雙向方法呼叫 (sendMessage/getLastMessage) 為當時 Web 3D 互動奠定基礎。理解此架構有助於維護舊系統及規劃現代化遷移。

copyright © 萬盛學電腦網 all rights reserved