Sensors QML Plugin

Overview

The QML Sensors Plugin provides an easy to use interface to the Sensors API. It enables us to receive sensor events and to read current values from sensors.

The plugin contains many sensor types and access functions to read values from them. As an example consider the orientation sensor. The orientation example simply displays text on-screen to show the current orientation.

The QML code that reads the value is quite simple. Here we see a QML component orientation declared which is an OrientationSensor element. First the sensor is started by setting the active property to true. The element receives a signal when the reading changes and it is picked up by the onReadingChanged slot. Now the reading property of this element can be used to extract the current orientation so that it can be compared against the defined values of various orientations in the OrientationReading element.

 OrientationSensor {
     id: orientation
     active: true

     onReadingChanged: {

         if (reading.orientation == OrientationReading.FaceUp)
             content.state = "FaceUp";

         // ... more tests for different orientations ...
     }
 }

Other sensors can be treated in a similar manner. For example, the Compass sensor could have almost identical coding

 Compass {
     id: compass
     active: true

     onReadingChanged: {
         compassHeading.text = reading.azimuth;

         // ...
     }
 }

QML Elements