Changes

no edit summary
Line 1: Line 1: −
<pre style="background-color: #EEEEEE; color: Black; border-radius: 10px; padding: 10px;">
+
<pre class="header-style">This trigger can be used to fire when a Tasker/Locale plugin has its condition met. MacroDroid acts as a host application for third-party Locale/Tasker plugins, allowing you to use condition and event plugins from other apps as triggers.</pre>
+
 
This trigger can be used to fire when a Locale/Tasker plugin has its condition met.
+
''' Options '''
+
 
</pre>
+
* '''Plugin Selection''': Choose from available Locale/Tasker condition or event plugins installed on your device
 +
* '''Plugin Configuration''': Each plugin provides its own configuration interface specific to its functionality
 +
* '''Invert Condition''': For condition-type plugins, optionally invert the condition (trigger when condition is NOT met)
 +
* '''Variable Mapping''': Map plugin output variables to MacroDroid variables
 +
* '''Array Handling''': Choose how to handle array values from plugins:
 +
** Use first element
 +
** Use all elements
 +
 
 +
''' Plugin Types '''
 +
 
 +
* '''Condition Plugins''': These plugins are periodically polled to check if their condition is met. They can transition between satisfied and unsatisfied states.
 +
* '''Event Plugins''': These plugins fire when specific events occur. They are one-shot triggers that don't have an ongoing state.
 +
 
 +
''' Configuration '''
 +
 
 +
When adding this trigger:
 +
1. A list of installed Locale/Tasker plugins is displayed
 +
2. Select the desired plugin
 +
3. The plugin's own configuration screen is launched
 +
4. Configure the plugin according to its specific options
 +
5. For condition plugins, optionally enable "Invert Condition" to trigger when the condition is NOT met
 +
6. Map any plugin variables to MacroDroid variables if available
 +
 
 +
''' Examples '''
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Tasker/Locale Plugin: AutoLocation (At Work)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Do Not Disturb: Priority only
 +
Set Wifi: Off</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
Time of Day: 09:00 - 17:00</pre>
 +
 
 +
''Use AutoLocation plugin to detect arrival at work and adjust settings.''
 +
 
 +
----
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Tasker/Locale Plugin: AutoVoice (Voice command received)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Speak Text: Command received: [plugin_variable]
 +
Run Macro: Handle Voice Command</pre>
 +
 
 +
''Process voice commands from AutoVoice plugin.''
 +
 
 +
''' Notes '''
 +
 
 +
* The plugin app must be installed on your device for the trigger to work.
 +
* If a plugin app is uninstalled, MacroDroid will show a warning when editing the macro.
 +
* Clicking on the warning will open Google Play to reinstall the missing plugin.
 +
* Plugin variables can be mapped to MacroDroid variables for use in actions.
 +
* Condition plugins are polled periodically; the state transitions from unsatisfied to satisfied.
 +
* Event plugins fire immediately when their event occurs.
 +
* Some popular compatible plugins include: AutoLocation, AutoVoice, AutoNotification, AutoInput, and many others in the "Auto" family.
 +
 
 +
''' See Also '''
 +
 
 +
* [[Action:_Tasker/Locale_Plugin|Tasker/Locale Plugin Action]]
 +
* [[Trigger:_Intent_Received|Intent Received Trigger]]