API 入门¶

本章节介绍基础的 API 使用，让您可以了解 FIRERPA 的另一种使用方式。

FIRERPA 提供多达 160 条编程 API 接口，让您可以对安卓设备进行无微不至的管理和操作，包括命令执行、系统设置、系统状态、应用相关、自动化、代理以及文件等十几个大类的接口。提供了封装完整的 Python 库，让您可以快速上手使用。在开始之前，请确保您的手机上已经正常运行了 FIRERPA 的服务端，并且已经按照要求安装了 FIRERPA 的客户端库 lamda。

提示

FIRERPA Python 客户端库提供的 API 接口，很多都是返回原生的 proto 类。您可以直接通过输出的结果的属性访问这些字段值，或者查看 rpc 目录下的 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", port=65000)

从现在开始，下文中的 d 变量将始终为这个 Device 实例。

简单热身¶

现在，执行下面的代码，它将在会为您启动设置 APP。

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

也可以使用下面的接口，使设备发出蜂鸣声。当有多台设备时，可以很方便地定位它。

d.beep()

好了，现在您已经了解了基本的使用方法，继续阅读了解其他可用的接口。