將 USB 應用程式轉移到網路。第 1 部分:libusb

瞭解如何使用 WebAssembly 和 Fugu API,將與外部裝置互動的程式碼移植到網頁。

Ingvar Stepanyan
Ingvar Stepanyan

在先前的文章中,我說明瞭如何使用 File System Access API、WebAssembly 和 Asyncify,將使用檔案系統 API 的應用程式移植到網頁。現在,我想繼續探討相同的主題,也就是將 Fugu API 與 WebAssembly 整合,並將應用程式移植到網頁,同時保留重要功能。

我會示範如何將與 USB 裝置通訊的應用程式移植到網頁,方法是將 libusb (以 C 語言編寫的熱門 USB 程式庫) 移植到 WebAssembly (透過 Emscripten)、Asyncify 和 WebUSB。

首要之務:示範

移植程式庫時,最重要的就是選擇合適的示範,也就是能展示移植程式庫的功能、可透過多種方式測試,同時具有視覺吸引力的示範。

我選擇的構想是數位單眼相機遙控器。特別是開放原始碼專案 gPhoto2,在這個領域已有足夠的時間進行反向工程,並實作對各種數位相機的支援。它支援多種通訊協定,但我最感興趣的是 USB 支援,這是透過 libusb 執行的。

我會分兩部分說明建構這個示範的步驟。在這篇網誌文章中,我將說明如何移植 libusb 本身,以及將其他熱門程式庫移植到 Fugu API 時可能需要哪些技巧。在第二篇文章中,我將詳細說明如何移植及整合 gPhoto2。

最後,我成功建立了一個網頁應用程式,可以預覽單眼相機的即時影像,並透過 USB 控制相機設定。在閱讀技術詳細資料前,歡迎先觀看直播或預錄的示範影片:

示範在連接 Sony 相機的筆電上執行。

相機專屬怪異行為注意事項

您可能已注意到,影片中變更設定需要一些時間。與您可能遇到的其他大多數問題一樣,這並非 WebAssembly 或 WebUSB 的效能所致,而是 gPhoto2 與示範所選特定相機的互動方式所致。

Sony a6600 不會公開 API 來直接設定 ISO、光圈或快門速度等值,而只提供指令,依指定步數增加或減少這些值。更複雜的是,它也不會傳回實際支援的值清單,傳回的清單似乎是許多 Sony 相機型號的硬式編碼。

設定其中一個值時,gPhoto2 只能採取下列做法:

  1. 朝所選價值的方向邁出一步 (或幾步)。
  2. 請稍候片刻,讓攝影機更新設定。
  3. 讀出攝影機實際停在的值。
  4. 確認最後一個步驟未跳過所需的值,也沒有繞過清單的結尾或開頭。
  5. 重複

這可能需要一些時間,但如果相機實際支援該值,就會達到該值;如果相機不支援,則會停在最接近的支援值。

其他相機可能會有不同的設定、基礎 API 和特性。請注意,gPhoto2 是開放原始碼專案,因此無論是自動或手動測試,都無法涵蓋所有相機型號。我們隨時歡迎您提供詳細的問題報告和 PR (但請務必先使用官方 gPhoto2 用戶端重現問題)。

跨平台相容性的重要注意事項

很遺憾,在 Windows 上,任何「知名」裝置 (包括數位單眼相機) 都會獲派系統驅動程式,而這與 WebUSB 不相容。如要在 Windows 上試用示範,請使用 Zadig 等工具,將已連結 DSLR 的驅動程式覆寫為 WinUSB 或 libusb。這個方法對我和許多其他使用者都很有效,但您必須自行承擔使用風險。

在 Linux 上,你可能需要設定自訂權限,才能透過 WebUSB 存取單眼相機,但這取決於你的發行版本。

在 macOS 和 Android 上,示範應用程式應可直接運作。如果是在 Android 手機上操作,請務必切換為橫向模式,因為我沒有花太多心力讓它支援回應式設計 (歡迎提出 PR!):

