API reference
API reference
Select your platform
No SDKs available
No versions available

IHandGrabUseDelegate Interface

Indicates that the implementing type is a delegate or handler for the "use" of a HandGrabUseInteractable.
Often, the "hand-grab-use" scenario does not require specializied interactors to enable: a virtual table, for example, can be poked while being grabbed by default, though for ergonomic reasons this must be done carefully if the grabbing and poking hands are the same. IHandGrabUseDelegate is specifically intended for scenarios where the secondary interactivity is both contingent upon and component to the initial interactivity. The canonical example of this is the "spray bottle" demo, where a bottle can be grabbed, then actuated with a finger motion to spray water. Since both interactions are done with the same hand and both are done using motions that more or less constitute "grabbing," representing this as a single grab interactable is impractical, motivating the independence of the "hand-grab-use" family of interactions.

Member Functions

Invoked when a HandGrabUseInteractable's secondary interactivity becomes actionable (i.e., when the interactable is selected by a HandGrabUseInteractor).
This is an internally-invoked method and should not be called directly.
Invoked when a HandGrabUseInteractable's secondary interactivity ceases to be actionable (i.e., when the interactable is unselected).
This is an internally-invoked method and should not be called directly.
Computes the "strength" of the secondary interactivity, where "strength" is a 0-to-1 value indicating whether the secondary interactivity is being lightly used or fully used, respectively.
In the "spray bottle" example, a "strength" of 0 would indicate that the spray lever is not depressed at all, whereas a "strength" of 1 indicates full depression of the lever.
Parameters
strength
A "raw strength" which the IHandGrabUseDelegate can use to inform its calculation of the true "strength"
Returns
The true "strength" of the secondary interactivity
Did you find this page helpful?
Thumbs up icon
Thumbs down icon