# プログラミングインターフェースの使用

本章では、基本的な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()
```

これで、基本的な使用方法を理解できました。引き続き他の利用可能なインターフェースとその使用方法について読み進めてください。