Gamepad: displayId-Eigenschaft
Deprecated
Avoid using this feature in new projects. Development of the WebVR API halted in favor of WebXR. This feature may be a candidate for removal from web standards or browsers.
Consider using the following features instead: WebXR.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die schreibgeschützte Eigenschaft displayId des Gamepad-Interfaces gibt die VRDisplay.displayId des zugehörigen VRDisplay zurück – also des VRDisplay, dessen angezeigte Szene das Gamepad steuert.
Ein Gamepad gilt als einem VRDisplay zugeordnet, wenn es eine Pose meldet, die sich im selben Raum wie die Pose des Displays befindet. Siehe VRDisplay.getPose().
Hinweis: Diese Eigenschaft war Teil der alten WebVR API. Sie wurde durch das WebXR Gamepads Module abgelöst.
Für diese Eigenschaft gibt es keinen direkten Ersatz. Das einem XRInputSource zugeordnete Gamepad-Objekt kann über die Eigenschaft XRInputSource.gamepad abgerufen werden.
Wert
Eine Zahl, die die zugehörige VRDisplay.displayId angibt. Ist die Zahl 0, ist das Gamepad keinem VR-Display zugeordnet.
Beispiele
window.addEventListener("gamepadconnected", (e) => {
if (!e.gamepad.displayId) {
console.log("Gamepad connected");
} else {
console.log(
`Gamepad connected, associated with VR display ${e.gamepad.displayId}`,
);
}
});
Spezifikationen
Diese Eigenschaft war Teil der alten WebVR API, die durch das WebXR Gamepads Module abgelöst wurde. Sie wird nicht mehr als Standard weiterentwickelt.
Bis alle Browser die neuen WebXR APIs implementiert haben, empfiehlt es sich, für die Entwicklung browserübergreifend funktionierender WebXR-Anwendungen Frameworks wie A-Frame, Babylon.js oder Three.js oder einen Polyfill zu verwenden. Weitere Informationen finden Sie in Metas Leitfaden zur Migration von WebVR zu WebXR.