Accelerometer API

Using the Accelerometer API, you can register various gesture events (such as shake), and then detect the change in orientation of a device along three orthogonal axes x, y, and z.

The following diagram shows the standard coordinate system that the Quantum Accelerometer API uses

This coordinate system is independent of any particular type of device. The following table describes the coordinate system to be used for the accelerometer API:

Axis Description Value Direction
X Floating point value indicating the magnitude of the acceleration force along the X-Axis positive Towards the right when the device is facing you
negative Towards the left when the device is facing you
Y Floating point value indicating the magnitude of the acceleration force along the Y-Axis positive Towards the top of the top of the device
negative Towards the bottom of the device
Z Floating point value indicating the magnitude of the acceleration force along the Z-Axis positive The axis coming out from the device screen (towards you) when the device is facing you
negative The axis coming out from the device back (away from you) when the device is facing you
 

The Accelerometer API uses kony.accelerometer Namespace and helps you manage and retrieve data from the device's accelerometer. It comprises of the following API elements.

FunctionDescription
kony.accelerometer.registerAccelerationEventsRegisters event handlers for acceleration events, such as 'shake'.
kony.accelerometer.retrieveCurrentAcceleration Sets callback functions for retrieving the current device acceleration.
kony.accelerometer.startMonitoringAccelerationStarts monitoring the device's acceleration on a continuous basis.
kony.accelerometer.stopMonitoringAccelerationStops the device monitoring activity if it is active.
kony.accelerometer.unregisterAccelerationEventsUnregisters event handlers for the specified acceleration event types.
 

When you use the Acceleometer API, any changes in gestures are registered by invoking the kony.accelerometer.registerAccelerationEvents function. After the change is registered, the current acceleration of the device is determined by using the kony.accelerometer.retrieveCurrentAcceleration function. Moniter the acceleration of the device by using the kony.accelerometer.startMonitoringAcceleration function. To stop monitoring the device, use the kony.accelerometer.stopMonitoringAcceleration function. To unregister event handlers for the specified acceleration event types, you can use the kony.accelerometer.unregisterAccelerationEvents function.

NOTE: The accelerometer APIs are applicable only when os.platform().hasaccelerometer returns true.

 

To view the functionality of the Accelerometer API in action, download the sample application from the link below. Once the application is downloaded, build and preview the application using the Quantum App.

AxisDescriptionValueDirection