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

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