Cómo leer la batería de iOS con Swift

Curso de Integración Módulos Nativos iOS/Android para Flutter

Contenido del curso

Fundamentos de Flutter e IA

Introducción a TensorFlow Lite

Integración de modelos y clasificación de imágenes

Reconocimiento de voz con Whisper

MethodChannel

Acceso a sensores y cámara

Gestión de estado con BLoC

Reconocimiento de texto en imágenes

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0013:07

Cómo leer la batería de iOS con Swift

Curso de Integración Módulos Nativos iOS/Android para Flutter

Clase 14 de 29

Clase 14 / 29

Recursos

Configurar la comunicación nativa entre Flutter y iOS exige tocar el AppDelegate.swift y conectar un Flutter Method Channel con el sistema operativo. Aquí aprendes a leer el nivel de batería del dispositivo desde Swift y devolver ese dato a Flutter, replicando la lógica que ya construiste en Android pero adaptada al ecosistema de Apple.

Cómo se estructura el AppDelegate.swift para usar Method Channel

El punto de partida vive dentro de la carpeta iOS, en el apartado Runner, donde encontrarás el archivo AppDelegate.swift con sus imports de Flutter y UIKit listos para extender.

La idea es agregar dos piezas: una función privada que consulte la batería del sistema y la lógica dentro de application que cree el canal de comunicación. Ambas se conectan mediante un handler que escucha las llamadas que llegan desde Dart.

¿Qué es un Method Channel en Flutter? Es el puente que permite a tu código Dart invocar funciones nativas en Android o iOS y recibir una respuesta. Funciona como un canal nombrado donde ambos lados acuerdan qué métodos existen.

Cómo crear la función privada getBatteryLevel en Swift

Dentro del AppDelegate declaras una función private func getBatteryLevel que recibe un parámetro result marcado con @escaping FlutterResult. Ese atributo escaping le dice a Swift que el closure puede ejecutarse después de que la función termine, algo común cuando hablas con APIs asíncronas.

El flujo dentro de la función es directo:

Habilitar el monitoreo con UIDevice.current.isBatteryMonitoringEnabled = true.
Capturar el valor con let batteryLevel = UIDevice.current.batteryLevel.
Validar con un if que batteryLevel >= 0 antes de devolverlo.
Multiplicar por 100, convertir a Int y concatenar el símbolo de porcentaje.

Si el valor es negativo, significa que iOS no pudo leer la batería. En ese caso devuelves un FlutterError con código "UNAVAILABLE", un mensaje descriptivo y details en nil. Esa estructura le permite a Flutter capturar el error como excepción y reaccionar en la UI.

Cómo conectar el FlutterViewController con el canal nativo

La segunda mitad del trabajo ocurre dentro del método application del AppDelegate. Ahí inicializas el controlador y registras el canal que escuchará las invocaciones desde Dart.

Primero defines el controlador con let controller = window?.rootViewController as! FlutterViewController. Ese cast con as! es lo que te permite acceder al binaryMessenger, una propiedad exclusiva del controlador de Flutter en iOS.

Luego creas el canal con FlutterMethodChannel(name: "native.communicator", binaryMessenger: controller.binaryMessenger). El name debe ser idéntico al que usaste en Android y en Dart, porque es el identificador que une los tres lados.

¿Por qué el name del canal debe coincidir en Android, iOS y Dart? Porque Flutter enruta las llamadas usando ese string como dirección. Si hay una diferencia de un carácter, el método nunca llega al lado nativo.

Cómo manejar las llamadas con setMethodCallHandler

Con el canal creado, llamas a batteryChannel.setMethodCallHandler y le pasas un closure que recibe dos parámetros: call: FlutterMethodCall y result: @escaping FlutterResult.

Dentro del closure va el ruteo de métodos:

Un if call.method == "getBatteryLevel" que invoca self?.getBatteryLevel(result: result).
Un else que responde con FlutterMethodNotImplemented cuando el nombre no coincide con ningún método registrado.

El uso de self aquí equivale a un this en otros lenguajes y permite acceder a la función privada que definiste arriba. Recuerda envolver todo el bloque del handler dentro de llaves y paréntesis para que Swift lo interprete como un closure válido.

Qué errores devolver cuando la batería no está disponible

La elegancia de este patrón está en separar éxito y fallo desde el nativo. Cuando todo funciona, mandas un string con el porcentaje. Cuando falla, mandas un FlutterError estructurado con tres campos:

code: un identificador corto como "UNAVAILABLE".
message: una descripción legible para debugging.
details: información extra opcional, en este caso nil.