Android 手機透過 USB-C 傳輸線連接至 Canon 相機。
同一個示範在 Android 手機上執行的情形。圖片由 Surma 提供。

如需 WebUSB 跨平台使用的深入指南,請參閱「建構 WebUSB 裝置」的「平台專屬考量事項」一節。

在 libusb 中新增後端

接下來,我們將說明技術細節。雖然可以提供類似 libusb 的 shim API (先前已有其他人這樣做),並將其他應用程式連結至該 API,但這種做法容易出錯,且會增加進一步擴充或維護的難度。我想以正確的方式做事,這樣一來,未來就有可能回饋上游,並合併到 libusb 中。

幸好,libusb README 說明:

「libusb 內部經過抽象化,因此可以移植到其他作業系統。詳情請參閱 PORTING 檔案。」

libusb 的結構是將公用 API 與「後端」分開。這些後端負責列出、開啟、關閉裝置,並透過作業系統的低階 API 與裝置進行實際通訊。這就是 libusb 抽象化 Linux、macOS、Windows、Android、OpenBSD/NetBSD、Haiku 和 Solaris 之間的差異,並在所有這些平台上運作的方式。

我必須為 Emscripten+WebUSB「作業系統」新增另一個後端。這些後端的實作項目位於 libusb/os 資料夾中:

~/w/d/libusb $ ls libusb/os
darwin_usb.c           haiku_usb_raw.h  threads_posix.lo
darwin_usb.h           linux_netlink.c  threads_posix.o
events_posix.c         linux_udev.c     threads_windows.c
events_posix.h         linux_usbfs.c    threads_windows.h
events_posix.lo        linux_usbfs.h    windows_common.c
events_posix.o         netbsd_usb.c     windows_common.h
events_windows.c       null_usb.c       windows_usbdk.c
events_windows.h       openbsd_usb.c    windows_usbdk.h
haiku_pollfs.cpp       sunos_usb.c      windows_winusb.c
haiku_usb_backend.cpp  sunos_usb.h      windows_winusb.h
haiku_usb.h            threads_posix.c
haiku_usb_raw.cpp      threads_posix.h

每個後端都包含 libusbi.h 標頭,其中包含常見類型和輔助程式,且需要公開 usbi_os_backend 類型的 usbi_backend 變數。舉例來說,Windows 後端看起來會像這樣:

const struct usbi_os_backend usbi_backend = {
  "Windows",
  USBI_CAP_HAS_HID_ACCESS,
  windows_init,
  windows_exit,
  windows_set_option,
  windows_get_device_list,
  NULL,   /* hotplug_poll */
  NULL,   /* wrap_sys_device */
  windows_open,
  windows_close,
  windows_get_active_config_descriptor,
  windows_get_config_descriptor,
  windows_get_config_descriptor_by_value,
  windows_get_configuration,
  windows_set_configuration,
  windows_claim_interface,
  windows_release_interface,
  windows_set_interface_altsetting,
  windows_clear_halt,
  windows_reset_device,
  NULL,   /* alloc_streams */
  NULL,   /* free_streams */
  NULL,   /* dev_mem_alloc */
  NULL,   /* dev_mem_free */
  NULL,   /* kernel_driver_active */
  NULL,   /* detach_kernel_driver */
  NULL,   /* attach_kernel_driver */
  windows_destroy_device,
  windows_submit_transfer,
  windows_cancel_transfer,
  NULL,   /* clear_transfer_priv */
  NULL,   /* handle_events */
  windows_handle_transfer_completion,
  sizeof(struct windows_context_priv),
  sizeof(union windows_device_priv),
  sizeof(struct windows_device_handle_priv),
  sizeof(struct windows_transfer_priv),
};

