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 Globpatternenthält.Boolean click(Number x, Number y)
Klickt das Element an der definierten Koordinate an.Boolean clickById(String id)
Klickt das Element mit der definiertenidan. (Android 4.3+)Boolean clickByIdAndIndex(String id, Number index)
Klickt das n-te Element mit der definiertenidan. (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 Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 definiertenidaktiv ist. (Android 4.3+)Boolean isCheckedByIdAndIndex(String id, Number index)
Prüft ob das n-te Element mit der definiertenidaktiv ist. (Android 4.3+)Boolean uncheck(String pattern)
Deaktiviert das Element an, welches das Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 Globpatternenthä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 definiertenidauf. (Android 4.4+)Boolean expandByIdAndIndex(String id, Number index)
Klappt das n-te Element mit der definiertenidauf. (Android 4.4+)Boolean collapse(String pattern)
Klappt das Element zu, welches das Globpatternenthä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 Globpatternenthä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 definiertenidaus. (Android 4.3+)Boolean cutByIdAndIndex(String id, Number index)
Schneidet den Text des n-ten Elementes mit der definiertenidaus. (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 Globpatternenthä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 Globpatternenthä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 definiertenidein. (Android 4.3+)Boolean pasteByIdAndIndex(String id, Number index)
Fügt Text in das n-te Element mit der definiertenidein. (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 Globpatternenthä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 definiertenidein. (Android 4.3+)Boolean setSelection2ByIdAndIndex(String id, Number index, Number start, Number end)
Setzt die Selektion des n-ten Elementes mit der definiertenidein. (Android 4.3+)Boolean dismiss(String pattern)
Schliesst das Element, welches das Globpatternenthä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 Globpatternenthä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 definiertenidzurück. (Android 4.3+)String getTextByIdAndIndex(String id, Number index)
Gibt den Text des n-ten Elementes mit der definiertenidzurü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 Globpatternenthä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 definiertenidzurück. (Android 4.3+)String getContentDescriptionByIdAndIndex(String id, Number index)
Gibt die Content Description des n-ten Elementes mit der definiertenidzurü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 Globpatternenthä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 Globpatternenthä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 definiertenidzurü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 definiertenidzurü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 definiertenidauf dem aktiven Fenster existiert. (Android 4.3+)Boolean existsElementByIdAndIndex(String id, Number index)
Prüft ob das n-te Element mit der definiertenidauf dem aktiven Fenster existiert. (Android 4.3+)Number getNumberOfElementsWithId(String id)
Gibt die Anzahl der Elemente mit der definiertenidauf 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).