The proximity sensor measures the distance to an object in front of the mobile device. Depending on the hardware, it can be in centimeters or binary.

Public functions

  • Proximity.getFrequency( Context context ): returns the sampling rate in Hz.

Settings

  • Aware_Preferences.STATUS_PROXIMITY: true or false to activate or deactivate sensor.
  • Aware_Preferences.FREQUENCY_PROXIMITY: non-deterministic frequency in microseconds (dependent of the hardware sensor capabilities and resources), e.g., 200000 (normal), 60000 (UI), 20000 (game), 0 (fastest).

aware-broadcasts

  • Proximity.ACTION_AWARE_PROXIMITY: new data recorded in provider.
    • Proximity.EXTRA_DATA: the recorded data, as ContentValues.
  • Proximity.ACTION_AWARE_PROXIMITY_LABEL: assign label to the recorded data.
    • Proximity.EXTRA_LABEL: the desired label.

aware-providers

Proximity Sensor

Contains the hardware sensor capabilities in the mobile device.

Proximity_Sensor.CONTENT_URI
content://com.aware.provider.proximity/sensor_proximity

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
double_sensor_maximum_range REAL Maximum sensor value possible
double_sensor_minimum_delay REAL Minimum sampling delay in microseconds
sensor_name TEXT Sensor’s name
double_sensor_power_ma REAL Sensor’s power drain in mA
double_sensor_resolution REAL Sensor’s resolution in sensor’s units
sensor_type TEXT Sensor’s type
sensor_vendor TEXT Sensor’s manufacturer
sensor_version TEXT Sensor’s version number

Proximity Data

Contains the raw sensor data.

Proximity_Data.CONTENT_URI
content://com.aware.provider.proximity/proximity

Table field Field type Description
_id INTEGER primary key, auto incremented
timestamp REAL unixtime milliseconds since 1970
device_id TEXT AWARE device UUID
double_proximity REAL the distance to an object in front of the mobile device or binary presence (manufacturer dependent).
accuracy INTEGER Sensor’s accuracy level (see SensorManager)
label TEXT Customizable label. Useful for data calibration or traceability

Proximity