Verwendung der Programmierschnittstelle¶

Dieses Kapitel stellt die grundlegende API-Nutzung vor, damit Sie eine weitere Möglichkeit zur Verwendung von FIRERPA kennenlernen können. FIRERPA bietet bis zu 160 Programmierschnittstellen (APIs), die Ihnen eine detaillierte Verwaltung und Bedienung von Android-Geräten ermöglichen. Es werden Schnittstellen in über einem Dutzend Hauptkategorien bereitgestellt, darunter Befehlsausführung, Systemeinstellungen, Systemstatus, Anwendungsbezogenes, Automatisierungsbezogenes, Proxy und Dateien. Gleichzeitig wird eine vollständig gekapselte Python-Bibliothek bereitgestellt, die Ihnen einen schnellen Einstieg ermöglicht. Bevor Sie beginnen, stellen Sie bitte sicher, dass der FIRERPA-Server auf Ihrem Mobiltelefon ordnungsgemäß läuft und die FIRERPA-Client-Bibliothek gemäß den Anforderungen installiert ist. Lassen Sie uns nun mit dem folgenden Tutorial beginnen.

Vorab ein Hinweis: Viele der von FIRERPA bereitgestellten API-Schnittstellen geben native Proto-Klassen zurück. Sie können direkt über die Attribute der Ausgabe oder durch Einsehen der Proto-Definition auf diese Werte zugreifen. Wenn beispielsweise der Rückgabewert einer Schnittstelle wie folgt aussieht, können Sie wie im Beispiel gezeigt auf ein bestimmtes Feld zugreifen.

>>> result = status.get_battery_info()
>>> print (result)
batt_charging: true
batt_percent: 100
batt_temperature: 26.899999618530273
>>> print (result.batt_temperature)
26.899999618530273

Gerät verbinden¶

Bevor Sie das Gerät verbinden, müssen Sie einige notwendige Informationen vorbereiten, wie z. B. die IP-Adresse, über die Sie auf Ihr Mobiltelefon zugreifen können, und ob Sie beim Starten von FIRERPA ein Service-Zertifikat verwendet haben. Sobald Sie diese Informationen bereit haben, können Sie mit den folgenden Schritten fortfahren.

Instanziieren Sie das Gerät. Standardmäßig genügt die Angabe einer erreichbaren IP-Adresse.

from lamda.client import *
d = Device("192.168.0.2")

Wenn Sie beim Starten des FIRERPA-Servers ein Service-Zertifikat aktiviert haben, stellen Sie die Verbindung wie folgt her.

from lamda.client import *
d = Device("192.168.0.2", certificate="/path/to/lamda.pem")

Von nun an wird die Variable d im folgenden Text immer diese Device-Instanz repräsentieren.

Erste Schritte¶

Führen Sie nun den folgenden Code aus. Die nachstehende Codezeile zeigt eine Nachricht Hello from Lamda! auf Ihrem Bildschirm an.

d.show_toast("Hello from Lamda!")

Sie können auch die folgende Schnittstelle verwenden, die das Gerät einen Piepton ausgeben lässt. Wenn Sie eine Reihe von Geräten haben, können Sie es so leicht lokalisieren (das Telefon darf nicht stummgeschaltet sein).

d.beep()

Gut, jetzt haben Sie die Grundlagen der Verwendung verstanden. Sie können weiterlesen, um mehr über andere verfügbare Schnittstellen und deren Verwendung zu erfahren.