Difference between revisions of "Actions"
| (42 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
| − | An action is something your device can do when a macro runs. A macro must have at least one action to be valid. | + | <pre style="background-color: #FFFF99; color: #112A46; border-radius: 10px; padding: 10px;"> |
| + | An action is something your device can do when a macro runs. | ||
| + | A macro must have at least one action to be valid. | ||
| + | </pre> | ||
| + | |||
| + | === Synchronous vs asynchronous === | ||
| + | <pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px;"> | ||
| + | MacroDroid actions typically execute quickly, but certain actions like HTTP requests or shell scripts may take longer. To ensure that subsequent actions wait for these longer actions to complete before continuing, enable the 'Block next action until complete' option in the action's configuration GUI. Otherwise, the action will run asynchronously while other actions continue. | ||
| + | |||
| + | In traditional programming languages, you could pass a callback function to execute after the asynchronous action is complete. This allows you to perform additional actions or work with the data returned by the asynchronous action. However, MacroDroid's inner workings are arbitrary, so there is no systematic option for this. Instead, you must rely on different workarounds. | ||
| + | </pre> | ||
| + | |||
| + | == Control flow == | ||
| + | |||
| + | [[Control flow: If clause|If clause]] | ||
| + | |||
| + | [[Control flow: If confirmed then|If confirmed then]] | ||
| + | |||
| + | [[Control flow: Repeat actions|Repeat actions]] | ||
| + | |||
| + | [[Control flow: Iterate Dictionary/Array| Iterate Dictionary/Array]] | ||
| + | |||
| + | [[Control flow: Break from loop|Break from loop]] | ||
| + | |||
| + | [[Control flow: Continue loop|Continue loop]] | ||
== List of Actions == | == List of Actions == | ||
| − | [[Airplane Mode On/Off]] | + | [[Action: Accessibility Service|Accessibility Service]] |
| + | |||
| + | [[Action: Action Block|Action Block]] | ||
| + | |||
| + | [[Action: Airplane Mode On/Off|Airplane Mode On/Off]] | ||
| + | |||
| + | [[Action: Alarm Clock|Alarm Clock]] | ||
| + | |||
| + | [[Action: Ambient Display|Ambient Display]] | ||
| + | |||
| + | [[Action: Animation Overlay|Animation Overlay]] | ||
| + | |||
| + | [[Action: Android Shortcut|Android Shortcut]] | ||
| + | |||
| + | [[Action: Android Wear|Android Wear]] | ||
| + | |||
| + | [[Action: Answer Call|Answer Call]] | ||
| + | |||
| + | [[Action: App Enable/Disable|App Enable/Disable]] | ||
| + | |||
| + | [[Action: Authenticate User|Authenticate User]] | ||
| + | |||
| + | [[Action: Array Manipulation|Array Manipulation]] | ||
| + | |||
| + | [[Action: Autosync On/Off|Autosync On/Off]] | ||
| + | |||
| + | [[Action: Battery Saver|Battery Saver]] | ||
| + | |||
| + | [[Action: Block Screen Touch|Screen Block Touch]] | ||
| + | |||
| + | [[Action: Bluetooth Configure|Bluetooth Configure]] | ||
| + | |||
| + | [[Action: Brightness|Brightness]] | ||
| + | |||
| + | [[Action: Calendar - Add Event|Calendar - Add Event]] | ||
| + | |||
| + | [[Action: Call Reject|Call Reject]] | ||
| + | |||
| + | [[Action: Camera Enable/Disable|Camera Enable/Disable]] | ||
| + | |||
| + | [[Action: Cancel Macro Actions|Cancel Macro Actions]] | ||
| + | |||
| + | [[Action: Car Mode|Car Mode]] | ||
| + | |||
| + | [[Action: Check Colour Pixel|Check Colour Pixel]] | ||
| + | |||
| + | [[Action: Check Text In Screenshot|Check Text In Screenshot]] | ||
| + | |||
| + | [[Action: Check Text On Screen|Check Text To Screen]] | ||
| + | |||
| + | [[Action: Clear App Data|Clear App Data]] | ||
| + | |||
| + | [[Action: Clear Call Log|Clear Call Log]] | ||
| + | |||
| + | [[Action: Clear Dictionary/Array Entry|Clear Dictionary/Array Entry]] | ||
| + | |||
| + | [[Action: Clear MacroDroid Dialog|Clear MacroDroid Dialog]] | ||
| + | |||
| + | [[Action: Clear Log|Clear Log]] | ||
| + | |||
| + | [[Action: Clear Notifications|Clear Notifications]] | ||
| + | |||
| + | [[Action: Clear Variables|Clear Variables]] | ||
| + | |||
| + | [[Action: Clipboard Refresh|Clipboard Refresh]] | ||
| + | |||
| + | [[Action: Configure App Notifications|Configure App Notifications]] | ||
| + | |||
| + | [[Action: Configure Quick Tile|Configure Quick Tile]] | ||
| + | |||
| + | [[Action: Confirm Next|Confirm Next]] | ||
| + | |||
| + | [[Action: Connectivity Check|Connectivity Check]] | ||
| + | |||
| + | [[Action: Contact Via App|Contact Via App]] | ||
| + | |||
| + | [[Action: Control Media|Control Media]] | ||
| − | [[ | + | [[Action: Dark Theme|Dark Theme]] |
| − | [[ | + | [[Action: Daydream/Screensaver On|Daydream/Screensaver On]] |
| − | [[ | + | [[Action: Delete Macro|Delete Macro]] |
| − | [[ | + | [[Action: Delete Variable|Delete Variable]] |
| − | [[ | + | [[Action: Demo Mode|Demo Mode]] |
| − | [[ | + | [[Action: Dim Screen|Dim Screen]] |
| − | [[ | + | [[Action: Disable MacroDroid|Disable MacroDroid]] |
| − | [[ | + | [[Action: Display Bubble Notification|Display Bubble Notification]] |
| − | [[ | + | [[Action: Display Dialog|Display Dialog]] |
| − | [[ | + | [[Action: Display Notification|Display Notification]] |
| − | [[ | + | [[Action: Empty Action|Empty Action]] |
| − | [[ | + | [[Action: Enable/Disable Category|Enable/Disable Category]] |
| − | [[ | + | [[Action: Enable/Disable Macro|Enable/Disable Macro]] |
| − | [[ | + | [[Action: Enable/Disable Trigger|Enable/Disable Trigger]] |
| − | [[ | + | [[Action: Exit Action Block|Exit Action Block]] |
| − | [[ | + | [[Action: Expand/Collapse Status Bar|Expand/Collapse Status Bar]] |
| − | [[ | + | [[Action: Export Log|Export Log]] |
| − | [[ | + | [[Action: Export Macros|Export Macros]] |
| − | [[ | + | [[Action: File Operation| File Operation]] |
| − | [[ | + | [[Action: Fill Clipboard|Fill Clipboard]] |
| − | [[ | + | [[Action: Floating Button Configure|Floating Button Configure]] |
| − | [[ | + | [[Action: Floating text|Floating text]] |
| − | [[ | + | [[Action: Font Scale|Font Scale]] |
| − | [[ | + | [[Action: Force Location Update|Force Location Update]] |
| − | [[ | + | [[Action: Force Screen Rotation|Force Screen Rotation]] |
| − | [[ | + | [[Action: Get Light Level|Get Light Level]] |
| − | [[ | + | [[Action: Get Text From View ID|Get Text From View ID]] |
| − | [[ | + | [[Action: GPS Enable/Disable|GPS Enable/Disable]] |
| − | [[ | + | [[Action: Heads-up Enable/Disable|Heads-up Enable/Disable]] |
| − | [[ | + | [[Action: HotSpot On/Off|HotSpot On/Off]] |
| − | [[ | + | [[Action: HTTP Request|HTTP Request]] |
| − | [[ | + | [[Action: HTTP Server|HTTP Server]] |
| − | [[ | + | [[Action: Immersive Mode|Immersive Mode]] |
| − | [[ | + | [[Action: JavaScript Code|JavaScript Code]] |
| − | [[ | + | [[Action: Invert Colours|Invert Colours]] |
| − | [[ | + | [[Action: JSON Parse|JSON Parse]] |
| − | [[ | + | [[Action: Keep Device Awake|Keep Device Awake]] |
| − | [[ | + | [[Action: Keyboard - Set Default|Keyboard - Set Default]] |
| − | [[ | + | [[Action: Keyboard Prompt|Keyboard Prompt]] |
| − | [[ | + | [[Action: Kill Application|Kill Application]] |
| − | [[ | + | [[Action: Kill Background Processes|Kill Background Processes]] |
| − | [[ | + | [[Action: Launch and Press|Launch and Press]] |
| − | [[ | + | [[Action: Launch Application|Launch Application]] |
| − | [[ | + | [[Action: Launch Home Screen|Launch Home Screen]] |
| − | [[ | + | [[Action: Launch Shortcut|Launch Shortcut]] |
| − | [[ | + | [[Action: Locale/Tasker Plugin|Locale/Tasker Plugin]] |
| − | [[ | + | [[Action: Location Mode|Location Mode]] |
| − | [[ | + | [[Action: Log Event|Log Event]] |
| − | [[ | + | [[Action: MacroDroid Drawer|MacroDroid Drawer]] |
| − | [[ | + | [[Action: MacroDroid Settings|MacroDroid Settings]] |
| − | [[ | + | [[Action: Macro run|Macro run]] |
| − | [[ | + | [[Action: Make Call|Make Call]] |
| − | [[ | + | [[Action: Mobile Data On/Off|Mobile Data On/Off]] |
| − | [[ | + | [[Action: NFC Enable/Disable|NFC Enable/Disable]] |
| − | [[ | + | [[Action: Notification Interaction|Notification Interaction]] |
| − | [[ | + | [[Action: Notification LED Enable/Disable|Notification LED Enable/Disable]] |
| − | [[ | + | [[Action: Notification Reply|Notification Reply]] |
| − | [[ | + | [[Action: Open Call Log|Open Call Log]] |
| − | [[ | + | [[Action: Open File|Open File]] |
| − | [[ | + | [[Action: Open Last Photo|Open Last Photo]] |
| − | [[MacroDroid | + | [[Action: Open MacroDroid Log|Open MacroDroid Log]] |
| − | [[ | + | [[Action: Open Website / HTTP GET|Open Website / HTTP GET]] |
| − | [[ | + | [[Action: Option Dialog|Option Dialog]] |
| − | [[ | + | [[Action: Play/Stop Sound|Play/Stop Sound]] |
| − | [[ | + | [[Action: Popup Message|Popup Message]] |
| − | [[ | + | [[Action: Press Back Button|Press Back Button]] |
| − | [[ | + | [[Action: Priority Mode / Do Not Disturb|Priority Mode / Do Not Disturb]] |
| − | [[ | + | [[Action: Read Screen Contents|Read Screen Contents]] |
| − | [[ | + | [[Action: Read Screenshot Contents|Read Screenshot Contents]] |
| − | [[ | + | [[Action: Reboot/Power Off|Reboot/Power Off]] |
| − | [[ | + | [[Action: Record Microphone|Record Microphone]] |
| − | [[ | + | [[Action: Restore Hidden Notifications|Restore Hidden Notifications]] |
| − | [[ | + | [[Action: Ringtone Configure|Ringtone Configure]] |
| − | [[ | + | [[Action: Say Current Time|Say Current Time]] |
| − | [[ | + | [[Action: Screen On/Off|Screen On/Off]] |
| − | [[ | + | [[Action: Secure Settings|Secure Settings]] |
| − | [[ | + | [[Action: Selecttion Dialog|Selection Dialog]] |
| − | [[ | + | [[Action: Send Email|Send Email]] |
| − | [[ | + | [[Action: Send Intent|Send Intent]] |
| − | [[ | + | [[Action: Send SMS|Send SMS]] |
| − | [[ | + | [[Action: Set Button Bar Image|Set Button Bar Image]] |
| − | [[ | + | [[Action: Set Location Update Rate|Set Location Update Rate]] |
| − | [[ | + | [[Action: Set Digital Assistant|Set Digital Assistant]] |
| − | [[ | + | [[Action: Set MacroDroid Icon|Set MacroDroid Icon]] |
| − | [[ | + | [[Action: Set MacroDroid Mode|Set MacroDroid Mode]] |
| − | [[Set | + | [[Action: Set MacroDroid Notification Text|Set MacroDroid Notification Text]] |
| − | [[Set | + | [[Action: Set Notification Sound|Set Notification Sound]] |
| − | [[Set | + | [[Action: Set Screen Lock|Set Screen Lock]] |
| − | [[Set | + | [[Action: Set Screen Timeout|Set Screen Timeout]] |
| − | [[Set | + | [[Action: Set Variable|Set Variable]] |
| − | [[Set | + | [[Action: Set Wallpaper|Set Wallpaper]] |
| − | [[ | + | [[Action: Share Last Photo|Share Last Photo]] |
| − | [[ | + | [[Action: Share Text|Share Text]] |
| − | [[ | + | [[Action: Share Location|Share Location]] |
| − | [[ | + | [[Action: Shell Script|Shell Script]] |
| − | [[ | + | [[Action: Silent - Vibrate Off|Silent - Vibrate Off]] |
| − | [[ | + | [[Action: Silent - Show Volume Popup|Show Volume Popup]] |
| − | [[ | + | [[Action: Speak Text|Speak Text]] |
| − | [[ | + | [[Action: Speakerphone On/Off|Speakerphone On/Off]] |
| − | [[ | + | [[Action: Stopwatch|Stopwatch]] |
| − | [[ | + | [[Action: Sync Account|Sync Account]] |
| − | [[ | + | [[Action: System Setting|System Setting]] |
| − | [[ | + | [[Action: Take Picture|Take Picture]] |
| − | [[ | + | [[Action: Take Screenshot|Take Screenshot]] |
| − | [[ | + | [[Action: Text Manipulation|Text Manipulation]] |
| − | [[ | + | [[Action: Torch On/Off|Torch On/Off]] |
| − | [[Text | + | [[Action: Translate Text|Translate Text]] |
| − | [[ | + | [[Action: Touch Screen|Touch Screen]] |
| − | [[ | + | [[Action: UDP Command|UDP Command]] |
| − | [[ | + | [[Action: UI Interaction|UI Interaction]] |
| − | [[ | + | [[Action: USB Tethering|USB Tethering]] |
| − | [[ | + | [[Action: Vibrate|Vibrate]] |
| − | [[ | + | [[Action: Vibrate Enable/Disable|Vibrate Enable/Disable]] |
| − | [[ | + | [[Action: Voice Input|Voice Input]] |
| − | [[ | + | [[Action: Voice Search|Voice Search]] |
| − | [[ | + | [[Action: Volume Change|Volume Change]] |
| − | [[Volume | + | [[Action: Volume Up/Down|Volume Up/Down]] |
| − | [[ | + | [[Action: Wait Before Next Action|Wait Before Next Action]] |
| − | [[Wait | + | [[Action: Wait Until Trigger|Wait Until Trigger]] |
| − | [[ | + | [[Action: WhatsApp Send|WhatsApp Send]] |
| − | [[Widget Button Modify]] | + | [[Action: Widget Button Modify|Widget Button Modify]] |
| − | [[Wifi Configure]] | + | [[Action: Wifi Configure|Wifi Configure]] |
| − | [[Write to File]] | + | [[Action: Write to File|Write to File]] |
Latest revision as of 17:36, 15 April 2024
An action is something your device can do when a macro runs. A macro must have at least one action to be valid.
Synchronous vs asynchronous
MacroDroid actions typically execute quickly, but certain actions like HTTP requests or shell scripts may take longer. To ensure that subsequent actions wait for these longer actions to complete before continuing, enable the 'Block next action until complete' option in the action's configuration GUI. Otherwise, the action will run asynchronously while other actions continue. In traditional programming languages, you could pass a callback function to execute after the asynchronous action is complete. This allows you to perform additional actions or work with the data returned by the asynchronous action. However, MacroDroid's inner workings are arbitrary, so there is no systematic option for this. Instead, you must rely on different workarounds.
Control flow
List of Actions
Notification LED Enable/Disable
Priority Mode / Do Not Disturb