Definitions for the sensor APIs

Term

Description

Channel

Abstraction of a sensor. Data from one physical sensor may be mapped to several channels.

Channel condition

A value-operator pair targeting a single value inside a data item, indicated by an index. A condition is met when the channel data value comparison with the condition value using condition operator is true. The conditions are gathered in condition sets.

There are two condition types: single limit conditions and range conditions. Range conditions are actually made up from two separate conditions representing the lower and upper limits of the range.

Channel item property

A single property inside a channel data item.

Channel property

A single channel property.

Data item

A discrete data package that contains sensor data or an event parsed from sensor data and possibly some related values, such as a timestamp. Each channel provides a single type of data item only.

Property

Properties are configuration values of sensor channels. Changing a property affects all clients listening to the affected channel(s).

Sensor

Physical sensor. A single sensor can provide multiple channels, such as raw data channel and event channels, or multiple sensor readings can be incorporated into a single channel.

Channel data types

Continuous data channel

A continuous data channel outputs data at regular intervals. Examples: Accelerometer XYZ, Rotation, Magnetometer XYZ.

Event channel

A channel that signals a client when an event has happened. Examples: Single Tap, Double Tap.

State channel

A channel that signals a client when its state has changed. Examples: Orientation, Proximity Monitor. You can also query the current state of the channel.