API 入門¶

この章では、基本的な API の使い方を紹介し、FIRERPA の別の利用方法を理解していただきます。

FIRERPA は、最大 160 のプログラミング API インターフェースを提供し、Android デバイスを細部まで管理・操作できます。コマンド実行、システム設定、システム状態、アプリ関連、自動化、プロキシ、ファイルなど十数カテゴリにわたるインターフェースが含まれています。完全にラップされた 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 インスタンスを指します。

簡単なウォームアップ¶

では、以下のコードを実行してください。設定アプリが起動されます。

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

以下のインターフェースを使用して、デバイスからビープ音を鳴らすこともできます。複数台のデバイスがある場合に、簡単に特定できます。

d.beep()

以上で、基本的な使い方を理解できました。続いて、その他の利用可能なインターフェースについて学習してください。