Использование программного интерфейса¶

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

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

>>> 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")

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

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

Теперь выполните следующий код. Эта строка кода отобразит на вашем экране сообщение Hello from Lamda!.

d.show_toast("Hello from Lamda!")

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

d.beep()

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