API 入門¶

本章節介紹基礎的 API 使用，讓您可以了解 FIRERPA 的另一種使用方式。

FIRERPA 提供多達 160 條程式設計 API 介面，讓您可以對安卓設備進行無微不至的管理和操作，包括命令執行、系統設定、系統狀態、應用相關、自動化、代理以及檔案等十幾個大類的介面。提供了封裝完整的 Python 庫，讓您可以快速上手使用。在開始之前，請確保您的手機上已經正常運行了 FIRERPA 的服務端，並且已經按照要求安裝了 FIRERPA 的用戶端庫 lamda。

小撇步

不會寫、看不懂、不用擔心，請使用我們提供的 Agent Skills github.com/firerpa/skills 使用大模型自動開發。

提示

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

好了，現在您已經了解了基本的使用方法，繼續閱讀了解其他可用的介面。