Référence des fonctions

Tu sauras retrouver la fonction qu'il te faut et l'écrire correctement. ⏱ 2 minutes pour chercher ; le reste est à consulter au besoin.

87 fonctions dans 9 catégories. Pour chacune : la signature, ce qu'elle fait, un exemple à copier.

Comment lire cette page

• Pas d'import, pas de téléphone à passer. Les fonctions sont déjà là, et elles agissent sur l'appareil choisi dans Lancer sur. Écris tap(540, 1200), jamais tap(client, 540, 1200).
• Les signatures sont celles de l'éditeur. Un paramètre avec = est facultatif : conf=0.8 signifie « 0,8 si tu ne dis rien ».
• Les coordonnées sont celles de l'image de l'appareil affichée dans AppsMobs : (0, 0) en haut à gauche, y augmente vers le bas.
• Même vocabulaire partout : conf (confiance de 0 à 1), region (zone (x, y, largeur, hauteur)), timeout (secondes), offset (décalage (dx, dy) du toucher).
• timeout : 0 = un seul essai, un nombre = attendre jusqu'à ce délai, None = attendre sans fin (à choisir exprès). Aucune attente n'est infinie par défaut.
• Le panneau Référence des fonctions de l'éditeur (menu Plus d'actions, groupe Outils) affiche les mêmes fiches.

Je veux… → j’utilise…

Gestes (13)

Toucher, glisser, pincer. Les gestes se calculent depuis la taille réelle de l'écran. touch_down et touch_up demandent scrcpy.

tap(x, y) : Toucher. Toucher l'écran au point (x, y). Les coordonnées sont celles de l'image de l'appareil affichée dans AppsMobs.

tap(540, 1200)

double_tap(x, y) : Double toucher. Deux touchers rapides au même point.

double_tap(540, 1200)

long_press(x, y, duration_ms=1000) : Appui long. Garder le doigt posé duration_ms millisecondes.

long_press(540, 1200, duration_ms=1500)

swipe(x1, y1, x2, y2, duration_ms=500) : Glisser. Glisser le doigt d'un point à un autre, comme un humain (le geste ralentit à la fin).

swipe(540, 1600, 540, 600)