查看屬性後,我們可以看到 struct 包含後端名稱、一組功能、以函式指標形式處理各種低階 USB 作業的處理常式,以及用於儲存私人裝置/內容/傳輸層級資料的大小。

私有資料欄位至少可用於儲存所有這些項目的 OS 控制代碼,因為如果沒有控制代碼,我們就無法得知任何指定作業適用於哪個項目。在網頁實作中,OS 控制代碼會是基礎 WebUSB JavaScript 物件。在 Emscripten 中,表示及儲存這些資料的自然方式是透過 emscripten::val 類別,該類別是 Embind (Emscripten 的繫結系統) 的一部分。

資料夾中的大部分後端都是以 C 實作,但有少數是以 C++ 實作。Embind 僅適用於 C++,因此我選擇了 C++,並新增了具有必要結構的 libusb/libusb/os/emscripten_webusb.cpp,以及用於私有資料欄位的 sizeof(val):

#include <emscripten.h>
#include <emscripten/val.h>

#include "libusbi.h"

using namespace emscripten;

// …function implementations

const usbi_os_backend usbi_backend = {
  .name = "Emscripten + WebUSB backend",
  .caps = LIBUSB_CAP_HAS_CAPABILITY,
  // …handlers—function pointers to implementations above
  .device_priv_size = sizeof(val),
  .transfer_priv_size = sizeof(val),
};

將 WebUSB 物件儲存為裝置控制代碼

libusb 會提供現成指標,指向分配給私人資料的區域。為了將這些指標當做 val 例項使用,我新增了小型輔助函式,可在原地建構指標、擷取指標做為參照,以及移出值:

// We store an Embind handle to WebUSB USBDevice in "priv" metadata of
// libusb device, this helper returns a pointer to it.
struct ValPtr {
 public:
  void init_to(val &&value) { new (ptr) val(std::move(value)); }

  val &get() { return *ptr; }
  val take() { return std::move(get()); }

 protected:
  ValPtr(val *ptr) : ptr(ptr) {}

 private:
  val *ptr;
};

struct WebUsbDevicePtr : ValPtr {
 public:
  WebUsbDevicePtr(libusb_device *dev)
      : ValPtr(static_cast<val *>(usbi_get_device_priv(dev))) {}
};

val &get_web_usb_device(libusb_device *dev) {
  return WebUsbDevicePtr(dev).get();
}

struct WebUsbTransferPtr : ValPtr {
 public:
  WebUsbTransferPtr(usbi_transfer *itransfer)
      : ValPtr(static_cast<val *>(usbi_get_transfer_priv(itransfer))) {}
};

同步 C 內容中的非同步 Web API

現在需要一種方法來處理非同步 WebUSB API,其中 libusb 預期同步作業。為此,我可以使用 Asyncify,更具體地說,是透過 val::await() 整合 Embind。

我也想正確處理 WebUSB 錯誤,並將其轉換為 libusb 錯誤代碼,但 Embind 目前無法處理 JavaScript 例外狀況或 C++ 端的 Promise 拒絕。如要解決這個問題,可以在 JavaScript 端擷取拒絕,並將結果轉換為 { error, value } 物件,現在可以從 C++ 端安全剖析。我結合 EM_JS 巨集和 Emval.to{Handle, Value} API 來完成這項操作:

EM_JS(EM_VAL, em_promise_catch_impl, (EM_VAL handle), {
  let promise = Emval.toValue(handle);
  promise = promise.then(
    value => ({error : 0, value}),
    error => {
      const ERROR_CODES = {
        // LIBUSB_ERROR_IO
        NetworkError : -1,
        // LIBUSB_ERROR_INVALID_PARAM
        DataError : -2,
        TypeMismatchError : -2,
        IndexSizeError : -2,
        // LIBUSB_ERROR_ACCESS
        SecurityError : -3,
        …
      };
      console.error(error);
      let errorCode = -99; // LIBUSB_ERROR_OTHER
      if (error instanceof DOMException)
      {
        errorCode = ERROR_CODES[error.name] ?? errorCode;
      }
      else if (error instanceof RangeError || error instanceof TypeError)
      {
        errorCode = -2; // LIBUSB_ERROR_INVALID_PARAM
      }
      return {error: errorCode, value: undefined};
    }
  );
  return Emval.toHandle(promise);
});

