XRHand

Limited availability

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

Die XRHand-Schnittstelle ist ein Paar-Iterator (eine geordnete Map) mit dem Schlüssel, der die Handgelenke darstellt, und dem Wert, der ein XRJointSpace ist.

XRHand wird von XRInputSource.hand zurückgegeben.

Instanzeigenschaften

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

Das XRHand-Objekt ist ein Paar-Iterator. Es kann direkt in einer for...of-Struktur verwendet werden. for (const joint of myHand) ist äquivalent zu for (const joint of myHand.entries()). Es ist jedoch kein map-ähnliches Objekt, daher stehen die Methoden clear(), delete(), has() und set() nicht zur Verfügung.

entries() Experimentell: Gibt einen Iterator mit den Handgelenken/XRJointSpace-Paaren für jedes Element zurück. Siehe Map.prototype.entries() für weitere Details.
forEach() Experimentell: Führt eine bereitgestellte Funktion einmal pro Handgelenk/ XRJointSpace-Paar aus. Siehe Map.prototype.forEach() für weitere Details.
get() Experimentell: Gibt einen XRJointSpace für ein gegebenes Handgelenk oder undefined zurück, 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

Siehe auch

XRInputSource.hand