SoCode

1. Introducción

Como comenté el otro día la clase BroadcastReceiver es un componente Android que nos permite registrarnos para recivir eventos del sistema o eventos de ciertas aplicaciones. Los BroadcastReceiver que estén registrados para un cierto evento serán notificados por el runtime de Android cuando esto ocurra.

Para el ejemplo que propuse el otro día, el del nivel de la batería, tenemos que registrar nuestro BroadcastReceiver para el evento ACTION_BATTERY_LOW.

2. BroadcastReceiver

Los eventos que se producen, ya sean eventos del sistema o de aplicaciones, están representados mediante Intents. Estos son enviados por el sistema para que los BroadcastReceiver registrados para ese evento los recivan.

El Intent es recivido por el BroadcastReceiver en la llamada al método onReceive().

Vale, y ¿cómo registramos ahora el BroadcastReceiver? Pues existen dos maneras:

Estáticamente, en el AndroidManifest.xml

Dinámicamente, es decir, en tiempo de ejecución mediante el método registerReceiver()

2.1. Registración estática

Esta manera de registro se realiza en el AndroidManifest.xml. Con la etiqueta <receiver> le indicaremos a la aplicación el nombre del BroadcastReceiver y una serie de atributos opcionales

<receiver android:enabled=["true" | "false"] android:exported=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:process="string" > </receiver>

Para consultar el uso de estos atributos podeis consultar AndroidManifestReceiver.

Dentro de la etiqueta debemos especificar también el Intent filter para saber el evento que va a escuchar el BroadcastReceiver. Utilizaremos la etiquieta <intent-filter>.

Con este tipo de registración los BroadcastReceiver son registrados en el momento de arranque del sistema o cuando se añade la aplicación en tiempo de ejecución.

2.1.1. Aplicación

Vamos a dejar un poco la teoría a parte y ponernos a hacer un sencillo ejemplo para aplicar lo aprendido. Para explicar la registración estática de los BroadcastReceiver vamos a crear dos apps.

Sender. Esta aplicación será la responsable de desatar un evento que nosotros vamos a crear. Dispondrá de un botón para realizar la emisión del evento.

Receiver. Esta se registrará para recivir el evento que desencadena el Sender. Cuando recive el evento muestra una actividad en la que se muestra el número de veces que se ha recivido el evento.

Con estas dos apps creo que es más sencillo entender los BroadcastReceiver. Así por un lado tenemos la aplicación que envía los eventos, la cual puede sustituir al controlador de la batería en nuestro ejemplo inicial, y por otro lado el receptor del evento, el cual manejará el evento recivido para reaccionar a su antojo.

Empecemos por el Sender. En nuestro layout creamos un botón centrado en el centro, tal que así:

<Button android:id="@+id/buttonSender" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_centerVertical="true" android:text="@string/button_send_event" />

Ahora pasamos a programar un poco. Vamos a la clase principal en la que buscaremos el botón a través del id y luego le añadimos el evento de click para que cuando el usuario pulse el botón envie nuestro evento al Receiver. El evento está representado con un Intent al que le vamos a dar el siguiente nombre.

final static String SEND_INTENT = "ble180.BroadcastReceiver.event";

Pues ya tenemos todo lo necesario, ahora simplemente tenemos que crear un Intent y enviarlo con el método sendBroadcast().

import android.os.Bundle; import android.app.Activity; import android.content.Intent; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; public class MainActivity extends Activity { final static String SEND_INTENT = "ble180.BroadcastReceiver.event"; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); final Button buttonSender = (Button) findViewById(R.id.buttonSender); buttonSender.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // Send the intent that the other app received sendBroadcast(new Intent(SEND_INTENT)); } }); } }

Pues pasemos ahora al Receiver. Lo primero que tenemos que hacer es registrar el Receiver en nuestro AndroidManifest.xml para la recepción de nuestro evento ble180.BroadcastReceiver.event.

<receiver android:name=".Receiver" android:exported="true"> <intent-filter> <action android:name="ble180.BroadcastReceiver.event"/> </intent-filter> </receiver>

Al hacer esto nos saldrá un Warning indicando que al ser el Receiver exported cualquier aplicación podrá enviar eventos los cuales sean recividos por nuestra app. Para ello vamos a crear un permiso el cual se le daremos al Receiver. Así solo los Sender que tengan este permiso en su AndroidManifest.xml podrán enviar el evento ble180.BroadcastReceiver.event y que sea recivido por la app. Entonces nuestro AndroidManifest.xml quedará así:

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="ble180.BroadcastReceiver.BroadcastReceiverRec" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="19" /> <permission android:name="ble180.BroadcastReceiver.START_RECEIVER"/> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="ble180.BroadcastReceiver.BroadcastReceiverRec.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <receiver android:name=".Receiver" android:exported="true" android:permission="ble180.BroadcastReceiver.START_RECEIVER"> <intent-filter> <action android:name="ble180.BroadcastReceiver.event"/> </intent-filter> </receiver> </application> </manifest>

