MacroDroid Wiki

Changes

Trigger: Bluetooth Beacon (experimental) (view source)

Revision as of 21:45, 5 January 2026

2,067 bytes added ,  Monday at 21:45
no edit summary
Line 1: Line 1: −
<pre class="header-style">
+
<pre class="header-style">The Bluetooth Beacon trigger fires when your device comes within range of or moves out of range of a specified Bluetooth beacon. Bluetooth beacons are small wireless transmitters that broadcast signals, commonly used for indoor positioning and location-based automation.</pre>
−
This trigger can be configured to fire when you come in range of, or go out of range of a Bluetooth beacon.
     −
When selecting this trigger, a scan will be performed for any Bluetooth beacons that are in range and you will be able to select from any beacons found. You can also enter a beacon is manually if you know the details.
+
''' Options '''
   −
This trigger is experimental, so may not work reliably in all cases and with all beacon types.
+
* '''In Range''' - Trigger fires when the device comes within range of the specified beacon
−
</pre>
+
* '''Out of Range''' - Trigger fires when the device moves out of range of the specified beacon
 +
 
 +
''' Configuration '''
 +
 
 +
When configuring this trigger, MacroDroid will scan for nearby Bluetooth beacons. You can:
 +
 
 +
* Select a beacon from the list of detected beacons
 +
* Choose a previously configured beacon from the cached list
 +
* Manually add a beacon by entering its UUID
 +
* Assign a friendly name to beacons for easier identification
 +
 
 +
The beacon selection dialog shows:
 +
* Currently detected beacons at the top
 +
* Previously used beacons below
 +
* Option to manually add a beacon by entering its UUID
 +
 
 +
''' Examples '''
 +
 
 +
''Example 1: Welcome Home Automation''
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Bluetooth Beacon - In Range (Home Beacon)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Set Volume: Ring to 100%
 +
Disable Silent Mode</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
Time of Day: 5:00 PM - 11:00 PM</pre>
 +
 
 +
''Example 2: Leave Work Reminder''
 +
  <pre class="trigger-style">Triggers
 +
 
 +
Bluetooth Beacon - Out of Range (Office Beacon)</pre>
 +
  <pre class="action-style">Actions
 +
 
 +
Notification: Don't forget to clock out!</pre>
 +
  <pre class="constraint-style">Constraints
 +
 
 +
Day of Week: Mon-Fri</pre>
 +
 
 +
''' Notes '''
 +
 
 +
* The trigger uses the AltBeacon library for beacon detection
 +
* Beacons are identified by their UUID (Universally Unique Identifier)
 +
* Previously used beacons are cached for easy access even when not currently in range
 +
* The beacon scan may take a few seconds to complete
 +
* Location services must be enabled for beacon detection to work
 +
* The trigger monitors specific beacon UUIDs using region-based monitoring for efficiency
 +
 
 +
''' Permissions Required '''
 +
 
 +
* '''Location Permission''' - Required for Bluetooth beacon scanning (ACCESS_FINE_LOCATION, ACCESS_COARSE_LOCATION)
 +
* '''Bluetooth Scan Permission''' - Required on Android 12+ (BLUETOOTH_SCAN)
 +
* '''Bluetooth Connect Permission''' - Required on Android 12+ (BLUETOOTH_CONNECT)
 +
* Location services must be enabled on the device
 +
 
 +
''' See Also '''
 +
 
 +
* [[Trigger:_Bluetooth_Event|Bluetooth Event Trigger]]
 +
* [[Trigger:_Geofence|Geofence Trigger]]
Retrieved from ‘https://macrodroidforum.com/wiki/index.php/Special:MobileDiff/2939’