XRInputSource: profiles 屬性
只讀的 XRInputSource 屬性 profiles 返回一個字串陣列，每個字串描述了該輸入源的配置配置檔案。配置檔案字串按特異性順序排列，最特異的配置檔案列在最前面。
注意： 當 WebXR 會話處於內嵌模式時，profiles 列表始終為空。
值
一個字串陣列，每個字串描述由 XRInputSource 物件表示的輸入裝置的配置配置檔案。每個輸入配置檔案指定了輸入源的首選視覺表示和行為。
輸入配置檔名稱
輸入配置檔名稱是一個字串，描述了輸入源可以配置使用的視覺表示和行為。每個字串
- 不包含空格；單詞之間用連字元（“-”）分隔
- 如果平臺提供，可能會提供 USB 供應商和產品 ID，但不可依賴。
- 不唯一標識特定裝置；相反，它標識了產品能夠使用的配置。
- 不提供有關裝置的手部資訊（如果適用）。
裝置開發者和瀏覽器開發者使用 WebXR 輸入配置檔案登錄檔 來努力確保給定裝置無論使用哪個瀏覽器或其他 使用者代理，都會報告相同的配置檔案字串。
通用輸入配置檔名稱
以下輸入配置檔名稱是通用的，可以作為最粗略描述裝置的備用方案。
- generic-button
- generic-hand-select-grasp
- generic-hand-select
- generic-hand
- generic-touchpad
- generic-touchscreen
- generic-trigger-squeeze-thumbstick
- generic-trigger-squeeze-touchpad-thumbstick
- generic-trigger-squeeze-touchpad
- generic-trigger-squeeze
- generic-trigger-thumbstick
- generic-trigger-touchpad-thumbstick
- generic-trigger-touchpad
- generic-trigger
示例
profiles 中的列表按反向特異性順序排列；也就是說，最精確的描述在前，最不精確的描述在後。列表中的第一個條目通常指示控制器的精確型號，或控制器相容的型號。
例如，Oculus Touch 控制器的 profiles 中的條目 0 是 oculus-touch。下一個條目是 generic-trigger-squeeze-thumbstick，表示一個帶有觸發器、擠壓控制和拇指搖桿的通用裝置。儘管 Oculus Touch 控制器實際上有一個觸控板而不是拇指搖桿，但整體描述“足夠接近”，以至於配置檔案中與名稱匹配的詳細資訊將允許控制器被有用地解釋。
js
inputSource.profiles;
// ['oculus-touch', 'generic-trigger-squeeze-thumbstick']
規範
| 規範 |
|---|
| WebXR Device API # dom-xrinputsource-profiles |
瀏覽器相容性
載入中…