DeviceMotionEvent: свойство accelerationIncludingGravity

Базовая версия 2023

Новая возможность

С сентября 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на более старых устройствах или браузерах.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.

Чтение только свойство accelerationIncludingGravity интерфейса DeviceMotionEvent возвращает значение ускорения, зафиксированного устройством, в метрах в секунду в квадрате (м/с²). В отличие от DeviceMotionEvent.acceleration, которое компенсирует влияние гравитации, это значение представляет собой сумму ускорения устройства, вызванного пользователем, и ускорения, равного и противоположного ускорению, вызванному гравитацией. Другими словами, это значение измеряет перегрузку. На практике это значение представляет собой исходные данные, измеренные акселерометром.

Это значение обычно не так полезно, как DeviceMotionEvent.acceleration, но может быть единственным доступным на устройствах, не способных отделить гравитационное ускорение от данных об ускорении, например, на устройствах без гироскопа.

Примечание: Название свойства accelerationIncludingGravity может ввести в заблуждение. Это свойство представляет ускорение, включая влияние гравитации. Например, если устройство лежит на горизонтальной поверхности экраном вверх, гравитация будет равна -9,8 по оси Z, в то время как acceleration.z будет равно 0, а accelerationIncludingGravity.z будет равно 9,8. Аналогично, если устройство падает свободно с горизонтальным экраном вверх, гравитация будет равна -9,8 по оси Z, в то время как acceleration.z будет равно -9,8, а accelerationIncludingGravity.z будет равно 0.

Значение

Свойство accelerationIncludingGravity — это объект, предоставляющий информацию об ускорении по трём осям. Каждая ось представлена собственным свойством:

x: Представляет ускорение по оси X, которая является осью с запада на восток
y: Представляет ускорение по оси Y, которая является осью с юга на север
z: Представляет ускорение по оси Z, которая является осью снизу вверх

Спецификации

Спецификация
Ориентация и движение устройства # ref-for-dom-devicemotionevent-accelerationincludinggravity④

Совместимость браузеров

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`accelerationIncludingGravity`	31	12	6	18	17	31	6	18	4.2	2.0	4.4.3

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/accelerationIncludingGravity