Difference between revisions of "Trigger: Device Docked/Undocked"

 
Line 1: Line 1:
 
<pre class="header-style">
 
<pre class="header-style">
This trigger can be configured to fire when a device is placed in or removed from a dock. You can select to allow any type of dock or restrict to only desk or car docks.
+
This trigger will fire when the device is docked or undocked. For docking events, you can also specify the type of dock (desk or car).
 
</pre>
 
</pre>
 +
 +
''' Options '''
 +
 +
* '''Any Dock''' - The trigger fires when the device is docked to any type of dock (desk, car, or other).
 +
 +
* '''Desk Dock''' - The trigger fires only when the device is docked to a desk dock.
 +
 +
* '''Car Dock''' - The trigger fires only when the device is docked to a car dock.
 +
 +
* '''Undocked''' - The trigger fires when the device is removed from any dock.
 +
 +
''' Examples '''
 +
 +
Example 1: Enable car mode when in car dock
 +
 +
  <pre class="trigger-style">Triggers
 +
 +
Device Docked/Undocked [Car Dock]</pre>
 +
  <pre class="action-style">Actions
 +
 +
Bluetooth On
 +
Launch Application: Android Auto
 +
Set Volume: Media 100%</pre>
 +
 +
Example 2: Start charging display when docked at desk
 +
 +
  <pre class="trigger-style">Triggers
 +
 +
Device Docked/Undocked [Desk Dock]</pre>
 +
  <pre class="action-style">Actions
 +
 +
Set Brightness: 50%
 +
Launch Application: Clock (Daydream)</pre>
 +
 +
Example 3: Restore normal settings when undocked
 +
 +
  <pre class="trigger-style">Triggers
 +
 +
Device Docked/Undocked [Undocked]</pre>
 +
  <pre class="action-style">Actions
 +
 +
Set Brightness: Auto
 +
Set Volume: Media 50%</pre>
 +
 +
''' Notes '''
 +
 +
* The dock type is determined by the Android system based on the dock hardware.
 +
* Not all docks report their type correctly - some may report as "desk" dock when they are car docks or vice versa.
 +
* This trigger listens for the ACTION_DOCK_EVENT system broadcast.
 +
* Wireless charging stands may not trigger dock events unless they are specifically designed to report as docks.
 +
 +
''' See Also '''
 +
 +
* [[Trigger:_Daydream_On/Off|Daydream On/Off Trigger]]
 +
* [[Trigger:_Power_Connected/Disconnected|Power Connected/Disconnected Trigger]]

Latest revision as of 22:44, 5 January 2026

This trigger will fire when the device is docked or undocked. For docking events, you can also specify the type of dock (desk or car).

Options

  • Any Dock - The trigger fires when the device is docked to any type of dock (desk, car, or other).
  • Desk Dock - The trigger fires only when the device is docked to a desk dock.
  • Car Dock - The trigger fires only when the device is docked to a car dock.
  • Undocked - The trigger fires when the device is removed from any dock.

Examples

Example 1: Enable car mode when in car dock

Triggers

Device Docked/Undocked [Car Dock]
Actions

Bluetooth On
Launch Application: Android Auto
Set Volume: Media 100%

Example 2: Start charging display when docked at desk

Triggers

Device Docked/Undocked [Desk Dock]
Actions

Set Brightness: 50%
Launch Application: Clock (Daydream)

Example 3: Restore normal settings when undocked

Triggers

Device Docked/Undocked [Undocked]
Actions

Set Brightness: Auto
Set Volume: Media 50%

Notes

  • The dock type is determined by the Android system based on the dock hardware.
  • Not all docks report their type correctly - some may report as "desk" dock when they are car docks or vice versa.
  • This trigger listens for the ACTION_DOCK_EVENT system broadcast.
  • Wireless charging stands may not trigger dock events unless they are specifically designed to report as docks.

See Also