val em_promise_catch(val &&promise) {
  EM_VAL handle = promise.as_handle();
  handle = em_promise_catch_impl(handle);
  return val::take_ownership(handle);
}

// C++ struct representation for {value, error} object from above
// (performs conversion in the constructor).
struct promise_result {
  libusb_error error;
  val value;

  promise_result(val &&result)
      : error(static_cast<libusb_error>(result["error"].as<int>())),
        value(result["value"]) {}

  // C++ counterpart of the promise helper above that takes a promise, catches
  // its error, converts to a libusb status and returns the whole thing as
  // `promise_result` struct for easier handling.
  static promise_result await(val &&promise) {
    promise = em_promise_catch(std::move(promise));
    return {promise.await()};
  }
};

現在,我可以在 WebUSB 作業傳回的任何 Promise 上使用 promise_result::await(),並分別檢查其 error 和 value 欄位。

舉例來說,從 libusb_device_handle 擷取代表 USBDevice 的 val、呼叫其 open() 方法、等待結果,並傳回錯誤代碼做為 libusb 狀態碼,如下所示:

int em_open(libusb_device_handle *handle) {
  auto web_usb_device = get_web_usb_device(handle->dev);
  return promise_result::await(web_usb_device.call<val>("open")).error;
}

裝置列舉

當然,在開啟任何裝置之前,libusb 需要擷取可用裝置的清單。後端必須透過 get_device_list 處理常式實作這項作業。

困難之處在於,基於安全考量,我們無法像其他平台一樣,列舉網路上所有已連結的 USB 裝置。而是分成兩個部分。首先,網頁應用程式會透過 navigator.usb.requestDevice() 要求具有特定屬性的裝置,使用者則手動選擇要公開的裝置,或拒絕權限提示。接著,應用程式會透過 navigator.usb.getDevices() 列出已核准且連結的裝置。

一開始,我嘗試在 get_device_list 處理常式的實作中直接使用 requestDevice()。不過,顯示含有已連結裝置清單的權限提示,會視為機密作業,且必須由使用者互動觸發 (例如點選頁面上的按鈕),否則一律會傳回遭拒的承諾。libusb 應用程式通常會在應用程式啟動時列出已連結的裝置,因此無法使用 requestDevice()。

相反地,我必須將 navigator.usb.requestDevice() 的叫用留給最終開發人員,並僅公開 navigator.usb.getDevices() 中已核准的裝置:

// Store the global `navigator.usb` once upon initialisation.
thread_local const val web_usb = val::global("navigator")["usb"];

int em_get_device_list(libusb_context *ctx, discovered_devs **devs) {
  // C++ equivalent of `await navigator.usb.getDevices()`.
  // Note: at this point we must already have some devices exposed -
  // caller must have called `await navigator.usb.requestDevice(...)`
  // in response to user interaction before going to LibUSB.
  // Otherwise this list will be empty.
  auto result = promise_result::await(web_usb.call<val>("getDevices"));
  if (result.error) {
    return result.error;
  }
  auto &web_usb_devices = result.value;
  // Iterate over the exposed devices.
  uint8_t devices_num = web_usb_devices["length"].as<uint8_t>();
  for (uint8_t i = 0; i < devices_num; i++) {
    auto web_usb_device = web_usb_devices[i];
    // …
    *devs = discovered_devs_append(*devs, dev);
  }
  return LIBUSB_SUCCESS;
}

大部分後端程式碼都使用 val 和 promise_result,方式與上述類似。資料移轉處理程式碼中還有一些有趣的駭客手法,但這些實作細節對本文的目的來說並不重要。如有興趣,請務必查看 GitHub 上的程式碼和註解。

