Action - Steuere UI
Die Action Steuere UI verwendet die Accessibility Funktionen des Gerätes um die Benutzeroberfläche automatisch zu steuern und z.B. Knöpfe zu drücken, Elemente anzuklicken, in Listen zu scrollen und Radiobuttons und Checkboxen umzuschalten.
Hinweis: Diese Action steuert die Benutzeroberfläche indem Benutzereingaben simuliert werden. Das Display muss eingeschaltet sein und das Gerät muss entsperrt sein, damit die Benutzeroberfläche gesteuert werden kann.
Der Accessibility Dienst von Automagic muss in den Einstellungen des Geräts aktiviert sein, damit die Action funktioniert. Mindestens Android 4.1 (Jelly Bean) wird vorausgesetzt.
Hinweis: Auf einigen Geräten ist es nicht möglich, den Accessibility Dienst von Automagic zu aktivieren, wenn eine Displayfilter-App ein Overlay über den Steuerelementen anzeigt. Bitte deaktiviere solche Apps vorübergehend, wenn der OK-Knopf in den Systemeinstellungen nicht gedrückt werden kann.
Beispiele:
- Starte die Einstellungen der Standortdienste und aktiviere/deaktiviere GPS.
- Starte den Updateprüfung des Geräts, indem der "Jetzt prüfen" Knopf gedrückt wird.
Siehe Action Script für eine Beschreibung der grundlegenden Features der Skriptsprache.
Warnung: Die folgenden Beispiele sind stark auf ein spezifisches Gerät angepasst! Bitte kopiere die Skripts nicht unverändert auf dein Gerät, es könnten sonst die falschen Steuerelemente gedrückt werden.
Alle Benachrichtigungen entfernen:
notifications();//um die Benachrichtigungen zu expandieren sleep(1000);//eine Sekunde warten bis alle Animationen beendet sind clicked = click("Clear all notifications");//klickt den Löschknopf if(not clicked) //prüfe ob der Knopf gedrückt werden konnte { back();//Benachrichtigungen ausblenden, wenn der Löschknopf nicht gedrückt werden konnte }GPS ein-/ausschalten:
Verwende eine Action App starten: Einstellungen/Standortdienste um direkt die GPS Einstellungen anzuzeigen.
sleep(1000);//warte eine Sekunde bis die Einstellungen angezeigt werden click("GPS-Satelliten");//Einstellung umschalten sleep(500); back();//Zurück zum AusgangspunktÖffnen des Apps-Bildschirms:
home();//Sicherstellen, dass der Startbildschirm angezeigt wird sleep(1000);//eine Sekunde warten bis alle Animationen beendet sind click("Apps");//Apps öffnen
Boolean sleep(Number milliseconds)
Wartet für die angegebene AnzahlMillisekunden
.Boolean sleep(String duration)
Wartet für die angegebene AnzahlMillisekunden
.Boolean back()
Drückt die Zurück-Taste.Boolean home()
Drückt die Home-Taste.Boolean notifications()
Expandiert die Statusbar.Boolean quickSettings()
Öffnet die Schnelleinstellungen der Statusbar.Boolean recents()
Öffnet die Liste der zuletzt verwendeten Applikationen.Boolean powerDialog()
Öffnet den Power Long-Press Dialog. (Android 5+)Boolean toggleSplitScreen()
Schaltet den Split-Screen Modus um. (Android 7+)Boolean lockScreen()
Sperrt den Bildschirm. (Android 9+)Boolean takeScreenshot()
Erstellt einen Screenshot. (Android 9+)Boolean click(String pattern)
Klickt das Element an, welches das Globpattern
enthält.Boolean click(Number x, Number y)
Klickt das Element an der definierten Koordinate an.Boolean clickById(String id)
Klickt das Element mit der definiertenid
an. (Android 4.3+)Boolean clickByIdAndIndex(String id, Number index)
Klickt das n-te Element mit der definiertenid
an. (Android 4.3+)Boolean touchGesture(Number startMillis, Number endMillis, List coordinates, ...)
Simuliert Touchscreen Eingabe indem die Koordinaten in der gegebenen Zeit abgespielt werden. (Android 7+)Boolean longclick(String pattern)
Long-klickt das Element an, welches das Globpattern
enthält.Boolean longclick(Number x, Number y)
Long-klickt das Element an der definierten Koordinate an.Boolean longclickById(String id, Number index)
Long-klickt das Element mit der definiertenid
. (Android 4.3+)Boolean longclickByIdAndIndex(String id, Number index)
Long-klickt das n-te Element mit der definiertenid
. (Android 4.3+)Boolean check(String pattern)
Aktiviert das Element, welches das Globpattern
enthält.Boolean check(Number x, Number y)
Aktiviert das Element an der definierten Koordinate.Boolean checkById(String id, Number index)
Aktiviert das Element mit der definiertenid
. (Android 4.3+)Boolean checkByIdAndIndex(String id, Number index)
Aktiviert das n-te Element mit der definiertenid
. (Android 4.3+)Boolean isChecked(String pattern)
Prüft ob das Element aktiv ist, welches das Globpattern
enthält.Boolean isChecked(Number x, Number y)
Prüft ob das Element an der definierten Koordinate aktiv ist.Boolean isCheckedById(String id)
Prüft ob das Element mit der definiertenid
aktiv ist. (Android 4.3+)Boolean isCheckedByIdAndIndex(String id, Number index)
Prüft ob das n-te Element mit der definiertenid
aktiv ist. (Android 4.3+)Boolean uncheck(String pattern)
Deaktiviert das Element an, welches das Globpattern
enthält.Boolean uncheck(Number x, Number y)
Deaktiviert das Element an der definierten Koordinate.Boolean uncheckById(String id)
Deaktiviert das Element mit der definiertenid
. (Android 4.3+)Boolean uncheckByIdAndIndex(String id, Number index)
Deaktiviert das n-te Element mit der definiertenid
. (Android 4.3+)Boolean scrollForward(String pattern)
Scrollt das Element, welches das Globpattern
enthält.Boolean scrollForward(Number x, Number y)
Scrollt das Element an der definierten Koordinate.Boolean scrollForwardById(String id)
Scrollt das Element mit der definiertenid
. (Android 4.3+)Boolean scrollForwardByIdAndIndex(String id, Number index)
Scrollt das n-te Element mit der definiertenid
. (Android 4.3+)Boolean scrollBackward(String pattern)
Scrollt das Element, welches das Globpattern
enthält.Boolean scrollBackward(Number x, Number y)
Scrollt das Element an der definierten Koordinate.Boolean scrollBackwardById(String id)
Scrollt das Element mit der definiertenid
. (Android 4.3+)Boolean scrollBackwardByIdAndIndex(String id, Number index)
Scrollt das n-te Element mit der definiertenid
. (Android 4.3+)Boolean select(String pattern)
Selektiert das Element, welches das Globpattern
enthält.Boolean select(Number x, Number y)
Selektiert das Element an der definierten Koordinate.Boolean selectById(String id)
Selektiert das Element mit der definiertenid
. (Android 4.3+)Boolean selectByIdAndIndex(String id, Number index)
Selektiert das n-te Element mit der definiertenid
. (Android 4.3+)Boolean clearSelection(String pattern)
Deselektiert das Element, welches das Globpattern
enthält.Boolean clearSelection(Number x, Number y)
Deselektiert das Element an der definierten Koordinate.Boolean clearSelectionById(String id)
Deselektiert das Element mit der definierten idid
. (Android 4.3+)Boolean clearSelectionByIdAndIndex(String id, Number index)
Deselektiert das n-te Element mit der definierten idid
. (Android 4.3+)Boolean focus(String pattern)
Fokussiert das Element, welches das Globpattern
enthält.Boolean focus(Number x, Number y)
Fokussiert das Element an der definierten Koordinate.Boolean focusById(String id)
Fokussiert das Element mit der definiertenid
. (Android 4.3+)Boolean focusByIdAndIndex(String id, Number index)
Fokussiert das n-te Element mit der definiertenid
. (Android 4.3+)Boolean expand(String pattern)
Klappt das Element auf, welches das Globpattern
enthält. (Android 4.4+)Boolean expand(Number x, Number y)
Klappt das Element an der definierten Koordinate auf. (Android 4.4+)Boolean expandById(String id)
Klappt das Element mit der definiertenid
auf. (Android 4.4+)Boolean expandByIdAndIndex(String id, Number index)
Klappt das n-te Element mit der definiertenid
auf. (Android 4.4+)Boolean collapse(String pattern)
Klappt das Element zu, welches das Globpattern
enthält. (Android 4.4+)Boolean collapse(Number x, Number y)
Klappt das Element an der definierten Koordinate zu. (Android 4.4+)Boolean cut()
Schneidet den Text des fokussierten Elementes aus. (Android 4.3+)Boolean cut(String pattern)
Schneidet den Text des Elementes aus, welches das Globpattern
enthält. (Android 4.3+)Boolean cut(Number x, Number y)
Schneidet den Text des Elementes an der definierten Koordinate aus. (Android 4.3+)Boolean cutById(String id)
Schneidet den Text des Elementes mit der definiertenid
aus. (Android 4.3+)Boolean cutByIdAndIndex(String id, Number index)
Schneidet den Text des n-ten Elementes mit der definiertenid
aus. (Android 4.3+)Boolean copy()
Kopiert den Text des fokussierten Elementes. (Android 4.3+)Boolean copy(String pattern)
Kopiert den Text des Elementes, welches das Globpattern
enthält. (Android 4.3+)Boolean copy(Number x, Number y)
Kopiert den Text des Elementes an der definierten Koordinate. (Android 4.3+)Boolean copyById(String id)
Kopiert den Text des Elementes mit der definiertenid
. (Android 4.3+)Boolean copyByIdAndIndex(String id, Number index)
Kopiert den Text des n-ten Elementes mit der definiertenid
. (Android 4.3+)Boolean paste()
Fügt Text in das fokussierte Element ein. (Android 4.3+)Boolean paste(String pattern)
Fügt Text in das Element ein, welches das Globpattern
enthält. (Android 4.3+)Boolean paste(Number x, Number y)
Fügt Text in das Element an der definierten Koordinate ein. (Android 4.3+)Boolean pasteById(String id)
Fügt Text in das Element mit der definiertenid
ein. (Android 4.3+)Boolean pasteByIdAndIndex(String id, Number index)
Fügt Text in das n-te Element mit der definiertenid
ein. (Android 4.3+)Boolean setSelection2(Number start, Number end)
Setzt die Selektion des fokussierten Elementes auf den gewählten Bereich. (Android 4.3+)Boolean setSelection2(String pattern, Number start, Number end)
Setzt die Selektion des Elementes, welches das Globpattern
enthält. (Android 4.3+)Boolean setSelection2(Number x, Number y, Number start, Number end)
Setzt die Selektion des Elementes an der definierten Koordinate ein. (Android 4.3+)Boolean setSelection2ById(String id, Number start, Number end)
Setzt die Selektion des Elementes mit der definiertenid
ein. (Android 4.3+)Boolean setSelection2ByIdAndIndex(String id, Number index, Number start, Number end)
Setzt die Selektion des n-ten Elementes mit der definiertenid
ein. (Android 4.3+)Boolean dismiss(String pattern)
Schliesst das Element, welches das Globpattern
enthält. (Android 4.4+)Boolean dismiss(Number x, Number y)
Schliesst das Element an der definierten Koordinate. (Android 4.4+)Boolean dismissById(String id)
Schliesst das Element mit der definiertenid
. (Android 4.4+)Boolean dismissByIdAndIndex(String id, Number index)
Schliesst das n-te Element mit der definiertenid
. (Android 4.4+)String getText()
Gibt den Text das fokussierten Elementes zurück.String getText(String pattern)
Gibt den Text das Elementes zurück, welches das Globpattern
enthält.String getText(Number x, Number y)
Gibt den Text des Elementes an der definierten Koordinate zurück.String getTextById(String id)
Gibt den Text des Elementes mit der definiertenid
zurück. (Android 4.3+)String getTextByIdAndIndex(String id, Number index)
Gibt den Text des n-ten Elementes mit der definiertenid
zurück. (Android 4.3+)String getContentDescription()
Gibt die Content Description des fokussierten Elementes zurück.String getContentDescription(String pattern)
Gibt die Content Description des Elementes zurück, welches das Globpattern
enthält.String getContentDescription(Number x, Number y)
Gibt die Content Description des Elementes an der definierten Koordinate zurück.String getContentDescriptionById(String id)
Gibt die Content Description des Elementes mit der definiertenid
zurück. (Android 4.3+)String getContentDescriptionByIdAndIndex(String id, Number index)
Gibt die Content Description des n-ten Elementes mit der definiertenid
zurück. (Android 4.3+)String getTextInActiveWindow()
Gibt den Text aller Elemente zurück. Die Reihenfolge der Textelemente kann von der visuellen Position abweichen.String getContentDescriptionInActiveWindow()
Gibt die Content Description aller Elemente. Die Reihenfolge der Textelemente kann von der visuellen Position abweichen.Boolean setText2(String pattern, String text)
Setzt den Text des Elementes, welches das Globpattern
enthält. (Android 5+)Boolean setText2(Number x, Number y, String text)
Setzt den Text des Elementes an der definierten Koordinate. (Android 5+)Boolean setText2ById(String id, String text)
Setzt den Text des Elementes mit der definiertenid
. (Android 5+)Boolean setText2ByIdAndIndex(String id, Number index, String text)
Setzt den Text des n-ten Elementes mit der definiertenid
. (Android 5+)List getBounds(String pattern)
Gibt die Position und Grösse des Elementes zurück, welches das Globpattern
enthält. Die Liste enthält die Werte [X, Y, Breite, Höhe].List getBoundsById(String id)
Gibt die Position und Grösse des Elementes mit der definiertenid
zurück. Die Liste enthält die Werte [X, Y, Breite, Höhe]. (Android 4.3+)List getBoundsByIdAndIndex(String id, Number index)
Gibt die Position und Grösse des n-ten Elementes mit der definiertenid
zurück. Die Liste enthält die Werte [X, Y, Breite, Höhe]. (Android 4.3+)Boolean existsElementById(String id)
Prüft ob das Element mit der definiertenid
auf dem aktiven Fenster existiert. (Android 4.3+)Boolean existsElementByIdAndIndex(String id, Number index)
Prüft ob das n-te Element mit der definiertenid
auf dem aktiven Fenster existiert. (Android 4.3+)Number getNumberOfElementsWithId(String id)
Gibt die Anzahl der Elemente mit der definiertenid
auf dem aktiven Fenster zurück. (Android 4.3+)Boolean sendKey(Number keyCode)
Simuliert die angegebene Taste (Automagic Eingabemethode wird benötigt).Boolean sendKey(String keyCodeName)
Simuliert die angegebene Taste (Automagic Eingabemethode wird benötigt).Boolean sendKey(String keyCodeName, String metaKey, ...)
Simuliert die angegebene Taste und Meta-Status(Automagic Eingabemethode wird benötigt).Boolean sendText(String text)
Sendet den Text an die fokussierte Komponente (Automagic Eingabemethode wird benötigt).Boolean setText(String text)
Setzt den Text der fokussierten Komponente (Automagic Eingabemethode wird benötigt).Boolean setSelection(Number start, Number end)
Setzt die Selektion der fokussierten Komponente (Automagic Eingabemethode wird benötigt).List getSelection()
Gibt die Start- und Endposition des Cursors zurück. Die Liste enthält die Werte [Start, Ende] (Automagic Eingabemethode wird benötigt).Boolean selectAll()
Selektiert den Text der fokussierten Komponente (Automagic Eingabemethode wird benötigt).