XRInputSourceArray: length 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

只讀的 length 屬性返回一個整數值,指示 XRInputSourceArray 物件所表示的輸入源列表中的專案數。

一個整數值,指示陣列中包含的代表 WebXR 輸入源的 XRInputSource 物件的數量。

示例

在此示例中,一個需要至少一個輸入源的遊戲使用 length 在繼續允許使用者玩遊戲之前進行檢查。

js
let sources = xrSession.inputSources;

if (sources.length === 0) {
  showAlertDialog(
    "You need to have at least one controller to play Super Duper Shark Jump Fest 9000.",
    [
      { label: "Shop Now", url: "https://www.example.com/shop/controllers" },
      { label: "Quit", handler: quitGame },
    ],
  );
}

在這裡,如果 length 為 0,則會呼叫一個假設的 showAlertDialog() 函式,該函式帶有一個解釋需要控制器的提示字串,以及一個物件陣列,每個物件描述一個按鈕及其單擊時應發生的操作。第一個會將使用者帶到 Amazon.com 搜尋 VR 控制器的頁面,第二個將呼叫 quitGame() 函式來開始關閉遊戲程式。

規範

規範
WebXR Device API
# dom-xrinputsourcearray-length

瀏覽器相容性