將事件迴圈移植到網頁

我想討論的另一個 libusb 移植部分是事件處理。如前一篇文章所述,C 等系統語言中的大多數 API 都是同步的,事件處理也不例外。通常會透過無限迴圈實作,從一組外部 I/O 來源「輪詢」(嘗試讀取資料或封鎖執行,直到有可用資料為止),並在至少有一個來源回應時,將該來源做為事件傳遞至對應的處理常式。處理常式完成後,控制權會回到迴圈,並暫停等待下一次輪詢。

這種做法在網路上會產生幾個問題。

首先,WebUSB 不會也無法公開基礎裝置的原始控制代碼,因此無法直接輪詢這些控制代碼。其次,libusb 會使用 eventfd 和 pipe API 處理其他事件,以及在沒有原始裝置控制代碼的作業系統上處理傳輸,但 Emscripten 目前不支援 eventfd,而 pipe 雖然支援,但目前不符合規格,且無法等待事件。

最後,最大的問題是網頁有自己的事件迴圈。這個全域事件迴圈用於任何外部 I/O 作業 (包括 fetch()、計時器,或在本例中為 WebUSB),並在對應作業完成時叫用事件或 Promise 處理常式。執行另一個巢狀無限事件迴圈,會阻礙瀏覽器的事件迴圈繼續進行,這表示 UI 不僅會停止回應,程式碼也永遠不會收到正在等待的 I/O 事件通知。這通常會導致死結,我在試用 libusb 的示範時也發生了這種情況。網頁凍結。

與其他封鎖 I/O 一樣,如要將這類事件迴圈移植到網頁,開發人員必須找到在不封鎖主執行緒的情況下執行這些迴圈的方法。一種方法是重構應用程式,在獨立執行緒中處理 I/O 事件,並將結果傳回主要執行緒。另一種方法是使用 Asyncify 暫停迴圈,並以非阻塞方式等待事件。

我不想對 libusb 或 gPhoto2 進行重大變更,而且我已經使用 Asyncify 整合 Promise,因此我選擇了這條路徑。為了模擬 poll() 的封鎖變體,在初始概念驗證中,我使用了迴圈,如下所示:

#ifdef __EMSCRIPTEN__
  // TODO: optimize this. Right now it will keep unwinding-rewinding the stack
  // on each short sleep until an event comes or the timeout expires.
  // We should probably create an actual separate thread that does signaling
  // or come up with a custom event mechanism to report events from
  // `usbi_signal_event` and process them here.
  double until_time = emscripten_get_now() + timeout_ms;
  do {
    // Emscripten `poll` ignores timeout param, but pass 0 explicitly just
    // in case.
    num_ready = poll(fds, nfds, 0);
    if (num_ready != 0) break;
    // Yield to the browser event loop to handle events.
    emscripten_sleep(0);
  } while (emscripten_get_now() < until_time);
#else
  num_ready = poll(fds, nfds, timeout_ms);
#endif

這項功能的作用如下:

  1. 呼叫 poll(),檢查後端是否已回報任何事件。如果有的話,迴圈就會停止。否則,Emscripten 的 poll() 實作會立即傳回 0。
  2. 來電emscripten_sleep(0)。這個函式在幕後使用 Asyncify 和 setTimeout(),用於將控制權交回給主要瀏覽器事件迴圈。這樣一來,瀏覽器就能處理任何使用者互動和 I/O 事件,包括 WebUSB。
  3. 檢查指定的逾時時間是否已過,如果沒有,則繼續迴圈。

如註解所述,這種做法並非最佳做法,因為即使沒有要處理的 USB 事件 (大部分時間),系統仍會持續使用 Asyncify 儲存還原整個呼叫堆疊,而且 setTimeout() 本身在新式瀏覽器中的最短持續時間為 4 毫秒。不過,在概念驗證中,這項功能仍能順利從數位單眼相機產生 13 到 14 FPS 的直播。