swipe_up(distance=None, duration_ms=500) : Glisser vers le haut. Le doigt monte : la page défile vers le bas. distance en pixels (40 % de l'écran par défaut).

swipe_up()

swipe_down(distance=None, duration_ms=500) : Glisser vers le bas. Le doigt descend : la page remonte.

swipe_down()

swipe_left(distance=None, duration_ms=500) : Glisser vers la gauche. Le doigt va vers la gauche (page suivante d'un carrousel).

swipe_left()

swipe_right(distance=None, duration_ms=500) : Glisser vers la droite. Le doigt va vers la droite (page précédente).

swipe_right()

drag(x1, y1, x2, y2, duration_ms=1000) : Déplacer. Appui long sur le premier point puis glisser jusqu'au second : déplacer une icône, un objet.

drag(200, 800, 800, 800)

pinch_in(x=None, y=None) : Pincer (dézoomer). Rapprocher deux doigts vers le point (centre de l'écran par défaut). Vrai geste à deux doigts avec scrcpy, approché sans.

pinch_in()

pinch_out(x=None, y=None) : Écarter (zoomer). Écarter deux doigts depuis le point.

pinch_out()

touch_down(x, y) : Poser le doigt. Poser le doigt sans le relever (avec touch_up pour un geste sur mesure). scrcpy requis.

touch_down(540, 1200)

touch_up(x, y) : Relever le doigt. Relever le doigt posé par touch_down.

touch_up(540, 1200)

Images à l'écran (12)

Chercher une image (un .png) sur l'écran. Le fichier est cherché dans le dossier du script, puis dans Scripts\img. Paramètres communs : conf (0 à 1), region, timeout, offset.

find_image(img, conf=0.8, region=None, timeout=0) : Trouver une image. Position (x, y) du centre de l'image à l'écran, ou None. timeout : secondes d'attente (0 = un seul essai).

pos = find_image("bouton.png")
if pos:
    tap(*pos)

image_visible(img, conf=0.8, region=None) : Image visible ?. True si l'image est à l'écran maintenant, False sinon.

if image_visible("popup.png"):
    press_back()

wait_image(img, conf=0.8, region=None, timeout=30) : Attendre une image. Attendre que l'image apparaisse. Rend (x, y), ou None après timeout secondes : le script continue.

if wait_image("accueil.png", timeout=20):
    log("chargé")

find_image_positions(img, conf=0.8, region=None) : Toutes les positions. Liste de toutes les positions (x, y) où l'image apparaît, de haut en bas.

for x, y in find_image_positions("piece.png"):
    tap(x, y)

first_image(imgs, conf=0.8, region=None, timeout=30) : Première image de la liste. Attendre que l'une des images apparaisse. Rend (image, x, y), ou None après timeout.

res = first_image(["gagne.png", "perdu.png"])
if res:
    nom, x, y = res

tap_image(img, conf=0.8, region=None, timeout=30, offset=(0, 0)) : Toucher une image. Attendre l'image (30 s par défaut) puis la toucher. offset=(dx, dy) décale le toucher. Rend True si touchée.

tap_image("jouer.png")

double_tap_image(img, conf=0.8, region=None, timeout=30, offset=(0, 0)) : Double toucher une image. Attendre l'image puis la toucher deux fois.

double_tap_image("photo.png")

long_press_image(img, duration_ms=1000, conf=0.8, region=None, timeout=30) : Appui long sur une image. Attendre l'image puis garder le doigt dessus.

long_press_image("icone.png", duration_ms=1500)

tap_first_image(imgs, conf=0.8, region=None, timeout=30, offset=(0, 0)) : Toucher la première image trouvée. Toucher la première image de la liste qui apparaît. Rend son nom, ou None.

choix = tap_first_image(["ok.png", "fermer.png"])

tap_all_images(img, conf=0.8, region=None) : Toucher toutes les occurrences. Toucher chaque endroit où l'image apparaît. Rend le nombre de touchers.

n = tap_all_images("coeur.png")

scroll_to_image(img, direction='down', max_swipes=20, conf=0.8, region=None) : Défiler jusqu'à une image. Faire défiler la page (direction "down" ou "up") jusqu'à voir l'image. Rend (x, y) ou None.

pos = scroll_to_image("article.png")

tap_until_image(positions, img, max_taps=10, conf=0.8, region=None) : Toucher jusqu'à voir une image. Toucher les positions à tour de rôle jusqu'à ce que l'image apparaisse. Rend True si elle est apparue.

tap_until_image([(540, 1800)], "suite.png")

Texte à l'écran (5)

Lire le texte de l'interface Android, sans image. Ça marche pour les textes que l'appli expose ; un texte dessiné dans une image ne se lit pas ainsi.

tap_text(text, exact=True, timeout=0) : Toucher un texte. Toucher l'élément qui affiche ce texte (lu dans l'interface Android, sans image). exact=False : contient le texte.

tap_text("Paramètres")

text_visible(text, exact=True) : Texte visible ?. True si un élément affiche ce texte maintenant.

if text_visible("Connexion"):
    log("écran de connexion")

wait_text(text, exact=True, timeout=30) : Attendre un texte. Attendre qu'un élément affiche ce texte. Rend (x, y), ou None après timeout.

wait_text("Bienvenue", timeout=20)

read_text_at(x, y) : Lire le texte à un point. Texte de l'élément sous le point (x, y), ou None.

prix = read_text_at(540, 900)

read_text_by_id(resource_id) : Lire le texte d'un élément. Texte de l'élément d'identifiant Android donné, ou None.

titre = read_text_by_id("com.app:id/titre")

Saisie & touches (11)

Saisie de texte, presse-papiers et touches système. Teste d'abord avec des accents ou des caractères spéciaux : la saisie de l'écran Contrôle ne les accepte pas.

type_text(text) : Taper du texte. Taper du texte dans le champ actif.

type_text("bonjour")

clear_text() : Effacer le champ. Effacer le contenu du champ actif.

clear_text()

select_all() : Tout sélectionner. Sélectionner tout le texte du champ actif.

select_all()

copy() : Copier. Copier la sélection.

copy()

paste() : Coller. Coller dans le champ actif.

paste()

set_clipboard(text) : Remplir le presse-papiers. Mettre du texte dans le presse-papiers de l'appareil.

set_clipboard("code promo")

get_clipboard() : Lire le presse-papiers. Texte du presse-papiers, ou None.

texte = get_clipboard()

press_back(times=1) : Touche Retour. Appuyer sur Retour (times fois).

press_back()

press_home() : Touche Accueil. Revenir à l'écran d'accueil.

press_home()

press_enter() : Touche Entrée. Valider le champ actif.

press_enter()

recent_apps() : Applications récentes. Ouvrir la liste des applications récentes.

recent_apps()

Écran (7)

Taille, couleur d'un pixel, capture, défilement.

screen_size() : Taille de l'écran. (largeur, hauteur), dans les coordonnées de tap().

w, h = screen_size()

pixel_color(x, y) : Couleur d'un pixel. Couleur (bleu, vert, rouge) du pixel, ou None.

b, g, r = pixel_color(10, 10)

pixel_is(x, y, color, tolerance=10) : Pixel de cette couleur ?. True si le pixel a la couleur (bleu, vert, rouge), à tolerance près.

if pixel_is(100, 200, (0, 0, 255)):
    log("rouge")

screenshot(filename='screenshot.png') : Capture d'écran. Enregistrer une capture. Rend le chemin du fichier.

screenshot("capture.png")

scroll_to_top(max_swipes=3) : Remonter en haut. Remonter en haut de la page.

scroll_to_top()

scroll_to_bottom(max_swipes=3) : Descendre en bas. Descendre en bas de la page.

scroll_to_bottom()

pull_to_refresh() : Tirer pour actualiser. Tirer le haut de la page vers le bas pour l'actualiser.

pull_to_refresh()

Applications (8)

Lancer, arrêter, installer des applications. Le nom de paquet d'une appli (com.android.chrome) s'obtient avec installed_apps().

open_app(package, activity=None) : Ouvrir une application. Lancer une application par son nom de paquet (visible dans installed_apps()).

open_app("com.android.chrome")

close_app(package=None) : Fermer une application. Arrêter une application (sans paquet : celle au premier plan).

close_app("com.android.chrome")

restart_app(package) : Relancer une application. Arrêter puis relancer une application.

restart_app("com.android.chrome")

clear_app_data(package) : Effacer les données d'une app. Efface TOUTES les données de l'application (connexion, réglages), comme une réinstallation.

clear_app_data("com.exemple.jeu")

install_app(apk) : Installer une application. Installer un fichier .apk depuis le PC.

install_app("C:/apk/app.apk")

uninstall_app(package) : Désinstaller une application. Désinstaller une application.

uninstall_app("com.exemple.app")

installed_apps(system_apps=False) : Applications installées. Liste des paquets installés (system_apps=True : applications système comprises).

for p in installed_apps():
    log(p)

app_info(package) : Informations de l'application. Ouvrir la page Informations de l'application dans les réglages.

app_info("com.android.chrome")

Appareil & système (15)

Réveiller, redémarrer, réseau, volume, notifications. Redémarrer l'appareil arrête aussi ses scripts.

wake_screen() : Allumer l'écran. Sortir l'écran de veille.

wake_screen()

reboot() : Redémarrer l'appareil. Redémarrer l'appareil.

reboot()

device_info() : Infos de l'appareil. Modèle, version d'Android, numéro de série (dictionnaire).

info = device_info()
log(info["model"])

adb(command) : Commande adb. Lancer une commande adb shell et rendre sa sortie.

modele = adb("getprop ro.product.model")

set_wifi(on=True) : Wi-Fi. Activer (True) ou couper (False) le Wi-Fi.

set_wifi(False)

set_mobile_data(on=True) : Données mobiles. Activer ou couper les données mobiles.

set_mobile_data(True)

set_airplane_mode(on=True) : Mode avion. Activer ou couper le mode avion.

set_airplane_mode(True)

rotate(orientation='landscape') : Orientation. Orienter l'écran : "portrait" ou "landscape".

rotate("landscape")

volume_up() : Monter le volume. Monter le volume.

volume_up()

volume_down() : Baisser le volume. Baisser le volume.

volume_down()

mute() : Couper le son. Couper ou remettre le son.

mute()

open_notifications() : Ouvrir les notifications. Ouvrir le volet des notifications.

open_notifications()

close_notifications() : Fermer les notifications. Fermer le volet des notifications.

close_notifications()

open_settings(category=None) : Ouvrir les réglages. Ouvrir les réglages Android, ou une catégorie ("wifi", "bluetooth", "display"…).

open_settings("wifi")

vibrate(duration_ms=1000) : Vibrer. Faire vibrer l'appareil duration_ms millisecondes.

vibrate(500)

Téléphone (10)

SMS, appels, contacts, alarmes et minuteurs. Ces fonctions agissent vraiment sur le téléphone : teste-les d'abord sur un appareil de test.

send_sms(number, message) : Envoyer un SMS. Envoyer un SMS.

send_sms("+33600000000", "Bonjour")

read_sms(limit=10) : Lire les SMS. Derniers SMS reçus.

for sms in read_sms(5):
    log(sms)

call(number) : Appeler. Appeler un numéro.

call("+33600000000")

answer_call() : Décrocher. Décrocher l'appel entrant.

answer_call()

hang_up() : Raccrocher. Raccrocher.

hang_up()

contacts(limit=50) : Contacts. Liste des contacts.

for c in contacts():
    log(c)

set_alarm(hour, minute, label='Alarme') : Créer une alarme. Créer une alarme.

set_alarm(7, 30, "Réveil")

cancel_alarm(hour=None, minute=None) : Supprimer une alarme. Supprimer une alarme (sans heure : toutes).

cancel_alarm(7, 30)

alarms() : Alarmes. Liste des alarmes.

log(alarms())

set_timer(hours=0, minutes=0, seconds=0) : Minuteur. Lancer un minuteur.

set_timer(minutes=5)

Temps & déroulé (6)

Pauses, répétitions, sortie et fin du script. log, input et finish sont fournies par le lanceur de scripts.

wait(seconds) : Attendre. Attendre en SECONDES (0.5 = une demi-seconde). Le bouton Pause du Playground est respecté.

wait(2)

random_wait(min_s=0.35, max_s=0.8) : Attendre au hasard. Attendre une durée au hasard entre min_s et max_s secondes : un rythme moins régulier.

random_wait(1, 3)

repeat(action, times, *args) : Répéter. Appeler une fonction plusieurs fois avec les mêmes arguments. Rend la liste des résultats.

repeat(tap, 5, 540, 1200)

log(message, level='INFO') : Écrire dans la sortie. Afficher un message horodaté dans le panneau Sortie.

log("étape 1 terminée")

input(question='') : Demander une valeur. Poser une question dans la console du Playground et attendre la réponse.

nom = input("Ton pseudo ?")

finish() : Terminer le script. Arrêter le script proprement.

finish()

Ça ne marche pas ?

• NameError: name '...' is not defined : la fonction n'existe pas sous ce nom. Compare avec la liste ci-dessus (les noms sont en anglais : tap, pas clic).
• image introuvable : bouton.png (cherchée dans le dossier du script et dans Scripts/img) : le fichier .png n'est pas au bon endroit. Voir Écrire un script en Python.
• Rien ne se passe quand tu touches : vérifie les coordonnées avec Capture de l'appareil ; ce sont celles de l'image de l'appareil.
• Les fonctions de vision par IA (smart_*, YOLO) ne sont pas listées ici : elles sont en refonte, ne les utilise pas encore.

Et ensuite

• Écrire un script en Python : les règles et les bonnes habitudes.
• Écrire ses scripts avec Claude ou Grok : lui demander d'écrire le script avec ces fonctions.
• Créer sans coder : l'éditeur en blocs