Broadcast Receivers para escuchar eventos del sistema en Android

Curso de Android: Integración de APIs nativas

Contenido del curso

Introducción a la Integración Nativa en Android

Google Maps SDK

Servicios de Localización

Integración Maps con Localización

Manejo de permisos

Integración cámara

Servicios en Android

Transmisiones en Android (Broadcast)

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:009:40

Broadcast Receivers para escuchar eventos del sistema en Android

Curso de Android: Integración de APIs nativas

Clase 32 de 33

Clase 32 / 33

Recursos

Escuchar y responder a eventos específicos es fundamental en aplicaciones Android. Los broadcast receivers son precisamente los encargados de escuchar eventos emitidos por el sistema operativo o eventos personalizados creados por la aplicación. Eventos comunes incluyen conexiones USB o cambios en el modo avión.

¿qué es un Broadcast Receiver?

Un broadcast receiver es un componente esencial para reaccionar a eventos específicos que se generan dentro o fuera de una aplicación. Pueden escuchar desde eventos del propio sistema operativo hasta eventos personalizados definidos por el desarrollador.

¿Cómo crear un Broadcast Receiver personalizado?

Crear un receptor propio requiere definir una clase que extienda de BroadcastReceiver e implemente el método onReceive:

class StopReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        val action = intent?.action ?: return
        if (action != ACTION_STOP) return
        // Lógica para detener la actividad o servicio pertinente.
    }

    companion object {
        const val ACTION_STOP = "trackit.action.stoptracking"
    }
}

Para manejar eventos con eficacia, es importante validar que el mensaje recibido no sea nulo y coincida con la acción esperada.

¿Qué operaciones se ejecutan al recibir un evento?

Al recibir el evento de detención, es necesario realizar una serie de tareas que involucran:

Establecer el estado de tracking como desactivado.
Detener la observación de la localización.
Limpiar recursos, como fotografías almacenadas.

Estas tareas son realizadas habitualmente sobre un scope de coroutine, asegurando la finalización de cada proceso:

applicationScope.launch {
    locationTracker.setIsTracking(false)
    locationTracker.stopObservingLocation()
    photoHandler.clearPhotos().join()
}

Tras esto, se envía un comando para detener el servicio asociado:

val serviceIntent = Intent(context, TrackingService::class.java).apply {
    action = TrackingService.ACTION_STOP
}
if (TrackingService.isActive.value) {
    context?.startService(serviceIntent)
}

¿Cómo registrar un Broadcast Receiver en Android?

Todos los receptores deben registrarse correctamente desde el archivo Manifest de la aplicación:

<receiver android:name=".StopReceiver" android:exported="false"/>

El parámetro exported indica si otras aplicaciones podrían activar este receptor; habitualmente, se establece en false.

¿De qué forma interactúa un Broadcast Receiver con notificaciones?

El uso de un pending intent permite agregar acciones a las notificaciones, enviando mensajes a nuestro receptor para ejecutar eventos específicos aunque la aplicación esté cerrada:

val stopIntent = Intent(applicationContext, StopReceiver::class.java).apply {
    action = StopReceiver.ACTION_STOP
}

val stopPendingIntent = PendingIntent.getBroadcast(applicationContext, 0, stopIntent, PendingIntent.FLAG_IMMUTABLE)

Al incorporar esta intención en la notificación, se vincula la interacción del usuario directamente al receptor personalizado:

notificationBuilder.addAction(R.drawable.ic_launcher_foreground, applicationContext.getString(R.string.stop), stopPendingIntent)

Al pulsar esta acción en la notificación, la aplicación se activa y ejecuta las tareas correspondientes establecidas en el receptor de eventos.

¿Has utilizado antes broadcast receivers para manejar eventos específicos en tus aplicaciones? Comparte tu experiencia o dudas en los comentarios.

Resumen

¿qué es un Broadcast Receiver?

¿Cómo crear un Broadcast Receiver personalizado?

Crear un receptor propio requiere definir una clase que extienda de BroadcastReceiver e implemente el método onReceive:

class StopReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        val action = intent?.action ?: return
        if (action != ACTION_STOP) return
        // Lógica para detener la actividad o servicio pertinente.
    }

    companion object {
        const val ACTION_STOP = "trackit.action.stoptracking"
    }
}

