DeviceMotionEvent: Eigenschaft accelerationIncludingGravity

Die accelerationIncludingGravity schreibgeschützte Eigenschaft der DeviceMotionEvent-Schnittstelle gibt die Menge an Beschleunigung zurück, die vom Gerät in Metern pro Quadratsekunde (m/s²) aufgezeichnet wurde. Im Gegensatz zu DeviceMotionEvent.acceleration, die den Einfluss der Schwerkraft kompensiert, ist ihr Wert die Summe der vom Nutzer verursachten Beschleunigung und einer Beschleunigung, die gleich und entgegengesetzt zu der durch die Schwerkraft verursachten Beschleunigung ist. Mit anderen Worten, sie misst die g-Kraft. In der Praxis stellt dieser Wert die Rohdaten dar, die von einem Beschleunigungsmesser gemessen werden.

Dieser Wert ist in der Regel nicht so nützlich wie DeviceMotionEvent.acceleration, kann aber auf Geräten, die nicht in der Lage sind, die Schwerkraft aus den Beschleunigungsdaten zu entfernen, wie zum Beispiel auf Geräten, die keinen Kreiselmesser haben, der einzige verfügbare Wert sein.

Note: Der Name accelerationIncludingGravity kann irreführend sein. Diese Eigenschaft stellt die Beschleunigung einschließlich der Auswirkungen der Schwerkraft dar. Wenn ein Gerät beispielsweise flach auf einer horizontalen Oberfläche liegt und der Bildschirm nach oben zeigt, wäre die Schwerkraft -9,8 entlang der Z-Achse, während acceleration.z 0 wäre und accelerationIncludingGravity.z 9,8 wäre. Ähnlich, wenn ein Gerät im freien Fall mit horizontalem Bildschirm nach oben ist, wäre die Schwerkraft -9,8 entlang der Z-Achse, während acceleration.z -9,8 und accelerationIncludingGravity.z 0 wäre.