XRHand

可用性有限

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

XRHand 介面是一個鍵值對迭代器(一個有序對映),其鍵是手部關節,值是 XRJointSpace

XRHandXRInputSource.hand 返回。

例項屬性

size 只讀 實驗性

返回 25,即鍵值對迭代器的長度。

例項方法

XRHand 物件是一個鍵值對迭代器。可以直接在 for...of 結構中使用。for (const joint of myHand) 等同於 for (const joint of myHand.entries())。但是,它不是一個類似 Map 的物件,因此沒有 clear()delete()has()set() 方法。

entries() 實驗性

返回一個迭代器,其中包含每個元素的“手部關節/ XRJointSpace”對。有關更多詳細資訊,請參閱 Map.prototype.entries()

forEach() 實驗性

為每個“手部關節/ XRJointSpace”對執行一次提供的函式。有關更多詳細資訊,請參閱 Map.prototype.forEach()

get() 實驗性

返回給定手部關節的 XRJointSpace,如果對映中不存在該手部關節鍵,則返回 undefined。有關更多詳細資訊,請參閱 Map.prototype.get()

keys() 實驗性

返回一個包含所有手部關節鍵的迭代器。有關更多詳細資訊,請參閱 Map.prototype.keys()

values() 實驗性

返回一個包含所有 XRJointSpace 值的迭代器。有關更多詳細資訊,請參閱 Map.prototype.values()

手部關節

XRHand 物件包含以下手部關節:

Hand

手部關節 索引
手腕 0
拇指掌骨 1
拇指近節指骨 2
拇指遠節指骨 3
拇指尖 4
食指掌骨 5
食指近節指骨 6
食指中節指骨 7
食指遠節指骨 8
食指尖 9
中指掌骨 10
中指近節指骨 11
中指中節指骨 12
中指遠節指骨 13
中指尖 14
無名指掌骨 15
無名指近節指骨 16
無名指中節指骨 17
無名指遠節指骨 18
無名指尖 19
小指掌骨 20
小指近節指骨 21
小指中節指骨 22
小指遠節指骨 23
小指尖 24

示例

使用 XRHand 物件

js
const wristJoint = inputSource.hand.get("wrist");
const indexFingerTipJoint = inputSource.hand.get("index-finger-tip");

for (const [joint, jointSpace] of inputSource.hand) {
  console.log(joint);
  console.log(jointSpace);
}

規範

規範
WebXR Hand Input 模組 - Level 1
# xrhand-interface

瀏覽器相容性

另見