Sensors.md 8.8 KB
Sensor support
Sensors are InputDevices that measure environmental characteristics of the device that the content is running on. Unity currently supports sensors on iOS and Android. Android supports a wider range of sensors than iOS.
Unlike other devices, sensors are disabled by default. To enable a sensor, call InputSystem.EnableDevice()).
InputSystem.EnableDevice(Gyroscope.current);
To disable a sensor, call InputSystem.DisableDevice().
InputSystem.DisableDevice(Gyroscope.current);
To check whether a sensor is currently enabled, use InputDevice.enabled.
if (Gyroscope.current.enabled)
Debug.Log("Gyroscope is enabled");
Each sensor Device implements a single Control which represents the data read by the sensor. The following sensors are available:
| Device | Android | iOS | Control | Type |
|---|---|---|---|---|
Accelerometer |
Yes | Yes | acceleration |
Vector3Control |
Gyroscope |
Yes | Yes | angularVelocity |
Vector3Control |
GravitySensor |
Yes | Yes | gravity |
Vector3Control |
AttitudeSensor |
Yes | Yes | attitude |
QuaternionControl |
LinearAccelerationSensor |
Yes | Yes | acceleration |
Vector3Control |
MagneticFieldSensor |
Yes | No | magneticField |
Vector3Control |
LightSensor |
Yes | No | lightLevel |
AxisControl |
PressureSensor |
Yes | No | atmosphericPressure |
AxisControl |
ProximitySensor |
Yes | No | distance |
AxisControl |
HumiditySensor |
Yes | No | relativeHumidity |
AxisControl |
AmbientTemperatureSensor |
Yes | No | ambientTemperature |
AxisControl |
StepCounter |
Yes | No | stepCounter |
IntegerControl |
Sampling frequency
Sensors sample continuously at a set interval. You can set or query the sampling frequency for each sensor using the samplingFrequency property. The frequency is expressed in Hertz (number of samples per second).
// Get sampling frequency of gyro.
var frequency = Gyroscope.current.samplingFrequency;
// Set sampling frequency of gyro to sample 16 times per second.
Gyroscope.current.samplingFrequency = 16;
Accelerometer
Use the accelerometer to measure the acceleration of a device. This is useful to control content by moving a device around. It reports the acceleration measured on a device both due to moving the device around, and due to gravity pulling the device down. You can use GravitySensor and LinearAccelerationSensor to get separate values for these. Values are affected by the Compensate For Screen Orientation setting.
Gyroscope
Use the gyroscope to measure the angular velocity of a device. This is useful to control content by rotating a device. Values are affected by the Compensate For Screen Orientation setting.
GravitySensor
Use the gravity sensor to determine the direction of the gravity vector relative to a device. This is useful to control content by device orientation. This is usually derived from a hardware Accelerometer, by subtracting the effect of linear acceleration (see LinearAccelerationSensor). Values are affected by the Compensate For Screen Orientation setting.
AttitudeSensor
Use the attitude sensor to determine the orientation of a device. This is useful to control content by rotating a device. Values are affected by the Compensate For Screen Orientation setting.
LinearAccelerationSensor
Use the accelerometer to measure the acceleration of a device. This is useful to control content by moving a device around. Linear acceleration is the acceleration of a device unaffected by gravity. This is usually derived from a hardware Accelerometer, by subtracting the effect of gravity (see GravitySensor). Values are affected by the Compensate For Screen Orientation setting.
MagneticFieldSensor
This Input Device represents the magnetic field that affects the device which is running the content. Values are in micro-Tesla (μT) and measure the ambient magnetic field in the X, Y, and Z axis.
LightSensor
This Input Device represents the ambient light measured by the device which is running the content. Value is in SI lux units.
PressureSensor
This Input Device represents the atmospheric pressure measured by the device which is running the content. Value is in in hPa (millibar).
ProximitySensor
This Input Device measures how close the device which is running the content is to the user. Phones typically use the proximity sensor to determine if the user is holding the phone to their ear or not. Values represent distance measured in centimeters.
HumiditySensor
This Input Device represents the ambient air humidity measured by the device which is running the content. Values represent the relative ambient air humidity in percent.
AmbientTemperatureSensor
This Input Device represents the ambient air temperature measured by the device which is running the content. Values represent temperature in Celsius degrees.
StepCounter
This Input Device represents the user's footstep count as measured by the device which is running the content.