Developpez.com

Plus de 2 000 forums
et jusqu'à 5 000 nouveaux messages par jour

BroadCast Receiver sous Android

Image non disponible

Ce tutoriel va aborder les broadCast Receiver sous Android. Nous allons commencer par expliquer le principe des broadcast receiver, puis nous allons faire un petit exemple d'un broadcast receiver qui reçoit les messages du téléphone.
2 commentaires Donner une note à l'article (4.5)

Article lu   fois.

Les deux auteurs

Profil Pro

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

I. Qu'est ce qu'un BroadCast Receiver ?

Pour pouvoir recevoir des intents, Android vous permet de créer une classe qui implémente BroadcastReceiver. Ces objets sont conçus pour recevoir des intents (intentions) et appliquer des comportements spécifiques à votre code.

L'interface BroadcastReceiver ne possède qu'une seule méthode onReceive() que votre classe devra implémenter.

Un BroadcastReceiver ne vit que le temps de traiter votre onReceive(). L'instance peut être supprimée par le Garbage Collector.

Les receivers sont limités : ils ne peuvent pas ouvrir de boîte de dialogue par exemple. Le système Android envoie l'intention à tous les BroadCast Receiver abonnés par ordre de priorité (priorité de votre BroadCast dans le fichier AndroidManifest.xml).

Si un BroadCast souhaite interrompre la réception du Broadcast à ceux d'un niveau inférieure de priorité, il faut utiliser la méthode abortBroadcast().

II. Mon premier BroadCast Receiver

On va créer un nouveau projet qu'on nommera "MyBroadCastReceiver", avec les informations suivantes :

  • Version du SDK : 2.1 ;
  • Application Name : My First Broadcast ;
  • Package Name : com.tuto.android ;
  • Min SDK version : 7 ;
  • décocher la cache : Create Activity.

Nous allons créer une classe "SMSReceiver", qui hérite de "BroadcastReceiver". Il vous demandera de rajouter les méthodes à implémenter (OnReceive dans notre cas).

Votre classe doit ressembler à ça :

 
Sélectionnez

package com.tuto.android;
 
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
 
public class SMSReceiver extends BroadcastReceiver
{
 
 @Override
 public void onReceive(Context arg0, Intent arg1)
 {
 // TODO Auto-generated method stub
 
 }
 
}

Donc pour recevoir les messages vous devez définir la permission ainsi que le Broadcast Receiver dans votre AndroidManifest.xml.

  • Lecture et réception des SMS
 
Sélectionnez

<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_SMS" />
  • Déclaration du Broadcast Receiver
 
Sélectionnez

<receiver class="com.tuto.android.SMSReceiver"
    android:name="com.tuto.android.SMSReceiver">
    <intent-filter android:priority="100">
        <action android:name="android.provider.Telephony.SMS_RECEIVED" />
    </intent-filter>
</receiver>

Donc on déclare notre receiver, on peut lui définir une priorité dans la réception d'évènement(s) (100 dans notre exemple) et dans la partie intent filtres, on définit que notre receiver est appelé quand le téléphone reçoit un SMS.

Voilà ce que devrait donner votre AndroidManifest.xml.

 
Sélectionnez

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.tuto.android" android:versionCode="1" android:versionName="1.0">
    <uses-sdk android:minSdkVersion="7" />
 
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <receiver class="com.tuto.android.SMSReceiver"
            android:name="com.tuto.android.SMSReceiver">
            <intent-filter android:priority="100">
                <action android:name="android.provider.Telephony.SMS_RECEIVED" />
            </intent-filter>
        </receiver>
    </application>
 
    <uses-permission android:name="android.permission.RECEIVE_SMS" />
    <uses-permission android:name="android.permission.READ_SMS" />
</manifest>

Revenons à notre classe, nous allons gérer la réception de notre évènement, donc dans la méthode OnReceive.

 
Sélectionnez

private final String                ACTION_RECEIVE_SMS = "android.provider.Telephony.SMS_RECEIVED";
 
 @Override
 public void onReceive(Context context, Intent intent)
 {
 	if (intent.getAction().equals(ACTION_RECEIVE_SMS))
 	{
	}
}

On déclare une chaîne de caractères qui représente l'action correspondant à l'évènement que l'on va recevoir et on teste si l'évènement reçu correspond bien à celui-là.

Maintenant mettons en place la lecture du dernier message reçu et son affichage sous forme de toast.

 
Sélectionnez

package com.tuto.android;
 
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.telephony.SmsMessage;
import android.widget.Toast;
 
public class SMSReceiver extends BroadcastReceiver
{
	 private final String   ACTION_RECEIVE_SMS  = "android.provider.Telephony.SMS_RECEIVED";
	 
	 @Override
	 public void onReceive(Context context, Intent intent)
	 {
		 if (intent.getAction().equals(ACTION_RECEIVE_SMS))
		 {
			 Bundle bundle = intent.getExtras();
			 if (bundle != null)
			 {
				 Object[] pdus = (Object[]) bundle.get("pdus");
				 
				 final SmsMessage[] messages = new SmsMessage[pdus.length];
				 for (int i = 0; i < pdus.length; i++)  {  messages[i] = SmsMessage.createFromPdu((byte[]) pdus[i]);  }  if (messages.length > -1)
				 {
					 final String messageBody = messages[0].getMessageBody();
					 final String phoneNumber = messages[0].getDisplayOriginatingAddress();
					 
					 Toast.makeText(context, "Expediteur : " + phoneNumber, Toast.LENGTH_LONG).show();
					 Toast.makeText(context, "Message : " + messageBody, Toast.LENGTH_LONG).show();
				 
				 }
			 }
		}
	}
}
  • On récupère le message grâce aux extras de l'intent.
  • Puis on récupère dans le bundle, l'extra correspondant à l'identifiant "pdus".
  • On récupère et on parcourt tous les messages pour obtenir le dernier.
  • Puis on récupère les informations souhaitées dans le dernier message.

III. Résultat

Maintenant il suffit de lancer le projet dans votre émulateur préféré et puis à l'aide du contrôle de l'émulateur vous pouvez simuler l'envoi d'un message. Vous devriez obtenir le résultat suivant :

Image non disponible

IV. Conclusion

En espérant que ce tutoriel vous aura aidé à mieux comprendre comment fonctionnent les broadcast receiver sous Android.

V. Remerciements

Je tiens à remercier tout particulièrement Feanorin qui a mis ce tutoriel au format Developpez.com.
Merci également à jacques_jean ainsi qu'à jpcheck d'avoir pris le temps de le relire et de le corriger.

VI. Liens

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2011 developpez Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.