# 使用编程接口

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

说在前面：FIRERPA 提供的 API 接口，很多都是返回的原生 proto 类，您可以直接通过输出的属性，或者查看 proto 定义，通过属性直接访问这些值，比如某个接口的返回值为如下，您可以直接通过示例方式访问特定字段。

```python
>>> 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 地址即可。

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

如果您在启动 FIRERPA 服务端时启用了服务证书，请这样连接。

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

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

## 简单热身

现在，执行如下的代码，下面这行代码将会在您的屏幕上显示一个消息 `Hello from Lamda!`。

```python
d.show_toast("Hello from Lamda!")
```

您也可以使用如下的接口，他可以使设备发出一声蜂鸣，当有一堆设备的时候，您可以很方便的定位他（需要手机为非静音状态）。

```python
d.beep()
```

好了，现在您已经了解了如何使用，您可以继续阅读了解其他可用的接口以及他们的使用方式。