均民所開發的 JS SDK 可以在瀏覽器及 Node.js 的環境中執行,均民平常自己在開發的時候,都是直接在瀏覽器進行測試。均民有準備一個專門用來測試的網頁,只要用電腦打開這個測試網頁,就可以很簡單地在瀏覽器內建的開發者工具中快速測試 JS SDK。
由於測試環境是瀏覽器內建的開發者工具,所以請先用電腦的 Google Chrome 或 Microsoft Edge 瀏覽器開啟以下測試網頁:
https://taichunmin.idv.tw/chameleon-ultra.js/test.html
然後按下 F12 開啟開發者工具,接著切換到 Console 頁籤,你應該會看到以下畫面:
在 Console 內輸入以下程式碼來選擇要顯示的除錯訊息,輸入完成後需要重新整理網頁 (Ctrl/Cmd + R):
// 設定除錯訊息的顯示級別為 ultra:*,以便顯示所有 ultra 相關的除錯訊息
localStorage.debug='ultra:*'
然後修改開發者工具的 log level,把 verbose 打勾:
最後把你的變色龍用 USB 連到電腦,連線方式請選擇 USB,這樣就準備完成囉!
在開發程式的時候,有時會需要取得韌體的版本顯示給使用者看,請在開發者工具 Console 貼上以下的程式碼來取得裝置的韌體版本:
// 在測試網頁的開發者工具中執行 https://taichunmin.idv.tw/chameleon-ultra.js/test.html
await (async ultra => {
// 取得並顯示裝置的 Git 版本
console.log(await ultra.cmdGetGitVersion()) // 'v2.0.0-203-g8a797b8'
})(vm.ultra) // vm.ultra 是測試網頁提供的全域變數,會根據所選擇的連線方式來切換不同的 ultra 物件實例 (instance)
如果你還沒有跟變色龍裝置連線過,就會跳出一個畫面讓你選擇裝置:
如果連線成功的話,你應該就能取得裝置的韌體版本了: