XRInputSource: profiles-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte XRInputSource
Eigenschaft profiles
gibt ein Array von Zeichenfolgen zurück, die jeweils ein Konfigurationsprofil für die Eingabequelle beschreiben. Die Profilzeichenfolgen sind in der Reihenfolge der Spezifität aufgelistet, wobei das spezifischste Profil zuerst aufgeführt wird.
Hinweis: Die profiles
-Liste ist immer leer, wenn sich die WebXR
Sitzung im Inline-Modus befindet.
Wert
Ein Array von Zeichenfolgen, die jeweils ein Konfigurationsprofil für das durch das XRInputSource
Objekt dargestellte Eingabegerät beschreiben. Jedes Eingabeprofil spezifiziert die bevorzugte visuelle Darstellung und das Verhalten der Eingabequelle.
Eingabeprofilnamen
Ein Eingabeprofilname ist eine Zeichenfolge, die eine visuelle Darstellung und ein Verhalten beschreibt, das die Eingabequelle möglicherweise verwenden kann. Jede Zeichenfolge:
- Enthält keine Leerzeichen; stattdessen werden Wörter durch Bindestriche ("-") getrennt
- Wenn die Plattform es ermöglicht, können die USB-Vendor- und Produkt-ID bereitgestellt werden, jedoch ohne Gewähr auf Verlässlichkeit
- Identifiziert nicht eindeutig ein spezifisches Gerät, sondern identifiziert eine Konfiguration, die das Produkt nutzen kann
- Liefert keine Informationen über die Händigkeit des Geräts, falls zutreffend
Das WebXR Input Profiles Registry wird von Geräteentwicklern und Browser-Entwicklern genutzt, um zu gewährleisten, dass ein bestimmtes Gerät unabhängig vom verwendeten Browser oder anderen User-Agenten dieselben Profilzeichenfolgen meldet.
Generische Eingabeprofilnamen
Die folgenden Eingabeprofilnamen sind generisch und können als Fallback dienen, die die Geräte im weitesten Sinne beschreiben.
- 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
Beispiele
Die Liste in profiles
ist in umgekehrter Spezifität geordnet; das heißt, die genaueste Beschreibung steht an erster Stelle und die am wenigsten genaue am Ende. Der erste Eintrag in der Liste gibt typischerweise das genaue Modell des Controllers oder ein mit dem Controller kompatibles Modell an.
Zum Beispiel ist Eintrag 0 in profiles
für einen Oculus Touch Controller oculus-touch
. Der nächste Eintrag ist generic-trigger-squeeze-thumbstick
, was ein generisches Gerät mit einem Trigger, einer Quetschsteuerung und einem Thumbstick anzeigt. Obwohl der Oculus Touch Controller tatsächlich ein Thumbpad anstelle eines Thumbsticks hat, ist die Gesamtbeschreibung "nah genug", sodass die Details innerhalb des Profils, das zu dem Namen passt, die sinnvolle Interpretation des Controllers ermöglichen.
inputSource.profiles;
// ['oculus-touch', 'generic-trigger-squeeze-thumbstick']
Spezifikationen
Specification |
---|
WebXR Device API # dom-xrinputsource-profiles |
Browser-Kompatibilität
BCD tables only load in the browser