Skip to content

Device sensors Reference

Allow the game to access the sensors of a mobile device. Read more explanations about it.

Actions

Activate motion sensor
Activate the motion sensor. (remember to turn it off again)

See parameters & details

There are no parameters to set for this action.

Technical note: this action internal type (in GDevelop JSON) is DeviceSensors::ActivateMotionListener.

Activate orientation sensor
Activate the orientation sensor. (remember to turn it off again)

See parameters & details

There are no parameters to set for this action.

Technical note: this action internal type (in GDevelop JSON) is DeviceSensors::ActivateOrientationListener.

Deactivate motion sensor
Deactivate the motion sensor.

See parameters & details

There are no parameters to set for this action.

Technical note: this action internal type (in GDevelop JSON) is DeviceSensors::DeactivateMotionListener.

Deactivate orientation sensor
Deactivate the orientation sensor.

See parameters & details

There are no parameters to set for this action.

Technical note: this action internal type (in GDevelop JSON) is DeviceSensors::DeactivateOrientationListener.

Conditions

Compare the value of acceleration on X-axis
Compare the value of acceleration on the X-axis (m/s²).

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::AccelerationX.

Compare the value of acceleration on Y-axis
Compare the value of acceleration on the Y-axis (m/s²).

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::AccelerationY.

Compare the value of acceleration on Z-axis
Compare the value of acceleration on the Z-axis (m/s²).

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::AccelerationZ.

Sensor active
The condition is true if the device motion sensor is currently active

See parameters & details

There are no parameters to set for this condition.

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::MotionSensorActive.

Compare the value of orientation alpha
Compare the value of orientation alpha. (Range: 0 to 360°)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::OrientationAlpha.

Compare the value of orientation beta
Compare the value of orientation beta. (Range: -180 to 180°)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::OrientationBeta.

Compare the value of orientation gamma
Compare the value of orientation gamma. (Range: -90 to 90°)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::OrientationGamma.

Sensor active
The condition is true if the device orientation sensor is currently active

See parameters & details

There are no parameters to set for this condition.

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::OrientationSensorActive.

Compare the value of rotation alpha
Compare the value of rotation alpha. (Note: few devices support this sensor)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::RotationAlpha.

Compare the value of rotation beta
Compare the value of rotation beta. (Note: few devices support this sensor)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::RotationBeta.

Compare the value of rotation gamma
Compare the value of rotation gamma. (Note: few devices support this sensor)

See parameters & details
  • Parameter 0: 🟰 Relational operator
  • Parameter 1 (🔢 Number): Value (m/s²)

Technical note: this condition internal type (in GDevelop JSON) is DeviceSensors::RotationGamma.

Expressions

Expression Description
DeviceSensors::AccelerationX() Get the devices acceleration on the X-axis (m/s²)
DeviceSensors::AccelerationY() Get the devices acceleration on the Y-axis (m/s²)
DeviceSensors::AccelerationZ() Get the devices acceleration on the Z-axis (m/s²)
DeviceSensors::OrientationAbsolute() Get if the devices orientation is absolute and not relative
DeviceSensors::OrientationAlpha() Get the devices orientation Alpha (compass)
DeviceSensors::OrientationBeta() Get the devices orientation Beta
DeviceSensors::OrientationGamma() Get the devices orientation Gamma value
DeviceSensors::RotationAlpha() Get the devices rotation Alpha
DeviceSensors::RotationBeta() Get the devices rotation Beta
DeviceSensors::RotationGamma() Get the devices rotation Gamma

The Device sensors extension is always installed in all GDevelop projects: there is no need to add it from the Project Manager.

This page is an auto-generated reference page about the Device sensors feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.