DeviceMotionEvent: accelerationIncludingGravity property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2023.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Thuộc tính chỉ đọc accelerationIncludingGravity của giao diện DeviceMotionEvent trả về lượng gia tốc được ghi bởi thiết bị, tính bằng mét trên giây bình phương (m/s²). Không giống như DeviceMotionEvent.acceleration vốn bù trừ ảnh hưởng của trọng lực, giá trị của nó là tổng gia tốc của thiết bị do người dùng tạo ra và gia tốc bằng và ngược chiều với gia tốc do trọng lực gây ra. Nói cách khác, nó đo lực g. Trong thực tế, giá trị này biểu thị dữ liệu thô được đo bởi gia tốc kế.

Giá trị này thường không hữu ích như DeviceMotionEvent.acceleration, nhưng có thể là giá trị duy nhất khả dụng trên các thiết bị không thể loại bỏ trọng lực khỏi dữ liệu gia tốc, chẳng hạn như trên các thiết bị không có con quay hồi chuyển.

Note: Tên accelerationIncludingGravity có thể gây nhầm lẫn. Thuộc tính này biểu thị gia tốc bao gồm hiệu ứng của trọng lực. Ví dụ: nếu thiết bị nằm phẳng trên bề mặt ngang với màn hình hướng lên, trọng lực sẽ là -9.8 dọc theo trục Z, trong khi acceleration.z sẽ là 0 và accelerationIncludingGravity.z sẽ là 9.8. Tương tự, nếu thiết bị đang rơi tự do với màn hình nằm ngang và hướng lên, trọng lực sẽ là -9.8 dọc theo trục Z, trong khi acceleration.z sẽ là -9.8 và accelerationIncludingGravity.z sẽ là 0.