Como hemos añadido el permiso ahora debemos añadirselo también al AndroidManifest.xml del Sender. Simplemente será añadir la linea <uses-permission android:name="ble180.BroadcastReceiver.START_RECEIVER"/>

Pues pasemos al código del Receiver. A parte de la clase principal vamos a crear una para implementar el Receiver que extienda de BroadcasReceiver. Esta clase tendrá el método onReceive() que será desencadenado cuando reciva el evento emitido por el Sender. Aquí es donde se realizan las operaciones que deseemos que se desencadenen con la recepción del evento.

Como dije antes, cuando reciva el evento queremos que inicie una actividad con el número de veces que se ha recivido el evento. Para ello creamos un Intent con la clase principal de nuestra aplicación, en este caso MainActivity.class. A este Intent le ponemos información extra, en este caso el número de veces que se ha recivido el evento, y lo lanzamos.

import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; public class Receiver extends BroadcastReceiver{ // Times that we have received an event static int TIMES_RECEIVED = 0; @Override public void onReceive(Context context, Intent intent) { TIMES_RECEIVED++; // New intent with the main class Intent intentRec = new Intent(context, MainActivity.class); intentRec.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // Put the times for the MainActivity can show the times // that we have received an event intentRec.putExtra("times", TIMES_RECEIVED); // Start the activity context.startActivity(intentRec); } }

Por último nos queda nuestra clase principal la MainActivity. Es la clase más sencilla de todas, solo obtenemos la información extra del Intent lanzado en la clase anterior para mostrarla por pantalla en un TextView que contiene la vista pricipal de la aplicación.

import android.os.Bundle; import android.widget.TextView; import android.app.Activity; import android.content.Intent; public class MainActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); int times = 0; Intent intent = getIntent(); Integer extraTimes = intent.getIntExtra("times", 0); // If there are times, we keep in times variable to show it if(extraTimes != null){ times = extraTimes; } // Change the TextView message TextView textViewReceiver = (TextView) findViewById(R.id.textViewReceiver); textViewReceiver.setText("Received Event num " + times + " by Receiver"); } }

Ahora es turno de vosotros probarlo. Simplemente teneis que instalar las dos apps en vuestro smartphone o en el simulador. Una vez que las dos estén instaladas, abrís el Sender y le dais al botón de enviar y seguidamente vereis como se abre una nueva actividad con un mensaje y el número de veces que se ha recivido el evento.

Github:Enlace al código

Como dice el título, el siguiente tutorial de android tratará sobre los BroadcastReceiver. Probablemente será un tutorial por partes ya que es mucho lo que tratar.

Para los que no sepan de lo que va hago un pequeño avance a ver si así os engancho. Los BroadcastReceiver los proporciona Android para poder registrar eventos y que las aplicaciones puedan reaccionar a estos. Un ejemplo sencillo sería por ejemplo el de una aplicación que desea informar a otra de un cierto evento para que la aplicación que lo reciba reaccione. Algunos diréis, ¿y esto pa' qué? Estoy seguro de que alguna vez, la batería de vuestro teléfono se encontraba bajo mínimos y cuando habéis querido sacar una foto os ha salido un mensaje que dice algo del estilo de: "No tienes suficiente batería para realizar una fotografía". Esto se debe a que la aplicación Cámara de vuestro smartphone escucha los eventos que el control de batería de Android emite, y cuando recive un evento de batería baja actua para no gastar batería en cosas que puedan ser innecesarias.

Bueno pues después de hacerme tumblr hace un tiempo ya he decido empezar e ir poniendo un poco lo que sé para ayudar a los que lo necesitan y quieren aprender de cosas relacionadas con la programación.

Android dispone de un servicio de notificaciones para poder avisar al usuario de ciertos eventos ocurridos en el sistema que le sean de interés. Cualquier aplicación que creemos puede usar este servicio y mantener así informado al usuario. Distinguimos dos tipos de notificaciones, las que no tienen interacción con el usuario y sirven de simple aviso, Toast, y en las que el usuario puede interactuar con ellas y realizar acciones, Notification.

1. Toast

Como he dicho anteriormente, los Toast es un simple mensaje pop-up que aparece en la pantalla durante unos segundos. Desaparece de forma automática y el usuario no puede interactuar con ella por mucho que intente seleccionarla o hacer que desaparezca antes del tiempo de aparición. Como son tan simples no necesitamos mucho para crearlos.

Toast.makeText(context, text, duration)

context: será el contexto en el que queremos crearla, ej: getApplicationContext()

text: ya puede ser el ID de un string resource o bien el string que deseemos

