Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:sistemas_operativos:android:aplicaciones:termux:termux_api [2026/04/26 15:29] – creado tempwin
+++ informatica:sistemas_operativos:android:aplicaciones:termux:termux_api [2026/04/26 16:59] (actual) – [Alertar del nivel de batería] tempwin
@@ Línea 1: / Línea 1: @@
 ====== Termux:API ======
-Extensión de [[..:termux|Termux]] que...
+**Termux:API** es un añadido / extensión de [[..:termux|Termux]] que expone funcionalidades del dispositivo como una API para programas en línea de comandos.
+  * [[https://github.com/termux/termux-api|Repositorio de código]]
+  * [[https://wiki.termux.com/wiki/Termux:API|Wiki oficial]]
+===== Instalación =====
+Hay que instalar la aplicación para Android **Termux:API** (a través de [[https://f-droid.org/en/packages/com.termux.api/|F-droid]]) y también el paquete **termux-api** en Termux:
+<code bash>
+pkg install termux-api
+</code>
+===== Comandos =====
+Tras la instalación, tendremos disponibles los siguientes comandos:
+  * ''termux-battery-status'': obtiene el estado de la batería del dispositivo.
+  * ''termux-brightness'': establece el brillo del dispositivo (entre 0 y 255)
+  * ''termux-call-log'': lista el historial de llamadas.
+  * ''termux-camera-info'': obtiene información sobre las cámaras del dispositivo.
+  * ''termux-camera-photo'': hace una foto y la guarda en un fichero JPEG.
+  * ''termux-clipboard-get'': obtiene el texto del portapapeles.
+  * ''termux-clipboard-set'': modifica el texto del portapapeles.
+  * ''termux-contact-list'': lista los contactos.
+  * ''termux-dialog'': muestra el diágolo de introducción de texto.
+  * ''termux-download'': descarga un recurso utilizando el gestor de descargas del sistema
+  * ''termux-fingerprint'': utiliza el sensor de huella para autenticación.
+  * ''termux-infrared-frequencies'': obtiene las frecuencias soportadas por el transmisor de infrarrojos.
+  * ''termux-infrared-transmit'': transmite un patrón de infrarrojos.
+  * ''termux-job-scheduler'': programa un script de Termux para ejecutar más tarde o periódicamente.
+  * ''termux-location'': obtiene la ubicación del dispositivo.
+  * ''termux-media-player'': reproduce archivos multimedia.
+  * ''termux-media-scan'': escanea multimedia. Hace cambios que son visibles en la galería.
+  * ''termux-microphone-record'': graba utilizando el micrófono del dispositivo.
+  * ''termux-notification'': muestra una notificación de sistema.
+  * ''termux-notification-remove'': elimina una notificación mostrada con ''termux-notification''
+  * ''termux-sensor'': obtiene información de los diferentes sensores del dispositivo.
+  * ''termux-share'': comparte un archivo pasado como argumento.
+  * ''termux-sms-list'': lista los mensajes SMS.
+  * ''termux-sms-send'': envía un SMS a un número especificado.
+  * ''termux-storage-get'': solicita un fichero y lo manda al archivo especificado.
+  * ''termux-telephony-call'': realiza una llamada al número especificado.
+  * ''termux-telephony-cellinfo'': obtiene información sobre las células al alcance del dispositivo.
+  * ''termux-telephony-deviceinfo'': obtiene información sobre el teléfono.
+  * ''termux-toast'': muestra una notificación.
+  * ''termux-torch'': enciende (''on'') o apaga (''off'') la linterna.
+  * ''termux-tts-engines'': obtiene información sobre los motores de transcripción a audio (//text-to-speech//) disponibles.
+  * ''termux-tts-speak'': dicta un texto con el motor  de transcripción del sistema.
+  * ''termux-usb'': lista o accede a dispositivos USB.
+  * ''termux-vibrate'': hace vibrar el dispositivo.
+  * ''termux-volume'': cambia el volumen del audio.
+  * ''termux-wallpaper'': cambia el fondo de pantalla del dispositivo.
+  * ''termux-wifi-connectioninfo'': muestra información sobre la conexión Wi-Fi actual.
+  * ''termux-wifi-enable'': activa/desactiva la red Wi-Fi.
+  * ''termux-wifi-scaninfo'': obtiene información del último escaneo de redes Wi-Fi.
+===== Casos prácticos =====
+==== Notificaciones personalizadas ====
+Mediante el comando ''termux-notification'' podemos enviar notificaciones al terminal Android que aparecerán en el área de notificaciones.
+<code>
+termux-notification --title "Script terminado" --content "Todo OK"
+</code>
+Puede ser útil para scripts largos, copias de seguridad o descargas.
+==== Alertar del nivel de batería ====
+Utilizando el comando ''termux-battery-status'' podríamos crear el siguiente script:
+<code bash>
+level=$(termux-battery-status | jq '.percentage')
+if [ "$level" -lt 15 ]; then
+  termux-notification --title "Batería baja" --content "Queda menos del 15%"
+fi
+</code>
+<WRAP center round important 60%>
+Necesario instalar el paquete ''jq'': ''pkg jq''.
+</WRAP>
+==== Hacer fotos sigilosamente ====
+Utilizando el comando ''termux-camera-photo'' podemos hacer fotos con la cámara trasera incluso con el móvil bloqueado:
+<code>
+termux-camera-photo foto.jpg
+</code>
+==== Grabar audio sigilosamente ====
+Gracias al comando ''termux-microphone-record''.
+Por ejemplo, para grabar el audio que recoja el dispositivo durante 10 segundos:
+<code>
+termux-microphone-record -f audio.mp3 -l 10
+</code>
+Si queremos poner a grabar sin límite:
+<code bash>
+termux-microphone-record -f nombre-fichero -l 0
+</code>
+Para detener la grabación:
+<code bash>
+termux-microphone-record -q
+</code>
+==== Controlar volumen ====
+Gracias al comando ''termux-volume'' podremos gestionar el volumen de los diferentes //streams// disponibles:
+  * alarm
+  * notification
+  * music
+  * ring
+  * system
+  * call
+Si lo lanzamos sin argumentos, podremos ver todos los //streams// disponibles, cuál es su volumen actual y cuál el máximo:
+<code>
+termux-volume
+</code>
+Para poner el volumen de la música al 0:
+<code>
+termux-volume music 0
+</code>
+==== Sensores del dispositivo ====
+Gracias al comando ''termux-sensor'' podemos obtener información sobre el tipo de sensores del dispositivo e información en tiempo real.
+Para ver los sensores que tiene disponibles nuestro dispositivo:
+<code>
+termux-sensor -l
+</code>
+==== Texto a voz (TTS) ====
+Gracias al comando ''termux-tts-speak'' podemos pasar cualquier texto a voz que puede ser útil como alerta auditiva o asistentes personales:
+<code>
+termux-tts-speak "Copia de seguridad completada"
+</code>