Changes

no edit summary
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]]