Accéléromètre

Les accéléromètres permettent de connaître les accélérations (ici linéaires) de l'appareil suivant 3 axes orthogonaux x, y et z.

Explications

Dans vos programmes, pour être informé des accélérations, vous utiliserez un listener. Pour cela, vous implémenterez SensorEventListener dans votre classe.

Deux méthodes seront alors mises à votre disposition:

public void onSensorChanged(SensorEvent event); Déclenchée lorsqu'un évènement arrive sur l'un des accéléromètres.
public void onAccuracyChanged(Sensor sensor, int accuracy); Déclenchée lorsque la précision de l'accéléromètre change.

Pour pouvoir utiliser les informations de l'accéléromètre, vous aurez besoin de créer une pseudo instance SensorManager en passant par une méthode de l'interface context de la manière suivante:

SensorManager manager = (SensorManager)context.getSystemService(Context.SENSOR_SERVICE);

Vous pourrez dès lors vérifier l'existance de l'accéléromètre en demandant:

manager.getSensorList(Sensor.TYPE_ACCELEROMETER).size(). Si la valeur retournée est > 0, alors c'est bon !

Maintenant que vous savez qu'il existe, vous allez pouvoir récupérer celui-ci:

Sensor accelerometre = manager.getSensorList(Sensor.TYPE_ACCELEROMETER).get(0);

Pour enfin, positionner votre listener dessus:

boolean success = manager.registerListener(listener, accelerometre, SensorManager.SENSOR_DELAY_xxx);

Il sera judicieux de positionner le listener lors du onResume(). En complément, de libérer le listener lors du onPause() comme ceci: manager.unregisterListener(listener);

Avec listener, une classe SensorEventListener qui recevra les informations

accelerometre, votre accelerometre déterminé via le getSensorList

Et SensorManager.SENSOR_DELAY_xxx, la périodicité des appels au listener, voici les valeurs possibles:

Maintenant, deux méthodes pourront être déclenchées dans le listener et seront donc à définir:

La première n'est pas vraiment intéressante

public void onAccuracyChanged(Sensor sensor, int accuracy) {
}

Mais la seconde bien plus, car c'est elle qui va vous indiquer les accélérations

public void onSensorChanged(SensorEvent event) {
}

Avec SensorEvent.values qui est un tableau de 3 éléments (1 par axe soit value[SensorManager.DATA_X] pour l'axe X, value[SensorManager.DATA_Y] pour l'axe Y et value[SensorManager.DATA_Z] pour l'axe Z !

Exemple de code

Très simple, ce code va afficher les valeurs x, y et z à l'écran.

Un fichier AccelerActivity.java

package fr.free.supertos; import android.app.Activity; import android.content.Context; import android.hardware.Sensor; import android.hardware.SensorEvent; import android.hardware.SensorEventListener; import android.hardware.SensorManager; import android.os.Bundle; import android.widget.TextView; public class AccelerActivity extends Activity { SensorManager manager; Sensor accelerometre; private TextView textviewx; private TextView textviewy; private TextView textviewz; private TextView textviewa; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); manager = (SensorManager) getSystemService(Context.SENSOR_SERVICE); textviewa=(TextView)findViewById(R.id.textView4); textviewx=(TextView)findViewById(R.id.textView1); textviewy=(TextView)findViewById(R.id.textView2); textviewz=(TextView)findViewById(R.id.textView3); // Testons la présence de l'accélérateur if (manager.getSensorList(Sensor.TYPE_ACCELEROMETER).size() > 0) { // Il existe, donc mémorisons le, car nous positionnerons un listener dessus // Note, il peut exister plusieurs types de sensor, nous, celui qui nous intéresse est l'accéléromètre accelerometre = manager.getSensorList(Sensor.TYPE_ACCELEROMETER).get(0); textviewa.setText("Accélérateur présent..."); } else textviewa.setText("Il n'y a pas d'accélérateur présent sur cet appareil !"); } // Sur le resume, installation d'un listener sur l'accelerometre public void onResume () { super.onResume(); if (manager.getSensorList(Sensor.TYPE_ACCELEROMETER).size() > 0) { manager.registerListener(mySensorListener, accelerometre, SensorManager.SENSOR_DELAY_GAME); } } // Si notre activité est en pause, défaire le listener qui ne sert plus à rien... protected void onPause() { super.onPause(); manager.unregisterListener(mySensorListener); } // Classe interne pour gérer le listener SensorEventListener mySensorListener = new SensorEventListener() { @Override public void onAccuracyChanged(Sensor arg0, int arg1) { } @Override // Si l'accélérateur change, alors afficher les nouvelles valeurs... public void onSensorChanged(SensorEvent event) { // Autre qu'accéléromètre, ne rien faire if (event.sensor.getType() != Sensor.TYPE_ACCELEROMETER) return; float mSensorX = event.values[SensorManager.DATA_X]; float mSensorY = event.values[SensorManager.DATA_Y]; float mSensorZ = event.values[SensorManager.DATA_Z]; textviewx.setText("X:" + String.valueOf(mSensorX)); textviewy.setText("Y:" + String.valueOf(mSensorY)); textviewz.setText("Z:" + String.valueOf(mSensorZ)); } }; }

Plutôt que de recourir à accelerometre = manager.getSensorList(Sensor.TYPE_ACCELEROMETER).get(0) qui est peut-être hazardeux pour récupérer un accéléromètre, on peut utiliser accelerometre = manager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER) pour trouver l'accélérateur par défaut.

Et son main.xml

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <TextView android:id="@+id/textView4" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Information" android:textAppearance="?android:attr/textAppearanceLarge" /> <TextView android:id="@+id/textView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="X:" android:textAppearance="?android:attr/textAppearanceLarge" /> <TextView android:id="@+id/textView2" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Y:" android:textAppearance="?android:attr/textAppearanceLarge" /> <TextView android:id="@+id/textView3" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Z:" android:textAppearance="?android:attr/textAppearanceLarge" /> </LinearLayout>