Uso de la API de Programación¶

Este capítulo presenta el uso básico de la API, para que pueda conocer otra forma de usar FIRERPA. FIRERPA ofrece hasta 160 interfaces de API de programación que le permiten gestionar y operar dispositivos Android minuciosamente, proporcionando interfaces para más de una docena de categorías principales, incluyendo ejecución de comandos, configuración del sistema, estado del sistema, aplicaciones, automatización, proxy y archivos. Al mismo tiempo, proporciona una biblioteca de Python completamente encapsulada para que pueda comenzar a usarla rápidamente. Antes de continuar, asegúrese de que el servidor de FIRERPA se esté ejecutando correctamente en su teléfono y que la biblioteca cliente de FIRERPA esté instalada según los requisitos. A continuación, comencemos con el siguiente tutorial.

Nota importante: Muchas de las interfaces API proporcionadas por FIRERPA devuelven clases proto nativas. Puede acceder directamente a estos valores a través de los atributos de la salida, o consultando la definición del proto y accediendo a los atributos directamente. Por ejemplo, si el valor de retorno de una interfaz es el siguiente, puede acceder a un campo específico como se muestra en el ejemplo.

>>> result = status.get_battery_info()
>>> print (result)
batt_charging: true
batt_percent: 100
batt_temperature: 26.899999618530273
>>> print (result.batt_temperature)
26.899999618530273

Conectar al Dispositivo¶

Antes de conectar el dispositivo, necesita preparar cierta información necesaria, como la dirección IP para conectarse a su teléfono y si utilizó un certificado de servicio al iniciar FIRERPA, etc. Una vez que tenga esta información lista, puede proceder con las siguientes operaciones.

Para instanciar el dispositivo, por defecto, solo necesita proporcionar una dirección IP accesible.

from lamda.client import *
d = Device("192.168.0.2")

Si habilitó un certificado de servicio al iniciar el servidor de FIRERPA, conéctese de la siguiente manera.

from lamda.client import *
d = Device("192.168.0.2", certificate="/path/to/lamda.pem")

A partir de ahora, la variable d en el resto del texto siempre se referirá a esta instancia de Device.

Primeros Pasos¶

Ahora, ejecute el siguiente código. La siguiente línea de código mostrará un mensaje Hello from Lamda! en su pantalla.

d.show_toast("Hello from Lamda!")

También puede usar la siguiente interfaz, que hace que el dispositivo emita un pitido. Cuando tenga muchos dispositivos, podrá localizarlo fácilmente (el teléfono no debe estar en modo silencioso).

d.beep()

Bien, ahora que ya sabe cómo empezar, puede seguir leyendo para conocer otras interfaces disponibles y cómo usarlas.