在企業內部系統中,若需要呼叫本機裝置(例如監控卡、讀卡機、指紋模組),早期常見做法是封裝成 ActiveX 控制項,再由網頁透過 JavaScript 操作。以下記錄完整的串接方式。
以 object 標籤宣告,classid 為該控制項註冊時取得的 GUID,並指定 id 供腳本取用:
<object classid="clsid:B094CE95-40EA-4798-99DC-4B8CE548121F"
height="100%" width="100%" id="UiMonitor">
</object>
若需要讓控制項在沒有安裝的情況下引導使用者下載,可加上 codebase 屬性指向 cab 檔位址;若只在受控的內部環境使用,则可省略。
ActiveX 的事件不能用標準的 addEventListener 掛上,而是透過 script 標籤的 for 與 event 屬性來指定:
<!-- 使用 ActiveX 事件 -->
<script type="text/javascript" language="jscript"
for="UiMonitor" event="CommMsg(videoID, uMsgCode, bsMsgBody)">
myfunction(videoID, uMsgCode, bsMsgBody);
</script>
這裡的 for 對應控制項的 id,event 則是控制項對外暴露的事件名稱與參數清單。參數清單必須與控制項的定義完全一致,否則取到的值會是 undefined。當事件觸發時,這段腳本會被執行,並把參數轉交給我們自己的處理函式。
<script language="javascript" type="text/javascript">
// ActiveX 事件的具體處理
function myfunction(videoID, uMsgCode, bsMsgBody) {
alert(videoID);
}
function test() {
// 先取得 ActiveX 物件
var UiMonitor = document.getElementById("UiMonitor");
// 取得或設定 ActiveX 屬性
UiMonitor.RunMode = "1";
// 呼叫 ActiveX 方法
var videoID = UiMonitor.AddMonitor(deviceid, playAddr, 0);
}
</script>
取到物件之後,操作方式與一般 JS 物件無異:屬性直接指派、方法直接呼叫、回傳值直接接收。這正是 ActiveX 的直觀之處——它對腳本而言就是一個普通 COM 物件。
今天若要從瀏覽器存取本機裝置,應優先考慮:以 WebSocket 或本地 HTTP 服務(localhost service)與本機常駐程式溝通;使用 WebUSB、WebSerial、WebHID 等標準 API;或改寫成瀏覽器擴充功能。若必須保留既有 ActiveX 資產,比較務實的過渡做法是包一層本機服務,讓舊控制項留在服務端,前端改用標準非同步請求呼叫。這樣既延長既有投資的壽命,也讓前端逐步脫離 IE 的束縛。