motion
— Motion Sensor Data on iOS¶The motion
module allows you to access your iOS device’s motion sensor data (accelerometer, gyroscope, magnetometer).
Functions in the motion
module:
motion.
start_updates
()¶Start monitoring the device’s motion sensors. You should balance this with a stop_updates()
call to improve battery life. All the get... functions require that you call start_updates()
first, otherwise, no meaningful data will be returned.
motion.
stop_updates
()¶Stop monitoring the device’s motion sensors.
motion.
get_gravity
()¶Return the gravity vector (x, y, z).
motion.
get_user_acceleration
()¶Return the acceleration the user is giving to the device. The total acceleration is equal to the gravity vector returned from get_gravity()
plus the user acceleration.
motion.
get_attitude
()¶Return the attitude of the device (roll, pitch, yaw).
motion.
get_magnetic_field
()¶Return the magnetic field vector with respect to the device (x, y, z, accuracy).