Skip to content

docs(sdk7): document TouchScreenControls and UiInputBinding for custom mobile controls#122

Open
EibrielInv wants to merge 4 commits into
mainfrom
feature/custom-controlls
Open

docs(sdk7): document TouchScreenControls and UiInputBinding for custom mobile controls#122
EibrielInv wants to merge 4 commits into
mainfrom
feature/custom-controlls

Conversation

@EibrielInv

Copy link
Copy Markdown

What

Adds SDK7 creator docs for the new custom mobile-controls components:

  • On-screen Controls (TouchScreenControls) — creator/sdk7/interactivity/touch-screen-controls.md: hide the joystick/crosshair, change the central button action, hide/re-icon buttons.
  • UI Input Binding (UiInputBinding) — creator/sdk7/2d-ui/ui_input_binding.md: bind InputActions to your own UI elements via the uiInputBinding JSX prop.

Also:

  • SUMMARY.md nav entries (Interactivity + 2D UI groups)
  • Cross-links from building-for-mobile/input-on-mobile.md
  • Screenshots under creator/images/touch-controls/

Notes

  • Component/property names verified against the protocol .proto and generated SDK bindings.
  • The uiInputBinding JSX prop lands in js-sdk-toolchain; docs include an imperative fallback for older SDK versions.

@rodrigo685 rodrigo685 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's add both images in https://docs.decentraland.org/creator/~/revisions/G3sbEgsK7q0Z006DrL74/scenes-sdk7/building-for-mobile/input-on-mobile so it's easy to visually grasp / understand both the static controls and what's possible with custom (so they can then go check the specific sections)

For the full input model, see [Click events](../interactivity/button-events/click-events.md). This page focuses on what is mobile-specific.

## What touch maps to

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add creator/images/touch-controls/touch-controls-default.jpg here

Image

## Customizing the on-screen controls

Scenes can reconfigure these on-screen controls — hide the joystick or crosshair, change what the central button does, re-icon buttons, or replace them with custom UI. See [On-screen Controls](../interactivity/touch-screen-controls.md) and [UI Input Binding](../2d-ui/ui_input_binding.md).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add image here

Image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Controls Customization: Update Mobile Creator Docs with Controls Customization V1

2 participants