> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/input-on-mobile.md).

# Entrada no Celular

Como as ações de entrada mapeiam para toques no client mobile do Decentraland.

O sistema de entrada do Decentraland foi concebido para funcionar com qualquer dispositivo. O mesmo `InputAction` enum que o SDK disponibiliza no computador também é encaminhado a partir dos controlos no ecrã em dispositivos móveis, por isso a maioria das cenas funciona sem alterações. No entanto, há algumas regras e particularidades que convém conhecer ao criar conteúdo para ecrãs táteis.

Para conhecer o modelo de entrada completo, consulte [Eventos de clique](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/click-events.md). Esta página centra-se no que é específico dos dispositivos móveis.

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3f9b9411cb70df33cba905d3a560fb1bb7ceb258%2Ffull-input.webp?alt=media" alt="The on-screen controls with the + menu expanded, showing every input button"><figcaption><p>Controlos no ecrã com o menu "+" expandido — todas as ações de entrada visíveis</p></figcaption></figure>

## O que corresponde aos controlos táteis

Cada `InputAction` disponível no computador também está disponível no cliente para dispositivos móveis — os controlos no ecrã simplesmente encaminham os toques para as mesmas entradas do SDK. Isto significa que qualquer cena que utilize os valores padrão `InputAction` funcionará em dispositivos móveis sem configurações adicionais.

Os controlos no ecrã correspondem ao seguinte:

* **Joystick no ecrã** — controla `IA_FORWARD` / `IA_BACKWARD` / `IA_LEFT` / `IA_RIGHT` e o movimento do avatar.
* **Botão de interação (canto inferior direito)** — aciona `IA_POINTER` (o botão esquerdo do rato no computador) em relação ao objeto para o qual o jogador está a apontar.
* **Botão E** — aciona `IA_PRIMARY` (a tecla `E` no computador).
* **Botão F** — aciona `IA_SECONDARY` (a tecla `F` no computador). Oculto por predefinição (ver abaixo).
* **Botão de salto** — aciona `IA_JUMP` (a tecla `Space` no computador). Este é o botão maior do HUD e está sempre facilmente ao alcance.
* **Botões 1 / 2 / 3 / 4** — acionam `IA_ACTION_3` / `IA_ACTION_4` / `IA_ACTION_5` / `IA_ACTION_6` respetivamente. Ocultos por predefinição (ver abaixo).
* **Arrastar a câmara** — roda a câmara; não está disponível como `InputAction`.

## Personalização dos controlos

As Scenes podem reconfigurar os controlos no ecrã — ocultar o joystick ou a mira, ocultar qualquer botão (incluindo o de salto), alterar a função do botão central, trocar os ícones dos botões ou substituir completamente os controlos nativos por uma UI personalizada. Consulte [Controlos no ecrã](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/touch-screen-controls.md) e [Associação de entradas da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_input_binding.md).

<figure><img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8fa39c0bb21eb9c2ff7949a101321cc1549f937%2Fcustom-main-action.webp?alt=media" alt="Customized on-screen controls"><figcaption><p>Um HUD personalizado: o botão central com um novo ícone associado a uma ação diferente</p></figcaption></figure>

## Entradas a evitar para ações importantes em dispositivos móveis

Cada `InputAction` pode ser associado a um botão no ecrã, mas uma Scene criada com o SDK 7.32.0 ou posterior começa com apenas três botões visíveis: o botão de interação, o botão E e o botão de salto. `IA_SECONDARY` (F) e `IA_ACTION_3`–`IA_ACTION_6` (os `1`/`2`/`3`/`4` botões) estão **ocultos por predefinição**, pelo que uma ação importante associada a um deles não terá um botão no telemóvel, a menos que a sua Scene o mostre. Em SDKs mais antigos, os oito botões são apresentados; os de prioridade mais baixa ficam atrás de um menu «+», difícil de alcançar durante o jogo.

A menos que a sua Scene os mostre explicitamente com [Controlos no ecrã](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/touch-screen-controls.md), evite associar ações importantes a:

* `IA_SECONDARY` — a tecla `F` no computador / botão `F` no telemóvel
* `IA_ACTION_3` — a tecla `1` no computador / botão `1` no telemóvel
* `IA_ACTION_4` — a tecla `2` no computador / botão `2` no telemóvel
* `IA_ACTION_5` — a tecla `3` no computador / botão `3` no telemóvel
* `IA_ACTION_6` — a tecla `4` no computador / botão `4` no telemóvel

Prefira, em vez disso:

* `IA_POINTER` para o botão principal de toque/interação
* `IA_PRIMARY` para a ação do botão E
* `IA_JUMP` quando uma ação corresponde naturalmente a saltar (é o botão maior e mais acessível na HUD para dispositivos móveis)
* Acionadores baseados na proximidade (consulte [Eventos de proximidade](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/proximity-events.md)) quando uma ação deve ser executada automaticamente à medida que o jogador se aproxima de uma entidade

## Bloqueio do cursor

O [`PointerLock` componente](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/click-events.md#lock-or-unlock-the-cursor) é um conceito do cliente para desktop (cursor do rato bloqueado ou desbloqueado). Não se aplica ao toque em dispositivos móveis e é seguro deixá-lo na sua cena — não tem qualquer efeito nesses dispositivos.

## Relacionados

* [Controlos no ecrã](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/touch-screen-controls.md)
* [Vinculação de entrada da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_input_binding.md)
* [Eventos de clique](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/click-events.md)
* [Eventos de proximidade](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/proximity-events.md)
* [Detetar a plataforma a partir do código](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/detect-platform.md)
* [Práticas recomendadas de UI para dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/ui-best-practices.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/input-on-mobile.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
