This is a copy of the Java documentation for libGDX. It is not finished being ported.

Some Android devices have a gyroscope sensor that provides information about the rate of rotation in rad/s around a device’s x, y, and z axis.

NOTE: The gyroscope is currently not available on iOS devices since there is no implementation in the RoboVM - backend yet.

You must first enable the gyroscope in your android config. (Typically in your AndroidLauncher.java file)

config = new AndroidApplicationConfiguration();
config.useGyroscope = true;  //default is false

//you may want to switch off sensors that are on by default if they are no longer needed.
config.useAccelerometer = false;
config.useCompass = false;

Querying whether the gyroscope is available works as follows:

boolean gyroscopeAvail = Gdx.input.isPeripheralAvailable(Peripheral.Gyroscope);

Once you determined that the gyroscope is indeed available, you can poll its state:


if(gyroscopeAvail){
	float gyroX = Gdx.input.getGyroscopeX();
	float gyroY = Gdx.input.getGyroscopeY();
	float gyroZ = Gdx.input.getGyroscopeZ();
} 


Copyright © 2024 SharpGDX.