The ClaimAccelerometer() method

ClaimAccelerometer ();

To start receiving accelerometer reading updates from the proxy, the application must call the ClaimAccelerometer() method. It can do so whether an accelerometer is available or not, updates would then be sent when an accelerometer appears.

Applications should call ReleaseAccelerometer() when readings are not required anymore. For example, an application that monitors the orientation of the main screen should stop monitoring for updates when that screen has been turned off.

This prevents the sensor proxy from polling the device, thus increasing wake-ups and reducing battery life.

The ReleaseAccelerometer() method

ReleaseAccelerometer ();

This should be called as soon as readings are not required anymore. Note that resources are freed up if a monitoring application exits without calling ReleaseAccelerometer(), crashes or the sensor disappears.

The ClaimLight() method

ClaimLight ();

To start receiving ambient light sensor reading updates from the proxy, the application must call the ClaimLight() method. It can do so whether an ambient light sensor is available or not, updates would then be sent when such a sensor appears.

Applications should call ReleaseLight() when readings are not required anymore. For example, an application that monitors the ambient light to change the screen brightness should stop monitoring for updates when that screen has been turned off.

This prevents the sensor proxy from polling the device, thus increasing wake-ups and reducing battery life.

The ReleaseLight() method

ReleaseLight ();

This should be called as soon as readings are not required anymore. Note that resources are freed up if a monitoring application exits without calling ReleaseLight(), crashes or the sensor disappears.

The "HasAccelerometer" property

HasAccelerometer  readable   b

Whether a supported accelerometer is present on the system.

The "AccelerometerOrientation" property

AccelerometerOrientation  readable   s

The detected orientation of the tablet or laptop. Possible values are: - undefined - normal - bottom-up - left-up - right-up

The "HasAmbientLight" property

HasAmbientLight  readable   b

Whether a supported ambient light sensor is present on the system.

The "LightLevelUnit" property

LightLevelUnit  readable   s

The unit used in Ambient Light Sensor readings. It is one of either "lux" or "vendor".

Note that different hardware will have different readings in the same condition, so values should be taken as relative.

When the unit is "vendor", readings will be a percentage with 100 being the maximum reading.

The "LightLevel" property

LightLevel  readable   d

The ambient light sensor reading, in the unit exported in the "LightLevelUnit" property.