XRInputSource

Instanz-Eigenschaften

gamepad Schreibgeschtzt

Ein Gamepad-Objekt, das den Zustand der Tasten und Achsen der XR-Eingabequelle beschreibt, wenn es sich um ein Gamepad oder ein vergleichbares Gert handelt. Ist das Gert kein gamepad-hnliches Gert, hat diese Eigenschaft den Wert null.

gripSpace Schreibgeschtzt

Ein XRSpace, dessen Ursprung die Pose nachverfolgt, die verwendet wird, um Objekte zu rendern, die erscheinen sollen, als ob sie in der durch handedness angegebenen Hand gehalten werden. Die Orientierung dieses Raums gibt den Winkel an, in dem die Hand das Objekt greift. Lesen Sie im Hauptartikel ber gripSpace weiter, um mehr Details darber zu erfahren, wie dieser Raum verwendet wird.

hand Schreibgeschtzt

Ein XRHand-Objekt, das Zugriff auf das zugrunde liegende Handverfolgungsgert bietet.

handedness Schreibgeschtzt

Ein String, der angibt, in welcher Hand das durch diese XRInputSource reprsentierte Gert verwendet wird, falls vorhanden. Der Wert kann left, right oder none sein.

profiles Schreibgeschtzt

Ein Array von Strings, die jeweils den Namen eines Eingabeprofils angeben, das die bevorzugte visuelle Darstellung und das Verhalten dieser Eingabequelle beschreibt.

targetRayMode Schreibgeschtzt

Ein String, der die Methodik angibt, die verwendet wird, um den Ziellinienstrahl zu erzeugen: gaze, tracked-pointer oder screen.

targetRaySpace Schreibgeschtzt

Ein XRSpace-Objekt, das den Ursprung des Zielstrahls und die Richtung festlegt, in die er sich erstreckt. Dieser Raum wird mit der durch targetRayMode definierten Methode festgelegt.

Instanz-Methoden

Das XRInputSource-Interface definiert keine Methoden.

Verwendungshinweise

Aktionen und der Zielstrahl

Wenn das Gert eine Angabe der Richtung liefert, in die es zeigt, erfolgt dies mithilfe eines Zielstrahls. Dies ist ein Strahl, der sich von der Position des Gerts in die Richtung erstreckt, in die es zeigt.

Ein Zielstrahl, der von einem Hand-Controller ausgesendet wird.

[Ein Screenshot, der einen Zielstrahl zeigt, der von einem Hand-Controller ausgesendet wird]

Wenn das Gert einen Auslser oder eine andere drckbare Eingabe enthlt, wie z.B. ein Handgestengert, das erkennt, wenn der Benutzer seine Faust ballt, wird diese Aktion als primre Drckaktion bezeichnet. Eine primre Drckaktion sollte einem Greifakt in der Realitt entsprechen, wie dem Ergreifen eines Objekts oder dem Drcken eines Abzugs an einem Werkzeug oder einer Waffe. Wenn eine Drckaktion beginnt, also z.B. der Benutzer den Abzug drckt oder seinen Griff verstrkt, wird ein squeezestart-Ereignis an die XRSession gesendet. Sobald die Aktion abgeschlossen ist und der Benutzer den Abzug oder Griff losgelassen hat, wird ein squeeze-Ereignis gesendet. Dies wird gefolgt von einem squeezeend, das ebenfalls gesendet wird, wenn die Aktion abgebrochen und nicht abgeschlossen wird.

Wenn das Gert eine Taste oder andere drckbare Eingabesteuerung hat, ist es eine primre Eingabequelle, und diese Taste ist eine primre Aktion. Eine primre Aktion kann auftreten, wenn der Benutzer eine Taste drckt, auf einem Touchpad oder der obersten Taste eines Steuerknppels klickt oder ein Handgesten- oder Sprachbefehl verwendet, der die taste-hnliche Aktion auslst. Wenn eine primre Aktion beginnt, wird ein selectstart-Ereignis an die XRSession gesendet. Wenn die Aktion abgeschlossen ist (z.B. wenn der Benutzer die Taste loslsst), wird ein select-Ereignis gesendet. Schlielich, sobald dies abgeschlossen ist oder wenn der Benutzer die Aktion abbricht wird ein selectend-Ereignis an das Sitzungsobjekt gesendet.

Eine Aktion kann entweder vom Benutzer auf gertespezifische Weise abgebrochen werden oder wenn das Eingabegert getrennt wird, bevor die Aktion abgeschlossen ist.

Lokales Koordinatensystem

Jede Eingabequelle hat ihr eigenes lokales Koordinatensystem, das durch die gripSpace-Eigenschaft beschrieben wird, das ein XRSpace ist, das dazu verwendet wird, das Koordinatensystem der Eingabe in das Weltkoordinatensystem zu berfhren. Das Koordinatensystem des Griffraums kann dann verwendet werden, um Objekte zu rendern, so dass sie erscheinen, als ob sie in der Hand des Benutzers gehalten werden.

[Ein Diagramm, das das Koordinatensystem zeigt, das durch die gripSpace-Eigenschaft definiert wird]

Weitere Details zum Koordinatensystem der Eingabequelle finden Sie im Artikel, der die gripSpace-Eigenschaft im Detail behandelt.

Spezifikationen

Spezifikation
WebXR Device API # xrinputsource-interface

Browser-Kompatibilitt

Siehe auch

• WebXR Device API
• Eingaben und Eingabequellen
• XRInputSourceArray
• XRSpace