Difference between revisions of "Trigger: Proximity Sensor"
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| − | <pre | + | <pre class="header-style">The Proximity Sensor trigger fires when the device's proximity sensor detects changes in distance. This can be used to detect when something (like your hand or face) is near or far from the device, as well as wave gestures for hands-free control.</pre> |
| − | |||
| − | + | ''' Options ''' | |
| − | + | ||
| + | * '''Near''' - Fires when an object is detected close to the proximity sensor | ||
| + | * '''Far''' - Fires when the proximity sensor detects that an object has moved away | ||
| + | * '''Slow Wave''' - Fires when an object passes near the sensor with a wave gesture lasting 500ms or longer | ||
| + | * '''Fast Wave''' - Fires when an object passes near the sensor with a quick wave gesture under 500ms | ||
| + | |||
| + | ''' Examples ''' | ||
| + | |||
| + | ''Example 1: Silence phone when placed face down'' | ||
| + | |||
| + | <pre class="trigger-style">Triggers | ||
| + | |||
| + | Proximity Sensor: Near</pre> | ||
| + | <pre class="action-style">Actions | ||
| + | |||
| + | Set Ringer Mode: Vibrate Only</pre> | ||
| + | <pre class="constraint-style">Constraints | ||
| + | |||
| + | Device Orientation: Face Down</pre> | ||
| + | |||
| + | ''Example 2: Toggle flashlight with hand wave'' | ||
| + | |||
| + | <pre class="trigger-style">Triggers | ||
| + | |||
| + | Proximity Sensor: Fast Wave</pre> | ||
| + | <pre class="action-style">Actions | ||
| + | |||
| + | Toggle Flashlight</pre> | ||
| + | |||
| + | ''Example 3: Answer call with wave gesture'' | ||
| + | |||
| + | <pre class="trigger-style">Triggers | ||
| + | |||
| + | Proximity Sensor: Slow Wave</pre> | ||
| + | <pre class="action-style">Actions | ||
| + | |||
| + | Answer Call | ||
| + | Enable Speakerphone</pre> | ||
| + | <pre class="constraint-style">Constraints | ||
| + | |||
| + | Call State: Ringing</pre> | ||
| + | |||
| + | ''' Wave Gesture Detection ''' | ||
| + | |||
| + | Wave gestures work by detecting a near-to-far transition: | ||
| + | * The timer starts when an object moves near the sensor | ||
| + | * '''Fast Wave''': Completes if the object moves away within 500 milliseconds | ||
| + | * '''Slow Wave''': Completes if the object moves away after 500 milliseconds or more | ||
| + | |||
| + | ''' Notes ''' | ||
| + | |||
| + | * By default, this trigger only works when the device's screen is on | ||
| + | * You can enable the "Proximity sensor when screen off" setting in MacroDroid's trigger settings to allow detection when the screen is off | ||
| + | * Device compatibility varies - some manufacturers (notably Samsung) keep the proximity sensor deactivated except during specific activities like phone calls | ||
| + | * The proximity sensor is a binary sensor (near/far) on most devices, not a distance-measuring sensor | ||
| + | * For the trigger to fire, the state must actually change (e.g., from far to near) - it won't fire repeatedly while an object remains near | ||
| + | |||
| + | ''' See Also ''' | ||
| + | |||
| + | * [[Constraint: Proximity Sensor]] | ||
| + | * [[Trigger: Shake Device]] | ||
| + | * [[Trigger: Flip Device]] | ||
Latest revision as of 21:27, 6 January 2026
The Proximity Sensor trigger fires when the device's proximity sensor detects changes in distance. This can be used to detect when something (like your hand or face) is near or far from the device, as well as wave gestures for hands-free control.
Options
- Near - Fires when an object is detected close to the proximity sensor
- Far - Fires when the proximity sensor detects that an object has moved away
- Slow Wave - Fires when an object passes near the sensor with a wave gesture lasting 500ms or longer
- Fast Wave - Fires when an object passes near the sensor with a quick wave gesture under 500ms
Examples
Example 1: Silence phone when placed face down
Triggers Proximity Sensor: Near
Actions Set Ringer Mode: Vibrate Only
Constraints Device Orientation: Face Down
Example 2: Toggle flashlight with hand wave
Triggers Proximity Sensor: Fast Wave
Actions Toggle Flashlight
Example 3: Answer call with wave gesture
Triggers Proximity Sensor: Slow Wave
Actions Answer Call Enable Speakerphone
Constraints Call State: Ringing
Wave Gesture Detection
Wave gestures work by detecting a near-to-far transition:
- The timer starts when an object moves near the sensor
- Fast Wave: Completes if the object moves away within 500 milliseconds
- Slow Wave: Completes if the object moves away after 500 milliseconds or more
Notes
- By default, this trigger only works when the device's screen is on
- You can enable the "Proximity sensor when screen off" setting in MacroDroid's trigger settings to allow detection when the screen is off
- Device compatibility varies - some manufacturers (notably Samsung) keep the proximity sensor deactivated except during specific activities like phone calls
- The proximity sensor is a binary sensor (near/far) on most devices, not a distance-measuring sensor
- For the trigger to fire, the state must actually change (e.g., from far to near) - it won't fire repeatedly while an object remains near
See Also