feat(Interaction): add tracked controller colliders

The Controller Tracked Collider script provides a way of having
decoupled controller colliders from the actual controller GameObject.

This means that the tracked collider collection is not a child of the
controller GameObject so it does not have absolute 1:1 tracking. This
is useful as it means the colliders do not follow the controller to
every specific position and because it uses Rigidbody mechanics to
move the collider collection, the colliders interact within the Unity
physics system.

This results in being able to pass a controller through another
Rigidbody but the colliders for the controller won't pass through with
the controller, instead they will be restricted by the Unity physics
system.

The Controller Rigidbody Activator script has also been updated to
allow it to activate these new tracked controller colliders.

The Ignore Interact Touch Colliders script has also been updated to
ensure these tracked controller colliders are also included in the
ignore routine as they are effectively tied to the Interact Touch
collider set.

Author: thestonefox

Assets/VRTK/Documentation/API.md

@@ -164,11 +164,13 @@ Provides a simple trigger collider volume that when a controller enters will ena
  * Place the `VRTK/Prefabs/ControllerRigidbodyActivator/ControllerRigidbodyActivator` prefab in the scene at the location where the controller rigidbody should be automatically activated.
  * The prefab contains a default sphere collider to determine ths collision, this collider component can be customised in the inspector or can be replaced with another collider component (set to `Is Trigger`).
 
-  > If the prefab is placed as a child of the target interactable game object then the collider volume on the prefab will trigger collisions on the interactable object.
+  > If the prefab is placed as a child of the target Interactable Object then the collider volume on the prefab will trigger collisions on the Interactable Object.
 
 ### Inspector Parameters
 
- * **Is Enabled:** If this is checked then the collider will have it's rigidbody toggled on and off during a collision.
+ * **Is Enabled:** If this is checked then the Collider will have it's Rigidbody toggled on and off during a collision.
+ * **Activate Interact Touch:** If this is checked then the Rigidbody Activator will activate the rigidbody and colliders on the Interact Touch script.
+ * **Activate Tracked Collider:** If this is checked then the Rigidbody Activator will activate the rigidbody and colliders on the Controller Tracked Collider script.
 
 ### Class Events
 