後來,我決定利用瀏覽器事件系統來改善這個問題。這項實作方式還有幾種進一步改善的方法,但目前我選擇直接在全域物件上發出自訂事件,而不將其與特定 libusb 資料結構建立關聯。我已根據 EM_ASYNC_JS 巨集,透過下列等待和通知機制完成這項操作:

EM_JS(void, em_libusb_notify, (void), {
  dispatchEvent(new Event("em-libusb"));
});

EM_ASYNC_JS(int, em_libusb_wait, (int timeout), {
  let onEvent, timeoutId;

  try {
    return await new Promise(resolve => {
      onEvent = () => resolve(0);
      addEventListener('em-libusb', onEvent);

      timeoutId = setTimeout(resolve, timeout, -1);
    });
  } finally {
    removeEventListener('em-libusb', onEvent);
    clearTimeout(timeoutId);
  }
});

每當 libusb 嘗試回報事件 (例如資料移轉完成) 時,就會使用 em_libusb_notify() 函式:

void usbi_signal_event(usbi_event_t *event)
{
  uint64_t dummy = 1;
  ssize_t r;

  r = write(EVENT_WRITE_FD(event), &dummy, sizeof(dummy));
  if (r != sizeof(dummy))
    usbi_warn(NULL, "event write failed");
#ifdef __EMSCRIPTEN__
  em_libusb_notify();
#endif
}

同時,em_libusb_wait() 部分用於在收到 em-libusb 事件或逾時到期時,從 Asyncify 睡眠中「喚醒」:

double until_time = emscripten_get_now() + timeout_ms;
for (;;) {
  // Emscripten `poll` ignores timeout param, but pass 0 explicitly just
  // in case.
  num_ready = poll(fds, nfds, 0);
  if (num_ready != 0) break;
  int timeout = until_time - emscripten_get_now();
  if (timeout <= 0) break;
  int result = em_libusb_wait(timeout);
  if (result != 0) break;
}

由於睡眠和喚醒次數大幅減少,這項機制修正了先前以 emscripten_sleep() 為基礎的實作效率問題,並將 DSLR 示範處理量從 13-14 FPS 提高到穩定的 30+ FPS,足以提供流暢的即時影像。

建構系統和第一個測試

後端完成後,我必須將其新增至 Makefile.am 和 configure.ac。這裡唯一值得注意的是 Emscripten 專屬旗標修改:

emscripten)
  AC_SUBST(EXEEXT, [.html])
  # Note: LT_LDFLAGS is not enough here because we need link flags for executable.
  AM_LDFLAGS="${AM_LDFLAGS} --bind -s ASYNCIFY -s ASSERTIONS -s ALLOW_MEMORY_GROWTH -s INVOKE_RUN=0 -s EXPORTED_RUNTIME_METHODS=['callMain']"
  ;;

首先,Unix 平台上的執行檔通常沒有副檔名。不過,Emscripten 會根據您要求的副檔名產生不同的輸出內容。我使用 AC_SUBST(EXEEXT, …) 將可執行檔副檔名變更為 .html,這樣一來,套件中的任何可執行檔 (測試和範例) 都會變成 HTML,並使用 Emscripten 的預設殼層,負責載入和例項化 JavaScript 和 WebAssembly。

其次,由於我使用 Embind 和 Asyncify,因此需要啟用這些功能 (--bind -s ASYNCIFY),並透過連結器參數允許動態記憶體成長 (-s ALLOW_MEMORY_GROWTH)。很遺憾,程式庫無法向連結器回報這些旗標,因此每個使用這個 libusb 連接埠的應用程式,都必須在建構設定中加入相同的連結器旗標。