Para manejar eventos con eficacia, es importante validar que el mensaje recibido no sea nulo y coincida con la acción esperada.

¿Qué operaciones se ejecutan al recibir un evento?

Al recibir el evento de detención, es necesario realizar una serie de tareas que involucran:

Establecer el estado de tracking como desactivado.
Detener la observación de la localización.
Limpiar recursos, como fotografías almacenadas.

Estas tareas son realizadas habitualmente sobre un scope de coroutine, asegurando la finalización de cada proceso:

applicationScope.launch {
    locationTracker.setIsTracking(false)
    locationTracker.stopObservingLocation()
    photoHandler.clearPhotos().join()
}

Tras esto, se envía un comando para detener el servicio asociado:

val serviceIntent = Intent(context, TrackingService::class.java).apply {
    action = TrackingService.ACTION_STOP
}
if (TrackingService.isActive.value) {
    context?.startService(serviceIntent)
}

¿Cómo registrar un Broadcast Receiver en Android?

Todos los receptores deben registrarse correctamente desde el archivo Manifest de la aplicación:

<receiver android:name=".StopReceiver" android:exported="false"/>

El parámetro exported indica si otras aplicaciones podrían activar este receptor; habitualmente, se establece en false.

¿De qué forma interactúa un Broadcast Receiver con notificaciones?

El uso de un pending intent permite agregar acciones a las notificaciones, enviando mensajes a nuestro receptor para ejecutar eventos específicos aunque la aplicación esté cerrada:

val stopIntent = Intent(applicationContext, StopReceiver::class.java).apply {
    action = StopReceiver.ACTION_STOP
}

val stopPendingIntent = PendingIntent.getBroadcast(applicationContext, 0, stopIntent, PendingIntent.FLAG_IMMUTABLE)

Al incorporar esta intención en la notificación, se vincula la interacción del usuario directamente al receptor personalizado:

notificationBuilder.addAction(R.drawable.ic_launcher_foreground, applicationContext.getString(R.string.stop), stopPendingIntent)

Al pulsar esta acción en la notificación, la aplicación se activa y ejecuta las tareas correspondientes establecidas en el receptor de eventos.

¿Has utilizado antes broadcast receivers para manejar eventos específicos en tus aplicaciones? Comparte tu experiencia o dudas en los comentarios.

Introducción a la Integración Nativa en Android

API nativas de Android con Kotlin y Compose

Configuración inicial de proyecto Android con Kotlin DSL y Hilt

Google Maps SDK

Configuración de API key de Google Maps para Android

Creación de marcadores personalizados en Google Maps con Compose

Cómo dibujar polilíneas en mapas con Jetpack Compose

Centrado automático de mapas con Camera Update Factory

Servicios de Localización

Kotlin Flows para medir tiempo en Android

Simulación de ubicación GPS en emulador y dispositivo Android

Modelos de localización propios con Clean Architecture

Callbacks de Android convertidos en Flows

Inyección de dependencias para observar localización en Android

LocationTracker con StateFlow para rastreo en Android

State Flows para controlar localización y tiempo en Kotlin

Configuración y pruebas de Location Tracker en Android

Integración Maps con Localización

Integración de ubicación actual en mapas interactivos

Creación de polilíneas con datos reales en mapas de Android

Integración de intents y estados en pantalla mapa con Compose

TrackingMapViewModel con Hilt y StateFlow

Manejo de permisos

Permisos de Android en tiempo de ejecución

Creación de diálogos de permisos reutilizables en Android

Gestión de permisos de localización y notificaciones en Android

Implementación de solicitud de permisos con LaunchedEffect en Compose

Integración cámara

Cómo guardar fotos en Android con PhotoHandler

Conversión de Bitmaps a Byte Arrays con Extension Functions

CameraViewModel con Hilt y StateFlow

Configuración de métodos del ViewModel para gestión de cámara

Integración de CameraX con Jetpack Compose en Android

Creación de pantalla de previsualización de fotos con Jetpack Compose

Galería de fotos en marcadores del mapa

Servicios en Android

Servicios en segundo plano en Android

Configuración de foreground services y notificaciones en Android

Transmisiones en Android (Broadcast)

Broadcast Receivers para escuchar eventos del sistema en Android

Prueba completa de aplicación Android con cámara y localización

Broadcast Receivers para escuchar eventos del sistema en Android