Введение в API

В этом разделе описываются основы использования API, чтобы вы могли познакомиться с ещё одним способом работы с FIRERPA.

FIRERPA предоставляет более 160 программных API-интерфейсов, позволяющих детально управлять Android-устройством и выполнять операции из более чем десяти категорий: выполнение команд, системные настройки, состояние системы, работа с приложениями, автоматизация, прокси, файлы и другие. Имеется полностью готовая библиотека для Python, которая позволяет быстро начать работу. Прежде чем приступить, убедитесь, что на вашем телефоне正常运行 серверная часть FIRERPA и что установлена клиентская библиотека FIRERPA lamda.

Совет

Не умеете писать, не понимаете код — не волнуйтесь. Используйте наши Agent Skills github.com/firerpa/skills, чтобы автоматизировать разработку с помощью больших языковых моделей.

Подсказка

Многие API-интерфейсы клиентской библиотеки FIRERPA для Python возвращают нативные proto-классы. Вы можете обращаться к значениям полей напрямую через атрибуты результата или изучить определения proto в каталоге rpc, чтобы понять, какие атрибуты доступны для различных результатов. Например, если некоторый интерфейс возвращает следующий результат, вы можете обратиться к конкретному полю показанным способом.

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

Подключение устройства

Перед подключением устройства необходимо подготовить некоторые обязательные данные, например IP-адрес, по которому можно подключиться к вашему телефону, а также информацию о том, использовали ли вы сертификат сервера при запуске FIRERPA. После подготовки этих данных можно переходить к следующим шагам.

Создайте экземпляр устройства. По умолчанию достаточно указать доступный IP-адрес.

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

Если при запуске серверной части FIRERPA вы включили сертификат сервера или изменили порт, подключайтесь следующим образом.

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

Далее переменная d всегда будет обозначать этот экземпляр Device.

Простая разминка

Теперь выполните следующий код — он запустит приложение «Настройки».

d.application('com.android.settings').start()

Также можно использовать следующий интерфейс, чтобы устройство издало звуковой сигнал. Это удобно, когда у вас несколько устройств и нужно быстро найти нужное.

d.beep()

Теперь вы знакомы с основами использования. Продолжайте чтение, чтобы узнать о других доступных интерфейсах.