Ese contrato hace que el código Dart pueda usar try/catch limpio y mostrar mensajes apropiados en la UI sin acoplarse a la implementación de cada plataforma.

Con el AppDelegate listo, ya tienes la comunicación bidireccional configurada en Android y en iOS apuntando al mismo canal. Cuéntame en los comentarios si vas a usar este patrón para leer otra propiedad del sistema operativo en tu próximo proyecto.

Resumen

Cómo se estructura el AppDelegate.swift para usar Method Channel

El punto de partida vive dentro de la carpeta iOS, en el apartado Runner, donde encontrarás el archivo AppDelegate.swift con sus imports de Flutter y UIKit listos para extender.

¿Qué es un Method Channel en Flutter? Es el puente que permite a tu código Dart invocar funciones nativas en Android o iOS y recibir una respuesta. Funciona como un canal nombrado donde ambos lados acuerdan qué métodos existen.

Cómo crear la función privada getBatteryLevel en Swift

El flujo dentro de la función es directo:

Habilitar el monitoreo con UIDevice.current.isBatteryMonitoringEnabled = true.
Capturar el valor con let batteryLevel = UIDevice.current.batteryLevel.
Validar con un if que batteryLevel >= 0 antes de devolverlo.
Multiplicar por 100, convertir a Int y concatenar el símbolo de porcentaje.

Cómo conectar el FlutterViewController con el canal nativo

La segunda mitad del trabajo ocurre dentro del método application del AppDelegate. Ahí inicializas el controlador y registras el canal que escuchará las invocaciones desde Dart.

¿Por qué el name del canal debe coincidir en Android, iOS y Dart? Porque Flutter enruta las llamadas usando ese string como dirección. Si hay una diferencia de un carácter, el método nunca llega al lado nativo.

Cómo manejar las llamadas con setMethodCallHandler

Con el canal creado, llamas a batteryChannel.setMethodCallHandler y le pasas un closure que recibe dos parámetros: call: FlutterMethodCall y result: @escaping FlutterResult.

Dentro del closure va el ruteo de métodos:

Un if call.method == "getBatteryLevel" que invoca self?.getBatteryLevel(result: result).
Un else que responde con FlutterMethodNotImplemented cuando el nombre no coincide con ningún método registrado.

Qué errores devolver cuando la batería no está disponible

code: un identificador corto como "UNAVAILABLE".
message: una descripción legible para debugging.
details: información extra opcional, en este caso nil.

Ese contrato hace que el código Dart pueda usar try/catch limpio y mostrar mensajes apropiados en la UI sin acoplarse a la implementación de cada plataforma.

Fundamentos de Flutter e IA

Flutter para Android, iOS y web con un código

IA, Machine Learning y Deep Learning en Flutter

Introducción a TensorFlow Lite

Configura TensorFlow Lite en Flutter

Configuración de modelos TensorFlow Lite en Flutter

Conectar TensorFlow Lite a una interfaz Flutter

Integración de modelos y clasificación de imágenes

Interfaz Flutter que ejecuta un modelo TensorFlow Lite

Seleccionar imágenes de galería en Flutter

Procesar imágenes reales con TensorFlow Lite

Reconocimiento de voz con Whisper

Configuración de permisos para Speech to Text en Android e iOS

Servicio de speech-to-text en Flutter

Conexión de reconocimiento de voz con interfaz visual en móviles

MethodChannel

Comunicación entre Flutter y código nativo con Method Channel

Configuración de Method Channel en Android para obtener nivel de batería

Cómo leer la batería de iOS con Swift

Botón Flutter que lee batería con MethodChannel

Acceso a sensores y cámara

Configuración de Method Channel para cámara en Android desde Flutter

Cámara iOS nativa con MethodChannel en Flutter

Configuración de permisos y provider para cámara en Android

Configuración de permisos de cámara en iOS para Flutter

Integración de cámara nativa iOS en Flutter con Method Channels

Controlador de cámara iOS con FlutterError

Implementación de cámara nativa en apps Android con Flutter

Gestión de estado con BLoC

Implementación de función para capturar transacciones desde imágenes

Cómo leer facturas con ML Kit en Flutter

Reconocimiento de texto en imágenes

Parseo de montos desde texto OCR con regex

Integración de UI con cámara para captura de fotos en Flutter

Cámara en Flutter con BLoC y modal

Actualización de dependencias y corrección de errores en Flutter iOS

Diferencias entre Flutter y React Native para desarrollo móvil

Cómo leer la batería de iOS con Swift