Utilisation de l'interface de programmation¶

Ce chapitre présente l'utilisation de base de l'API, vous permettant de découvrir une autre façon d'utiliser FIRERPA. FIRERPA fournit jusqu'à 160 interfaces API de programmation, vous permettant de gérer et d'opérer vos appareils Android avec une grande précision. Il offre des interfaces dans plus d'une douzaine de catégories majeures, incluant l'exécution de commandes, les paramètres système, l'état du système, les applications, l'automatisation, le proxy et les fichiers. Il fournit également une bibliothèque Python complète pour vous permettre de démarrer rapidement. Avant de commencer, veuillez vous assurer que le serveur FIRERPA est en cours d'exécution sur votre téléphone et que la bibliothèque client FIRERPA a été installée comme requis. Maintenant, commençons le tutoriel suivant.

Remarque : Les interfaces API fournies par FIRERPA retournent souvent des classes proto natives. Vous pouvez accéder directement à leurs valeurs via les attributs de la sortie, ou en consultant la définition proto. Par exemple, si la valeur de retour d'une interface est la suivante, vous pouvez accéder à un champ spécifique comme le montre l'exemple.

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

Connexion à un appareil¶

Avant de vous connecter à un appareil, vous devez préparer quelques informations nécessaires, telles que l'adresse IP permettant de se connecter à votre téléphone, et si vous avez utilisé un certificat de service lors du lancement de FIRERPA. Une fois ces informations prêtes, vous pouvez poursuivre avec les opérations suivantes.

Instanciez l'appareil. Par défaut, il suffit de fournir une adresse IP accessible.

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

Si vous avez activé le certificat de service lors du lancement du serveur FIRERPA, veuillez vous connecter de cette manière.

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

À partir de maintenant, la variable d dans le reste de ce document fera toujours référence à cette instance de Device.

Échauffement simple¶

Maintenant, exécutez le code suivant. Cette ligne de code affichera un message Hello from Lamda! sur votre écran.

d.show_toast("Hello from Lamda!")

Vous pouvez également utiliser l'interface suivante, qui fait émettre un bip à l'appareil. Lorsque vous avez plusieurs appareils, cela vous permet de le localiser facilement (le téléphone doit être en mode non silencieux).

d.beep()

Voilà, vous savez maintenant comment l'utiliser. Vous pouvez continuer la lecture pour découvrir les autres interfaces disponibles et leurs modes d'utilisation.