duration: Toast.LENGTH_SHORT o Toast.LENGTH_LONG

Por último para mostrarlas simplemente tenemos que hacer .show() sobre el Toast. Como vemos no tiene mucho. Podemos complicarlo un poco y crear un Toast personalizado. Para ello tenemos que crear un layout que contenta la estructura que queramos que muestre nuestro Toast.

1.1. Toast Personalizado

Vamos a ver un ejemplo de esto y vamos a crear un LinearLayout que contenga una imagen (en este caso el icono por defecto de la aplicación) y un texto a su lado, que definiremos más adelante.

layout_toast.xml <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal" android:padding="10dp" android:background="#7777" > <ImageView android:id="@+id/toastImage" android:layout_width="44dp" android:layout_height="44dp" android:layout_marginRight="10dp" android:src="@drawable/ic_launcher"/> <TextView android:id="@+id/toastText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textColor="#FFF" android:text="" android:layout_gravity="center_vertical" android:textSize="16sp"/> </LinearLayout>

Ahora tenemos que indicarle al Toast que queremos usar esta vista en vez de la de por defecto. Como ya hemos creado la vista que queremos usar simplemente tenemos que inflarla e indicarselo.

//Creamos el Toast Toast toast = new Toast(getApplicationContext()); // Inflamos la vista en un LinearLayout LinearLayout layoutToast = (LinearLayout) getLayoutInflater() .inflate(R.layout.toast_view, null); // Como al TextView del layout_toast.xml le dimos ID lo obtenemos // para fijarle un texto TextView toastText = (TextView) layoutToast.findViewById(R.id.toastText); // Le fijamos el texto deseado toastText.setText("Esto es una notificacion"); // Le asignamos la duración, la vista y lo mostramos toast.setDuration(Toast.LENGTH_LONG); toast.setView(layoutToast); toast.show();

Y listo, ya tenemos nuestro Toast personalizado.

2. Notificaciones

Android proporciona el area de notificación para alertar a los usuarios de ciertos eventos. Se situa en la parte superior de la pantalla, donde se encuentra los iconos de la batería, la hora y demás. Si arrastramos hacia abajo este area nos aparecerá el buzón de notificaciones, donde podremos seleccionar una notificación o simplemente hacer que desaparezca.

Este tipo de notificaciones están representadas por la clase Notification. Se usa en conjunto con la clase NotificationManager, que se encarga de manegar los eventos que ocurran. Esta es un servicio del sistema por lo que podemos obtenerla así:

NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);

Como hemos dicho antes tenemos:

Area de notificación. Aquí la notificación está compuesta de un pequeño icono y de un mensaje de información (Ticker Text).

Buzón de notificaciones. En este caso tenemos, un icono representativo de la notificación, el titulo de esta y el detalle.

Sabiendo esto pasemos a crear la notificación. Gracias a la interfaz Notification.Builder podemos hacer esto de una manera fácil. Pero antes de todo esto tenemos que crear un PendingIntent, el cual responderá a la acción de la notificación.

Una vez tengamos el PendingIntent pasamos a construir nuestra notificación. Para ello necesitaremos el titulo de la notificación, el cuerpo de la notificación, el ticker text, el icono y el PendingIntent.

final int ID_NOTIFICATION = 0; Notification notification = new Notification.Builder(this) .setContentTittle(...) .setContentText(...) .setTicker(...) .setSmallIcon(...) .setContentIntent(pendingIntent) .setAutoCancel(true) .build(); NotificationManager notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE); notificationManager.notify(ID_NOTIFICATION, notification);

Siendo el ID_NOTIFICATION un identificador único dentro de nuestra aplicación para distinguir la notificación y el pendingIntent lo que queremos que ocurra cuando el usuario seleccione la notificación.

3. Práctica

Bueno, una vez comprendido los conceptos anteriores vamos a practicar un poco todo esto. Crearemos un nuevo proyecto android llamado Notifications. Va a ser una simple aplicación que dispone de un botón que cuando el usuario interacciona con él, nuestro terminal (o el simulador) recibe una notificación. Si abrimos la notificación aparecera una pantalla que pone que hemos recibido una notificacion y un Toast personalizado. Vamos a ello.

Lo primero es lo primero, y en este caso es la vista principal de nuestra aplicación. Como he dicho antes simplemente consta de un botón, por lo que no nos vamos a comer mucho la cabeza. Puede ser algo tal que así:

activity_main.xml <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:paddingBottom="@dimen/activity_vertical_margin" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" tools:context=".MainActivity"> <Button android:id="@+id/buttonSend" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_centerHorizontal="true" android:layout_centerVertical="true" android:text="@string/buttonSend" /> </RelativeLayout>

Ya que hemos empezado con las vistas sigamos con ellas. Nuestra notificación tiene que realizar una acción y para hacerlo sencillo que menos que abra una simple ventana nueva con un mensaje. Podría ser algo así:

