# 使用程式設計介面

本章節介紹基礎的 API 使用，讓您可以了解 FIRERPA 的另一種使用方式。FIRERPA 提供多達 160 個程式設計 API 介面，讓您可以對 Android 裝置進行鉅細靡遺的管理與操作，提供了包括命令執行、系統設定、系統狀態、應用程式相關、自動化相關、代理以及檔案等十幾個大類別的介面。同時提供了封裝完整的 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()
```

好了，現在您已經了解如何使用，可以繼續閱讀以了解其他可用的介面及其使用方式。