XRHand

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Das XRHand-Interface ist ein Paariterator (eine geordnete Zuordnung), bei dem der Schlüssel die Handgelenke und der Wert ein XRJointSpace ist.

XRHand wird durch XRInputSource.hand zurückgegeben.

Instanzeigenschaften

size Schreibgeschützt Experimentell: Gibt 25 zurück, die Größe des Paariterators.

Das XRHand-Objekt ist ein Paariterator und kann direkt in einer for...of-Struktur verwendet werden. for (const joint of myHand) ist gleichwertig zu for (const joint of myHand.entries()). Es ist jedoch kein map-ähnliches Objekt, daher gibt es keine clear(), delete(), has() und set() Methoden.

entries() Experimentell: Gibt einen Iterator mit den Handgelenk-/XRJointSpace-Paaren für jedes Element zurück. Siehe Map.prototype.entries() für weitere Details.
forEach() Experimentell: Führt eine bereitgestellte Funktion für jedes Handgelenk-/XRJointSpace-Paar einmal aus. Siehe Map.prototype.forEach() für weitere Details.
get() Experimentell: Gibt einen XRJointSpace für ein bestimmtes Handgelenk zurück oder undefined, wenn kein solcher Handgelenkschlüssel in der Map vorhanden ist. Siehe Map.prototype.get() für weitere Details.
keys() Experimentell: Gibt einen Iterator mit allen Handgelenkschlüsseln zurück. Siehe Map.prototype.keys() für weitere Details.
values() Experimentell: Gibt einen Iterator mit allen XRJointSpace-Werten zurück. Siehe Map.prototype.values() für weitere Details.

Handgelenke

Das XRHand-Objekt enthält die folgenden Handgelenke:

Hand

Handgelenk	Index
wrist	0
thumb-metacarpal	1
thumb-phalanx-proximal	2
thumb-phalanx-distal	3
thumb-tip	4
index-finger-metacarpal	5
index-finger-phalanx-proximal	6
index-finger-phalanx-intermediate	7
index-finger-phalanx-distal	8
index-finger-tip	9
middle-finger-metacarpal	10
middle-finger-phalanx-proximal	11
middle-finger-phalanx-intermediate	12
middle-finger-phalanx-distal	13
middle-finger-tip	14
ring-finger-metacarpal	15
ring-finger-phalanx-proximal	16
ring-finger-phalanx-intermediate	17
ring-finger-phalanx-distal	18
ring-finger-tip	19
pinky-finger-metacarpal	20
pinky-finger-phalanx-proximal	21
pinky-finger-phalanx-intermediate	22
pinky-finger-phalanx-distal	23
pinky-finger-tip	24

Beispiele

Verwendung von `XRHand`-Objekten

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);
}

Spezifikationen

Specification
WebXR Hand Input Module - Level 1 # xrhand-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

XRInputSource.hand