Skip to content

Device sensors

GDevelop has the ability to access the sensors that can be found on most mobile devices.

Orientation sensor

The orientation sensor combines the gyroscope, accelerometer and compass in one sensor. This allows you to control game objects by slightly rotating the mobile device in your hands. You can access the location data via the "alpha", "beta" and "gamma" values which are explained in the next section.

Axes explained

Alpha

The "alpha" value corresponds to the axis which points to the sky when your phone is lying on a table with its display pointing upwards. You can easily create a compass using the "alpha" rotation value.

Range: 0 to 360 degrees

Beta

The "beta" axis runs through the narrow edge of the phone.

Range: -180 to 180 degrees

Gamma

The "gamma" axis runs through the longer edge of the phone.

Range: -90 to 90 degrees

Conditions

Sensor Active

This condition checks whether the sensor has been activated yet and is delivering location data.

Orientation Alpha

This condition lets you compare the value of alpha to a number or variable.

Orientation Beta

This condition lets you compare the value of beta to a number or variable.

Orientation Gamma

This condition lets you compare the value of gamma to a number or variable.

Actions

Activate Orientation Sensor

This action activates the orientation sensor so that it begins to deliver alpha, beta and gamma values. Turn this off when you no longer need the sensor to save some processing time and phone battery.

Deactivate Orientation Sensor

This action deactivates the orientation sensor so that it stops delivering alpha, beta and gamma values.

Expressions

Is Absolute

This value indicates that the orientation data is in absolute values. In reference to the Earth's coordinates (value 1) or using an arbitrary frame, is determined by the device (value 0).

Alpha Value

The "alpha" rotation.

Beta Value

The "beta" rotation.

Gamma Value

The "gamma" rotation.

Motion sensor

In contrast to the orientation sensor which returns absolute values, the motion sensor delivers relative ones. This sensor only returns values while the device is moving. If you hold it still, no matter its orientation, the sensor will return 0. You can access the motion data along an axis via the "x", "y", "z" values and the rotation data around an axis via "alpha", "beta" and "gamma" which are explained in the next section.

Note

The motion sensor rotation values (alpha, beta, gamma) are currently badly supported on mobile devices. It would currently be better to calculate the value from the orientation data

Axes explained

Acceleration X

This value shows the acceleration along the x-axis. If you move your device along the longer edge, the x value will increase.

Acceleration Y

This value shows the acceleration along the y-axis. If you move your device along the smaller edge, the y value will increase.

Acceleration Z

This value shows the acceleration along the z-axis. If you move your device up or down, the z value will increase.

Rotation alpha

This value shows the acceleration around the z-axis. If you turn your device with the display pointing up, the alpha value will increase.

Rotation beta

This value shows the acceleration around the x-axis. If you hold your device in landscape mode with a hand on each side, you can turn your device around the x-axis and the beta value will increase.

Rotation gamma

This value shows the acceleration around the y-axis. If you hold your device in portrait mode with a hand on each side, you can turn your device around the y-axis and the beta value will increase.

Conditions

Sensor Active

This condition checks whether the sensor has been activated yet and is delivering location data.

Acceleration X

This condition lets you compare the value of x-acceleration to a number or variable. (m/s²)

Acceleration Y

This condition lets you compare the value of y-acceleration to a number or variable. (m/s²)

Acceleration Z

This condition lets you compare the value of z-acceleration to a number or variable. (m/s²)

Motion Alpha

This condition lets you compare the value of alpha to a number or variable. (m/s²)

Motion Beta

This condition lets you compare the value of beta to a number or variable. (m/s²)

Motion Gamma

This condition lets you compare the value of gamma to a number or variable. (m/s²)

Actions

Activate Motion Sensor

This action activates the motion sensor so that it begins to deliver x, y, z, alpha, beta and gamma values. Turn this off again when you no longer need the sensor to save some processing time and phone battery.

Deactivate Motion Sensor

This action deactivates the motion sensor so that it stops delivering x, y, z, alpha, beta and gamma values.

Expressions

Acceleration X Value

The "x" acceleration. (m/s²)

Acceleration Y Value

The "y" acceleration. (m/s²)

Acceleration Z Value

The "z" acceleration. (m/s²)

Alpha Value

The "alpha" rotation. (m/s²)

Beta Value

The "beta" rotation. (m/s²)

Gamma Value

The "gamma" rotation. (m/s²)