| Line 1: |
Line 1: |
| | <pre class="header-style"> | | <pre class="header-style"> |
| − | This trigger will fire when the device detects you are performing a certain activity such as moving in a vehicle, riding a bicycle or running. You can set a confidence value to control how easily the trigger will fire. A low confidence value is more likely to trigger but could potentially result in false triggers. A higher value should avoid false triggers but could fail to trigger in some cases where it should. | + | This trigger fires when the device detects you are performing a particular physical activity with the specified confidence level. It uses Google Play Services to analyze sensor data and determine your current movement state. |
| | + | </pre> |
| | | | |
| − | The underlying functionality of the Activity Recognition trigger is provided by Google Play services. The reliability of the trigger may be improved by enabling bluetooth, Wi-Fi and location services as these are fed into the recognition algorithm.</pre>
| + | ''' Options ''' |
| | | | |
| − | '''Input parameters'''<br/>
| + | When configuring this trigger, select one of the following activities: |
| | | | |
| − | * Activity type | + | * '''In Vehicle''' - Traveling in a car, bus, train, or other motorized transport |
| − | Determines the type of activity to recognize and fire the trigger - In Vehicle | On Bicycle | Running | Walking | Still
| + | * '''On Bicycle''' - Riding a bicycle |
| | + | * '''Running''' - Running or jogging |
| | + | * '''Walking''' - Walking at a normal pace |
| | + | * '''Still''' - Stationary with minimal movement |
| | | | |
| − | * Confidence value
| + | ''' Confidence Level ''' |
| − | Determines sensitivity of the activity recognition. A low value may result in more false triggers and a high value may prevent the trigger from firing in some situations. (Percentage value)
| |
| | | | |
| − | '''Example Usage'''<br/> | + | Set a confidence threshold between '''10%''' and '''100%'''. This represents how certain the device must be that you are performing the selected activity before the trigger fires. |
| − | When the activity is recognized (in the vehicle) it connects to the car's bluetooth and will start the music on Spotify (if your music application is not active in the background, it may need additional configuration).
| |
| | | | |
| − | <pre class="trigger-style">
| + | * '''Lower values (30-50%)''' - Trigger fires more readily, but may produce false positives |
| − | Triggers
| + | * '''Higher values (70-90%)''' - More accurate detection, but may occasionally miss legitimate activity changes |
| | | | |
| − | Activity recognition (In vehicle) | + | ''' Comparison Mode ''' |
| − | </pre> | + | |
| | + | * '''Greater than or equal to (≥)''' - The trigger fires when confidence rises to or above your threshold. Use this to detect when an activity '''starts'''. |
| | + | * '''Less than (<)''' - The trigger fires when confidence drops below your threshold. Use this to detect when an activity '''ends'''. |
| | + | |
| | + | ''' Example 1: Auto-connect car Bluetooth and play music ''' |
| | + | |
| | + | When you get in your car, automatically enable Bluetooth and start playing music. |
| | + | |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Activity Recognition - In Vehicle (≥ 50%)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Set Bluetooth State (Enable Bluetooth) |
| | + | Wait (5 Seconds) |
| | + | Connect to Bluetooth Device (Car Stereo) |
| | + | Media Controls (Play)</pre> |
| | + | |
| | + | ''' Example 2: Disable Wi-Fi when leaving home on foot ''' |
| | + | |
| | + | When you start walking, disable Wi-Fi to save battery. |
| | + | |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Activity Recognition - Walking (≥ 60%)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Set Wi-Fi State (Disable Wi-Fi)</pre> |
| | + | <pre class="constraint-style">Constraints |
| | + | |
| | + | Wi-Fi Connected</pre> |
| | + | |
| | + | ''' Example 3: Log when you stop running ''' |
| | + | |
| | + | Detect when a run has ended by monitoring for confidence dropping below threshold. |
| | + | |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Activity Recognition - Running (< 50%)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Write To File - Append "{hour}:{minute}:{second} - Run ended" to exercise_log.txt</pre> |
| | + | |
| | + | ''' Example 4: Enable Do Not Disturb when stationary at work ''' |
| | + | |
| | + | Automatically silence your phone when you're sitting still at work. |
| | + | |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Activity Recognition - Still (≥ 70%)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Set Do Not Disturb Mode (Priority Only)</pre> |
| | + | <pre class="constraint-style">Constraints |
| | + | |
| | + | Location (At Work)</pre> |
| | + | |
| | + | ''' Tips for Reliability ''' |
| | + | |
| | + | * '''Enable location services''' - GPS and network location data feed into the recognition algorithm and improve accuracy |
| | + | * '''Enable Wi-Fi scanning''' - Even when not connected, Wi-Fi scanning helps identify location context |
| | + | * '''Enable Bluetooth''' - Bluetooth connections (e.g., car audio systems) can help confirm vehicle detection |
| | + | * '''Adjust the update rate''' - The polling interval can be configured in MacroDroid Settings → Activity Recognition Update Rate (default is 120 seconds). Lower values detect changes faster but use more battery. |
| | + | |
| | + | ''' Permissions ''' |
| | + | |
| | + | On Android 10 and above, this trigger requires the '''Activity Recognition''' permission. MacroDroid will prompt you to grant this permission when you add the trigger. |
| | + | |
| | + | ''' Notes ''' |
| | + | |
| | + | * The trigger will '''not''' fire repeatedly for the same activity. It only fires when the detected activity changes and crosses your confidence threshold. |
| | + | * When using '''greater than (≥)''' mode, the trigger fires when the selected activity becomes the most probable activity AND exceeds your confidence level. |
| | + | * When using '''less than (<)''' mode, the trigger fires when confidence for the selected activity drops below your threshold (useful for detecting when an activity has ended). |
| | + | * Detection accuracy depends on your device's sensors (accelerometer, gyroscope) and their quality. Some electric or very smooth vehicles may be harder to detect. |
| | + | * This trigger uses the [https://developers.google.com/location-context/activity-recognition Google Activity Recognition API] via Google Play Services. |
| | + | |
| | + | ''' Troubleshooting ''' |
| | + | |
| | + | * '''Trigger never fires''' - Lower the confidence threshold, ensure Google Play Services is installed and up to date |
| | + | * '''Too many false triggers''' - Increase the confidence threshold |
| | + | * '''Delayed detection''' - Reduce the Activity Recognition Update Rate in MacroDroid Settings |
| | + | * '''Vehicle not detected''' - Ensure location services are enabled; try lowering the confidence threshold |
| | | | |
| − | <pre class="action-style">
| + | ''' See Also ''' |
| − | Actions
| |
| | | | |
| − | Bluetooth configure (Connect audio device "My car")
| + | * [[Action:_MacroDroid_Settings|MacroDroid Settings Action]] - Can modify update rate |
| − | Control media (Simulate media button (Play)"Spotify")
| |
| − | </pre><br>
| |