Finch Logo

Documentation

Finch buttons

You can get information about state of any button of Finch controller and of course you are able to add any functions and actions for any button.

But, there are few hints about buttons, following which you will get good and comfortable for use application.

You can read general information about controller in Controller section. There you will also find information about actions you can't redefine or affect.

Common controls

Home button

This button is the button with the biggest amount of functions.

Actually, it is better to not add any custom functions to this button to be sure that only one action will be invoked at one time.

Thumb button

This is the button under the stick or touchpad, you can use it for actions assistive to stick or touchpad movements. For example, you can select menu element in local menu with help of stick movements and choose action by using thumb button.

Index trigger

Main action button. For example, you can use this button to shoot in your game, to choose something, to draw. Note that in all SDKs there are two types of data you can get from triggers - number, that represents amount of pressing on trigger and events of trigger pressing. Events are invoking when trigger is crossing specified threshold.

3DOF-only buttons

App button

If you have menu in your application - use this button. You can use long press along with press for other purposes.

Volume buttons

Use it for volume, but you also can use it as another button for some action.

6DOF-only buttons

Middle trigger (grip button)

Another assistive button you can use for different purposes. Note that in all SDKs there are two types of data you can get from triggers - number, that represents amount of pressing on trigger and events of trigger pressing. Events are invoking when trigger is crossing specified threshold.

Assistive buttons

You can use it for any assistive actions.

Acitions on buttons

Remember, if you have some action - let it always be on one button. For example, if you have same shooting on two scenes - make shooting by trigger in both scenes, but not by trigger in one scene and by stick in another scene.

If you feel that there are not enough buttons on the controller for your - maybe you should review the controls of your game.