@@ -3107,6 +3109,7 @@ A collection of scripts that provide the ability denote objects (such as control
  * [Interact Near Touch](#interact-near-touch-vrtk_interactneartouch)
  * [Interact Grab](#interact-grab-vrtk_interactgrab)
  * [Interact Use](#interact-use-vrtk_interactuse)
+ * [Controller Tracked Collider](#controller-tracked-collider-vrtk_controllertrackedcollider)
  * [Controller Highlighter](#controller-highlighter-vrtk_controllerhighlighter)
  * [Object Auto Grab](#object-auto-grab-vrtk_objectautograb)
 
@@ -3729,7 +3732,7 @@ Determines if the Interact Touch can initiate a grab with the touched Interactab
  * **Grab Button:** The button used to grab/release a touched Interactable Object.
  * **Grab Precognition:** An amount of time between when the grab button is pressed to when the controller is touching an Interactable Object to grab it.
  * **Throw Multiplier:** An amount to multiply the velocity of any Interactable Object being thrown.
- * **Create Rigid Body When Not Touching:** If this is checked and the Interact Touch is not touching an Interactable Object when the grab button is pressed then a rigid body is added to the interacting object to allow it to push other rigid body objects around.
+ * **Create Rigid Body When Not Touching:** If this is checked and the Interact Touch is not touching an Interactable Object when the grab button is pressed then a Rigidbody is added to the interacting object to allow it to push other Rigidbody objects around.
  * **Controller Attach Point:** The rigidbody point on the controller model to snap the grabbed Interactable Object to. If blank it will be set to the SDK default.
  * **Controller Events:** The Controller Events to listen for the events on. If the script is being applied onto a controller then this parameter can be left blank as it will be auto populated by the controller the script is on at runtime.
  * **Interact Touch:** The Interact Touch to listen for touches on. If the script is being applied onto a controller then this parameter can be left blank as it will be auto populated by the controller the script is on at runtime.
@@ -3910,6 +3913,56 @@ The AttemptUse method will attempt to use the currently touched Interactable Obj
 
 ---
 
+## Controller Tracked Collider (VRTK_ControllerTrackedCollider)
+ > extends VRTK_SDKControllerReady
+
+### Overview
+
+Provides a controller collider collection that follows the controller rigidbody via the physics system.
+
+**Required Components:**
+ * `VRTK_InteractTouch` - An Interact Touch script to determine which controller rigidbody to follow.
+
+**Optional Components:**
+ * `VRTK_ControllerEvents` - The events component to listen for the button presses on. This must be applied in the same object hierarchy as the Interact Touch script if one is not provided via the `Controller Events` parameter.
+
+**Script Usage:**
+ * Place the `VRTK_ControllerTrackedCollider` script on any active scene GameObject except the Script Alias objects.
+ * Assign the controller to track by applying an Interact Touch to the relevant Script Alias and then providing that reference to the `Interact Touch` parameter on this script.
+
+### Inspector Parameters
+
+ * **Interact Touch:** The Interact Touch script to relate the tracked collider to.
+ * **Max Resnap Distance:** The maximum distance the collider object can be from the controller before it automatically snaps back to the same position.
+ * **Activation Button:** The button to press to activate the colliders on the tracked collider set. If `Undefined` then it will always be active.
+ * **Controller Events:** An optional Controller Events to use for listening to the button events. If this is left blank then it will attempt to be retrieved from the same controller as the `Interact Touch` parameter.
+
+### Class Methods
+
+#### ToggleColliders/1
+
+  > `public virtual void ToggleColliders(bool state)`
+
+ * Parameters
+   * `bool state` - If `true` then the tracked colliders will be able to affect other Rigidbodies.
+ * Returns
+   * _none_
+
+The ToggleColliders method toggles the collision state of the tracked colliders.
+
+#### TrackedColliders/0
+
+  > `public virtual Collider[] TrackedColliders()`
+
+ * Parameters
+   * _none_
+ * Returns
+   * `Collider[]` - A Collider array of the tracked colliders.
+
+The TrackedColliders method returns an array of the tracked colliders.
+
+---
+
 ## Controller Highlighter (VRTK_ControllerHighlighter)
 
 ### Overview

Assets/VRTK/Prefabs/ControllerRigidbodyActivator/VRTK_ControllerRigidbodyActivator.cs

@@ -27,12 +27,16 @@ public struct ControllerRigidbodyActivatorEventArgs
     ///  * Place the `VRTK/Prefabs/ControllerRigidbodyActivator/ControllerRigidbodyActivator` prefab in the scene at the location where the controller rigidbody should be automatically activated.
     ///  * The prefab contains a default sphere collider to determine ths collision, this collider component can be customised in the inspector or can be replaced with another collider component (set to `Is Trigger`).
     ///
-    ///   > If the prefab is placed as a child of the target interactable game object then the collider volume on the prefab will trigger collisions on the interactable object.
+    ///   > If the prefab is placed as a child of the target Interactable Object then the collider volume on the prefab will trigger collisions on the Interactable Object.
     /// </remarks>
     public class VRTK_ControllerRigidbodyActivator : MonoBehaviour
     {
-        [Tooltip("If this is checked then the collider will have it's rigidbody toggled on and off during a collision.")]
+        [Tooltip("If this is checked then the Collider will have it's Rigidbody toggled on and off during a collision.")]
         public bool isEnabled = true;
+        [Tooltip("If this is checked then the Rigidbody Activator will activate the rigidbody and colliders on the Interact Touch script.")]
+        public bool activateInteractTouch = true;
+        [Tooltip("If this is checked then the Rigidbody Activator will activate the rigidbody and colliders on the Controller Tracked Collider script.")]
+        public bool activateTrackedCollider = false;
 
         /// <summary>
         /// Emitted when the controller rigidbody is turned on.
@@ -71,11 +75,27 @@ protected virtual void OnTriggerExit(Collider collider)
 
         protected virtual void ToggleRigidbody(Collider collider, bool state)
         {
-            VRTK_InteractTouch touch = collider.GetComponentInParent<VRTK_InteractTouch>();
-            if (touch != null && (isEnabled || !state))
+            if (isEnabled || !state)
             {
-                touch.ToggleControllerRigidBody(state, state);
-                EmitEvent(state, touch);
+                if (activateTrackedCollider)
+                {
+                    VRTK_ControllerTrackedCollider trackedCollider = collider.GetComponentInParent<VRTK_ControllerTrackedCollider>();
+                    if (trackedCollider != null)
+                    {
+                        trackedCollider.ToggleColliders(state);
+                        EmitEvent(state, trackedCollider.interactTouch);
+                    }
+                }
+
+                if (activateInteractTouch)
+                {
+                    VRTK_InteractTouch touch = collider.GetComponentInParent<VRTK_InteractTouch>();
+                    if (touch != null)
+                    {
+                        touch.ToggleControllerRigidBody(state, state);
+                        EmitEvent(state, touch);
+                    }
+                }
             }
         }
 

Assets/VRTK/Source/Scripts/Interactions/Interactables/VRTK_IgnoreInteractTouchColliders.cs

@@ -4,6 +4,7 @@ namespace VRTK
     using UnityEngine;
     using System.Collections;
     using System.Collections.Generic;
+    using System.Linq;
 
     /// <summary>
     /// Ignores the collisions between the given Interact Touch colliders and the colliders on the GameObject this script is attached to.
@@ -98,6 +99,11 @@ protected virtual bool ShouldExclude(Transform checkObject)
         protected virtual void ManageTouchCollision(VRTK_InteractTouch touchToIgnore, bool ignore)
         {
             Collider[] interactTouchColliders = touchToIgnore.ControllerColliders();
+            if (VRTK_ObjectCache.registeredTrackedColliderToInteractTouches.ContainsKey(touchToIgnore) && VRTK_ObjectCache.registeredTrackedColliderToInteractTouches[touchToIgnore] != null)
+            {
+                Collider[] trackedColliders = VRTK_ObjectCache.registeredTrackedColliderToInteractTouches[touchToIgnore].TrackedColliders();
+                interactTouchColliders = interactTouchColliders.Concat(trackedColliders).ToArray();
+            }
 
             for (int touchCollidersIndex = 0; touchCollidersIndex < interactTouchColliders.Length; touchCollidersIndex++)
             {

Assets/VRTK/Source/Scripts/Interactions/Interactors/VRTK_ControllerHighlighter.cs

@@ -1,4 +1,4 @@
-// Controller Highlighter|Interactors|30060
+// Controller Highlighter|Interactors|30070
 namespace VRTK
 {
     using UnityEngine;