DeviceMotionEvent: accelerationIncludingGravity-Eigenschaft
Baseline 2023Newly available
Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte accelerationIncludingGravity-Eigenschaft der DeviceMotionEvent-Schnittstelle gibt die Menge an Beschleunigung zurück, die vom Gerät gemessen wird, in Metern pro Quadratssekunde (m/s²). Im Gegensatz zu DeviceMotionEvent.acceleration, das den Einfluss der Schwerkraft kompensiert, ist ihr Wert die Summe der vom Benutzer induzierten Beschleunigung des Geräts und einer gleichgroßen, entgegengesetzten Beschleunigung, die durch die Schwerkraft verursacht wird. Mit anderen Worten, sie misst den G-Force. In der Praxis stellt dieser Wert die Rohdaten dar, die von einem Beschleunigungsmesser gemessen werden.
Dieser Wert ist normalerweise nicht so nützlich wie DeviceMotionEvent.acceleration, kann jedoch der einzige verfügbare Wert auf Geräten sein, die nicht in der Lage sind, die Schwerkraft aus den Beschleunigungsdaten zu entfernen, wie zum Beispiel auf Geräten ohne Gyroskop.
Hinweis:
Der Name accelerationIncludingGravity kann irreführend sein. Diese Eigenschaft repräsentiert die Beschleunigung einschließlich der Einflüsse der Schwerkraft. Beispielsweise, wenn ein Gerät flach auf einer horizontalen Oberfläche mit dem Bildschirm nach oben liegt, wäre die Schwerkraft -9,8 entlang der Z-Achse, während acceleration.z 0 wäre und accelerationIncludingGravity.z 9,8 wäre. Ebenso, wenn ein Gerät im freien Fall mit dem horizontalen Bildschirm nach oben gerichtet ist, wäre die Schwerkraft -9,8 entlang der Z-Achse, während acceleration.z -9,8 wäre und accelerationIncludingGravity.z 0 wäre.
Wert
Die accelerationIncludingGravity-Eigenschaft ist ein Objekt, das Informationen über die Beschleunigung auf drei Achsen bereitstellt. Jede Achse wird durch ihre eigene Eigenschaft dargestellt:
Spezifikationen
| Specification |
|---|
| Device Orientation and Motion # ref-for-dom-devicemotionevent-accelerationincludinggravity④ |