---
title: "Joystick: uso e campos"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: source-reviewed
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/ui/joystick/
---

# Joystick: uso e campos

Converte o gesto em eixo de ação.

## Para que serve

Converte o gesto em eixo de ação.

## Onde fica

**Interface → criar elemento → Joystick**; ou Canvas expandido na Hierarquia → selecione um elemento → Inspector → **+ Elemento → Joystick**. Primeiro [crie e atribua o documento](/pt-br/snapshot-2026-10-06/ui/comece-aqui/). Este tipo é um nó de UI, não um componente do menu Adicionar componente.

## Campos e uso

Ação, modo Fixo/Flutuante/Dinâmico, eixo, zona morta, raios e visual.

Leia [layout e campos comuns](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) para padrões, unidades, estado, fundo, âncoras e composição automática. A referência de script é [GuiElement](/pt-br/snapshot-2026-10-06/api/astra-guielement/); o tipo é **GuiKind.Joystick**.

## Exemplo prático

Mover o jogador ligado ao receptor do Canvas.

## Limitações e roadmap

Requer ação compatível e receptor; pareamento geral por jogador/hardware continua parcial em R4.

O [roadmap por função](/pt-br/snapshot-2026-10-06/ui/roadmap/) distingue dados, autoria, imagem, entrada, layout e bindings. Esta página descreve o contrato e o uso; não afirma um novo teste no dispositivo.

## Conferência

Crie o elemento no documento, altere os campos relevantes, salve UI, atribua ao Canvas e confira no Play. Pare, reabra e confirme a autoria. Se falhar, use [diagnóstico](/pt-br/snapshot-2026-10-06/ui/diagnostico/) e mantenha a mensagem exata.