Before we can enable Direct Touch on a Unity canvas, PokeInteraction needs to be configured on your input rig. See the PokeInteraction section for details.

To make a Poke Interactable Unity canvas, we first start with a world space Canvas GameObject. You may skip the next section if you have an existing canvas you wish to convert to Poke Interaction.

To create a new World Space Canvas in your scene, right click in the Hierarchy view and select UI/Canvas from the right click menu. Then set the canvas to World Space. You will likely need to scale this canvas down significantly; X/Y/Z scale values around 0.0003 are generally a good starting point.

Your hierarchy should now look like this:

We will start our component wiring on the top level object. Configure your components as follows:

SurfacePatch references the ClippedPlaneSurface component on the Surface GameObject.

PointableElement references the PointableCanvas on this GameObject, configured below.

See PokeInteractable for more information on this component

Canvas references the Unity Canvas on the child object.

See PointableCanvas for more information on this component

Plane Surface references the PlaneSurface component on the top level object. Clippers should contain the BoundsClipper component on this object.

The BoundsClipper transform should be sized and/or scaled to encompass the Canvas, with a z depth that encompasses the backing plane. This will define the touch area of the canvas, serving as a collision plane for the Poke.

Refer to the Curved UI topic to set up a curved canvas hierarchy.

Your hierarchy should now look like this:

We will start our component wiring on the top level object. Configure your components as follows:

SurfacePatch references the ClippedCylinderSurface component on the Surface GameObject.

PointableElement references the PointableCanvas on this GameObject, configured below.

See PokeInteractable for more information on this component

Pointable references the PokeInteractable on this GameObject, configured above.

Canvas references the Canvas on the child object.

See PointableCanvas for more information on this component

Canvas Mesh references the CanvasCylinder on the child object. Forward Element references the PointableCanvas on this GameObject, configured above.

See PointableCanvasMesh for more information on this component.

Cylinder Surface references the CylinderSurface on the top level GameObject. Clippers should contain the CanvasCylinder component on the top level GameObject.

Direct Touch for 3D primitive objects (boxes, planes) has the same basic setup steps as with touch on Unity Canvas, however with the PointableCanvas component removed and your primitive GameObject in place of the Canvas GameObject.

If you want your 3D button to move as you touch it as showcased in the sample scenes, there is an additional component you can add which is the PokeInteractableVisual.

PokeInteractableVisual takes a reference to the PokeInteractable and the trigger plane (which you can consider as the poke limiting plane, or the “stopping point” of button travel).

The transform on which this HandPokeLimiterVisual is placed will move as it’s pressed, stopping at the trigger plane, after which Poke Limiting will begin.