最後,如前所述,WebUSB 需要透過使用者手勢完成裝置列舉。libusb 範例和測試假設可以在啟動時列舉裝置,如果未變更,則會失敗並顯示錯誤。因此,我必須停用自動執行 (-s INVOKE_RUN=0),並公開手動 callMain() 方法 (-s EXPORTED_RUNTIME_METHODS=...)。

完成上述所有步驟後,我可以使用靜態網路伺服器提供產生的檔案、初始化 WebUSB,並在開發人員工具的協助下,手動執行這些 HTML 執行檔。

螢幕截圖顯示 Chrome 視窗,其中開發人員工具在本地提供的「testlibusb」頁面上開啟。DevTools 控制台正在評估「navigator.usb.requestDevice({ filters: [] })」,這會觸發權限提示,目前要求使用者選擇要與網頁共用的 USB 裝置。目前已選取 ILCE-6600 (Sony 相機)。

下一個步驟的螢幕截圖,開發人員工具仍處於開啟狀態。選取裝置後,控制台會評估新的運算式 `Module.callMain(['-v'])`,以詳細模式執行 `testlibusb` 應用程式。輸出內容會顯示先前連接的 USB 攝影機的各種詳細資訊:製造商 Sony、產品 ILCE-6600、序號、設定等。

雖然看起來沒什麼,但將程式庫移植到新平台時,首次產生有效輸出內容的階段相當令人興奮!

使用通訊埠

如上所述,通訊埠取決於一些 Emscripten 功能,目前需要在應用程式的連結階段啟用。如要在自己的應用程式中使用這個 libusb 通訊埠,請按照下列步驟操作:

  1. 下載最新的 libusb,做為建構作業的一部分,或在專案中新增為 Git 子模組。
  2. 在 libusb 資料夾中執行 autoreconf -fiv。
  3. 執行 emconfigure ./configure –host=wasm32 –prefix=/some/installation/path,初始化專案以進行跨平台程式碼編譯,並設定要放置建構構件的路徑。
  4. 執行 emmake make install。
  5. 將應用程式或更高層級的程式庫指向先前選擇的路徑,搜尋 libusb。
  6. 在應用程式的連結引數中加入下列旗標:--bind -s ASYNCIFY -s ALLOW_MEMORY_GROWTH。

這個程式庫目前有幾項限制:

  • 不支援取消轉移。這是 WebUSB 的限制,而這項限制源自 libusb 本身缺乏跨平台傳輸取消功能。
  • 不支援等時傳輸。只要參考現有傳輸模式的實作方式,應該不難新增,但這也是一種罕見的模式,而且我沒有任何裝置可以測試,所以目前不支援。如果您有這類裝置,且想為程式庫貢獻內容,歡迎提交 PR!
  • 先前所述的跨平台限制。這些限制是由作業系統所施加,因此我們無法採取太多措施,只能要求使用者覆寫驅動程式或權限。不過,如果您要移植 HID 或序列裝置,可以按照 libusb 範例,將其他程式庫移植到其他 Fugu API。舉例來說,您可以將 C 程式庫 hidapi 移植到 WebHID,並完全避開與低階 USB 存取相關的問題。

結論

本文說明如何運用 Emscripten、Asyncify 和 Fugu API,透過一些整合技巧,將 libusb 等低階程式庫移植到網頁。

移植這類重要且廣泛使用的低階程式庫特別有價值,因為這能讓高階程式庫甚至整個應用程式也移植到網頁上。這項技術可讓所有類型的裝置和作業系統,都能使用先前僅限一或兩個平台使用者才能享有的體驗,只要按一下連結即可。

在下一篇文章中,我將逐步說明建構網頁 gPhoto2 示範的步驟,這項示範不僅會擷取裝置資訊,也會廣泛使用 libusb 的傳輸功能。同時,希望您能從 libusb 範例中獲得啟發,並嘗試示範、使用程式庫本身,甚至繼續將另一個廣泛使用的程式庫移植到其中一個 Fugu API。