You can link some interactions to others in a primary-secondary relationship. This can be useful for making one interaction dependent on another ongoing interaction. For example, if you want to first grab and then use an object, a grab interaction could be a primary interaction and a use interaction could be secondary to the grab.

Two components are required to establish such a relationship between interactions.

A SecondaryInteractorConnection indicates that one interactor depends on another interactor. The dependent interactor is considered “secondary” to the “primary” interactor.

For example: In the HandGrabUseExamples scene, the SecondaryInteractorConnection links the HandGrabUseInteractor as a secondary interactor to the HandGrabInteractor.

The SecondaryInteractorFilter indicates that one interactable is secondary to a primary interactable. In addition to linking two interactables, this component acts as a filter and should be added to the secondary interactable’s Interactor Filter list.

By default, the SecondaryInteractorFilter enables the secondary interaction when hovering the primary interactable. By checking Select Required, the secondary interaction is only enabled when the primary interactable is selected.

For example: In the HandGrabUseExamples scene, you can grab the spray bottle at two different HandGrabInteractables, and then use it by squeezing the trigger with the index or middle finger.