Changes

no edit summary
Line 1: Line 1: −
<span style="color: #B22A2A; font-size: 24px; display: inline-block; margin-top: 15px; margin-bottom: 0px;"><strong>About this trigger</strong></span>
+
<pre class="header-style">This trigger will fire when a particular wifi network goes in or out of range. It monitors for wifi networks by SSID and can trigger macros when your device enters or leaves the coverage area of specific networks.</pre>
   −
<pre style="background-color: #ACC8E5; color: #112A46; border-radius: 10px; padding: 10px; margin-top: 5px; margin-bottom: 5px;">
+
''' Options '''
This trigger will fire when a particular wifi network goes in or out of range.
  −
</pre>
     −
<pre style="background-color: #FFFF99; color: #112A46; border-radius: 10px; padding: 10px; margin-top: 5px; margin-bottom: 5px;">
+
* '''In Range''': Trigger when the selected wifi network(s) become visible in a scan
Note that on Android 6 and above, location services must remain enabled on your device for this trigger to function.
+
* '''Out of Range''': Trigger when the selected wifi network(s) are no longer visible in a scan
</pre>
+
 
 +
''' Network Selection '''
 +
 
 +
* Select from a list of nearby wifi networks detected during scanning
 +
* Choose from previously configured wifi networks on your device
 +
* Manually enter an SSID name using the Add button
 +
* Multiple networks can be selected to trigger on any of them
 +
* Networks can be identified by SSID only or by SSID+BSSID for specific access points
 +
 
 +
''' Background Scanning '''
 +
 
 +
The trigger uses periodic wifi scans to detect network availability. The scan rate can be configured in MacroDroid settings. A value of 0 disables background scanning.
 +
 
 +
''' Requirements '''
 +
 
 +
* '''Location Permission''': ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions are required
 +
* '''Location Services''': On Android 6.0 (Marshmallow) and above, location services must be enabled for wifi scanning to work
 +
* '''Wifi Enabled''': Wifi must be enabled to perform network scans
 +
* '''Helper App''': On Android 10+ some features may require the MacroDroid Connectivity Helper or Universal Helper app
 +
 
 +
''' Examples '''
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Wifi SSID Transition (In Range: Home_Network)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Welcome Home
 +
Set Volume - Ringer: 100%</pre>
 +
 
 +
''Detect arrival home when the home wifi network comes into range.''
 +
 
 +
----
 +
 
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Wifi SSID Transition (Out of Range: Work_Wifi)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Variable: [at_work] = false
 +
Disable Do Not Disturb</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
Day of Week: Monday, Tuesday, Wednesday, Thursday, Friday</pre>
 +
 
 +
''Detect leaving work when the work wifi network goes out of range.''
 +
 
 +
''' Notes '''
 +
 
 +
* On Android 6.0 (Marshmallow) and above, location services must remain enabled on your device for this trigger to function. A warning dialog is displayed when configuring this trigger.
 +
* The trigger requires wifi to be enabled to perform scans. If wifi is disabled when configuring, you will be prompted to enable it.
 +
* Background scan frequency affects battery life - less frequent scans use less battery but may have delayed detection.
 +
* Multiple SSIDs can be selected, allowing the trigger to fire when any of the selected networks comes in or goes out of range.
 +
* For more precise detection, you can select specific access points by BSSID in addition to SSID.
 +
 
 +
''' See Also '''
 +
 
 +
* [[Trigger:_Wifi_State_Change|Wifi State Change Trigger]]
 +
* [[Constraint:_Wifi_State|Wifi State Constraint]]
 +
* [[Action:_Wifi_Configure|Wifi Configure Action]]