Aller au contenu

Screen Automator - GlobalAction

Obsolète

Ce mode de la tâche combinée ScreenAutomator est conservé uniquement pour les workflows construits avant la scission de la tâche. Pour de nouveaux workflows, utilisez plutôt la tâche autonome Global Action - même comportement, avec son propre tag JSON (GlobalAction).

Résumé

  • Nom interne : ScreenAutomator
  • Catégorie : Automatisation écran / Accessibilité
  • But : Exécuter des actions système Android prédéfinies (Home, Back, Recents, Notifications, Capture d'écran, etc.) via le service AccessibilityService d'Android.
  • Type de tâche : Normale

Cette tâche permet à un workflow AndroMate de contrôler la navigation système et l'interface système sans se baser sur la détection de texte ou les coordonnées.

Compatibilité

  • Version AndroMate minimale : 1.1.0
  • Version AndroMate maximale : 1.1.0
  • Android minimum : Android 13 (API 33)
  • Android maximum testé : Android 16 (API 36)

Constructeurs supportés

  • Samsung (One UI 6.x / 7.x / 8.x)

Permissions nécessaires

  • ACCESSIBILITY_SERVICE
  • (Optionnel) WRITE_SECURE_SETTINGS selon le comportement OEM/système

Description détaillée

Le mode GlobalAction de ScreenAutomator exécute des actions système Android de haut niveau exposées par le framework Accessibility.

Cas d'usage typiques :

  • Navigation dans le système :
  • HOME, BACK, RECENTS
  • Ouvrir ou fermer les panneaux système :
  • Panneau de notifications
  • Paramètres rapides
  • Dialogue d'alimentation
  • Liste "Toutes les apps" du launcher
  • Opérations sur l'appareil :
  • Verrouiller l'écran
  • Prendre une capture d'écran
  • Activer/désactiver le mode écran partagé
  • Simuler des touches spécifiques / D-Pad / contrôle média :
  • D-Pad (haut, bas, gauche, droite, centre)
  • Lecture/pause média
  • Touche headset hook

La liste exacte des actions supportées dépend de la version Android (min SDK par action) et du constructeur de l'appareil.

Paramètres d'entrée

Paramètre Type Obligatoire Valeurs possibles Compatibilité Android Compatibilité AndroMate Défaut
Action_type Enum / String Oui Doit être "GlobalAction" Android 13 (API 33) -> Android 16 (API 36) 1.1.0 -> 1.1.0 -
GlobalAction_type Enum / Integer Oui Toute action globale supportée Dépend du min SDK de chaque action (16 -> 33+) 1.1.0 -> 1.1.0 -

Paramètres de sortie

Ce mode GlobalAction :

  • ne retourne pas stdout/stderr
  • ne définit aucune variable de sortie spécifique

Son objectif est de réaliser une action (effet sur l'UI), pas de produire du contenu.

Détail des paramètres

1. Action_type

Indique le mode ScreenAutomator à utiliser.

  • Pour ce README : il doit être défini sur "GlobalAction".

Exemple

"Action_type": "GlobalAction"

2. GlobalAction_type

Définit l'action globale Android qui sera exécutée.

Cette valeur est stockée sous forme d'entier/énumération interne et associée aux actions globales d'accessibilité d'Android.

Liste des actions (basée sur l'énumération)

Nom logique Description Valeur hex Min SDK
SHOW_LAUNCHERS_ALL_APPS Afficher la liste "Toutes les apps" du launcher 0x0000000B 31
SHOW_SCREEN_AUTOMATOR_BUTTON Déclencher le bouton d'accessibilité 0x0000000A 31
SCREEN_AUTOMATOR_BUTTON_CHOOSER Ouvrir le menu du bouton d'accessibilité 0x0000000C 31
SCREEN_AUTOMATOR_SHORT_CUT Déclencher le raccourci d'accessibilité 0x0000000D 31
ACTION_BACK Revenir en arrière 0x00000001 16
DISMISS_NOTIFICATION_SHADE Fermer le panneau de notifications 0x0000000E 31
GLOBAL_ACTION_DPAD_CENTER Événement D-Pad centre 0x00000014 33
GLOBAL_ACTION_DPAD_DOWN Événement D-Pad bas 0x00000011 33
GLOBAL_ACTION_DPAD_RIGHT Événement D-Pad droite 0x00000013 33
GLOBAL_ACTION_DPAD_UP Événement D-Pad haut 0x00000010 33
GLOBAL_ACTION_HOME Aller à l'écran d'accueil 0x00000002 16
GLOBAL_ACTION_KEYCODE_HEADSETHOOK Événement bouton kit mains-libres 0x0000000F 31
GLOBAL_ACTION_LOCK_SCREEN Verrouiller l'écran 0x00000008 28
GLOBAL_ACTION_MEDIA_PLAY_PAUSE Lecture / pause média - 22-36
GLOBAL_ACTION_MENU Déclencher la touche Menu - 21-36
GLOBAL_ACTION_NOTIFICATIONS Ouvrir les notifications 0x00000004 16
GLOBAL_ACTION_POWER_DIALOG Ouvrir le menu d'alimentation 0x00000006 21
GLOBAL_ACTION_QUICK_SETTINGS Ouvrir les paramètres rapides 0x00000005 17
GLOBAL_ACTION_RECENTS Ouvrir les applications récentes 0x00000003 16
GLOBAL_ACTION_TAKE_SCREENSHOT Prendre une capture d'écran 0x00000009 28
GLOBAL_ACTION_TOGGLE_SPLIT_SCREEN Activer/désactiver l'écran partagé 0x00000007 24

Exceptions

Code Exception Name Description
SCREEN-AUTOMATOR-ERROR-001 INVALID_CONTROL_SERVICE_GLOBAL_ACTION Action globale reçue invalide ou inconnue
SCREEN-AUTOMATOR-ERROR-002 UNSUPPORTED_CONTROL_SERVICE_GLOBAL_ACTION Action globale non supportée sur ce device ou cette version Android
SCREEN-AUTOMATOR-ERROR-003 INVALID_ACTION_TYPE Type d'action invalide (doit être GlobalAction)
SCREEN-AUTOMATOR-ERROR-008 TIME_OUT Le déclenchement de l'action globale a dépassé le délai autorisé

Complete JSON example

{
  "ScreenAutomator": [
    {
      "id": "1",
      "title": "Go Home",
      "Action_type": "GlobalAction",
      "GlobalAction_type": 10
    },
    {
      "id": "2",
      "title": "Open Notifications",
      "Action_type": "GlobalAction",
      "GlobalAction_type": 7
    },
    {
      "id": "3",
      "title": "Open Recents",
      "Action_type": "GlobalAction",
      "GlobalAction_type": 12
    },
    {
      "id": "4",
      "title": "Take Screenshot",
      "Action_type": "GlobalAction",
      "GlobalAction_type": 18
    }
  ]
}