notification_view.xml <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" > <TextView android:id="@+id/textView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Has recibido una notificación" android:textSize="22sp"> </TextView> </LinearLayout>

Bueno, demomento nada del otro mundo ¿no? Pues avancemos un poco más. Comenté que cuando se mostrase la vista que acabamos de crear también se iba a mostrar un Toast personalizado. Como recordareis los Toast personalizados necesitan una vista que será lo que se muestre al fin y al cabo. No nos vamos a complicar y va a ser un mensaje de texto junto con una imagen.

toast_view.xml <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="horizontal" android:padding="10dp" android:background="#7777" > <ImageView android:id="@+id/toastImage" android:layout_width="44dp" android:layout_height="44dp" android:layout_marginRight="10dp" android:src="@drawable/ic_launcher"/> <TextView android:id="@+id/toastText" android:layout_width="wrap_content" android:layout_height="wrap_content" android:textColor="#FFF" android:text="" android:layout_gravity="center_vertical" android:textSize="16sp"/> </LinearLayout>

Para no complicarnos, la imagen que mostramos es el icono de la aplicación que Eclipse crea por defecto. El texto como vemos está vacio debido a que lo editaremos mediante código.

Bueno pues demomento no más vistas por hoy. Vamos a menternos un poco en programación. Vamos a crear una clase nueva a la que vamos a llamar NotificationSubActivity.java, la cual se va a encargar de crear la vista que se mostrará al seleccionar la notificación y de mostrar el Toast personalizado. Será una cosa así:

import android.app.Activity; import android.os.Bundle; import android.widget.LinearLayout; import android.widget.TextView; import android.widget.Toast; public class NotificationSubActivity extends Activity { // Contador de veces que se ha recibido una notificacion private static int numVeces = 0; @Override protected void onCreate(Bundle savedInstanceState){ super.onCreate(savedInstanceState); setContentView(R.layout.notification_view); // Incrementamos el numero de veces en una unidad numVeces++; // Creamos el Toast a partir del contexto de la aplicacion Toast toast = new Toast(getApplicationContext()); // Inflamos la vista que habiamos creado anteriormente LinearLayout layoutToast = (LinearLayout) getLayoutInflater() .inflate(R.layout.toast_view, null); // Esta vista disponia de un TextView con un texto que habiamos // dejado vacio. TextView toastText = (TextView) layoutToast.findViewById(R.id.toastText); // Ahora se lo asignamos con un mensaje y el contador de // veces que se ha recibido una notificacion toastText.setText("Esta es la notifiacacion " + numVeces); // Asignamos la duracion, el layout y lo mostramos toast.setDuration(Toast.LENGTH_LONG); toast.setView(layoutToast); toast.show(); } }

En la clase principal crearemos el PendingIntent a partir de la clase que acabamos de crear para pasarselo al creador de la notificación, el Notification.Builder.

import android.os.Bundle; import android.app.Activity; import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; public class MainActivity extends Activity { private Intent intent; private PendingIntent pIntent; // Titulo, descripcion y ticker de la notificacion private CharSequence ticker = "Esto es la recepcion de una notificacion"; private CharSequence contentTitle = "Notificacion"; private CharSequence contentText = "Has sido notificado"; // Identificador unico de notificación en nuestra app private final int MY_ID_NOTIFICATION = 1; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Creamos previamente un intent para poder crear el PendingIntent intent = new Intent(getApplicationContext(), NotificationSubActivity.class); pIntent = PendingIntent.getActivity(getApplicationContext(), 0, intent, Intent.FLAG_ACTIVITY_NEW_TASK); // Buscamos el buton a partir del id que le asignamos final Button buttonNotification = (Button) findViewById(R.id.buttonSend); buttonNotification.setOnClickListener(new OnClickListener(){ // Cuando se pulse el botón se desatará la notificacion @Override public void onClick(View v){ Notification notification = new Notification.Builder( getApplicationContext()). setSmallIcon(android.R.drawable.stat_sys_warning). setTicker(ticker). setAutoCancel(true). setContentTitle(contentTitle). setContentText(contentText). setContentIntent(pIntent).build(); NotificationManager notificationManager = (NotificationManager) getSystemService( Context.NOTIFICATION_SERVICE); notificationManager.notify(MY_ID_NOTIFICATION, notification); } }); } }

Antes de que se me olvide, teneis que añadir al AndroidManifest.xml la actividad que se crea cuando el usuario selecciona la notificación, si no la aplicación no funcionará. En nuestro caso añadimos debajo de la actividad principal:

<activity android:name=".NotificationSubActivity" > </activity>

Como veis hemos creado una aplicación sencilla para practicar el uso de las notificaciones, ahora es cosa de vosotros poneros a trastear.

Github:Enlace al código