Skip to main content

Touchpad

Controle analógico que permite ao jogador interagir de forma semelhante ao touchpad de um laptop.

Propriedades

type - “touchpad” axis - object ou array. Um único eixo ou uma matriz de eixos que descrevem o mapeamento deste controle de touchpad. action - object, opcional. Uma ação a ser invocada ao tocar, além do mapeamento de eixo. renderAsButton - boolean, opcional. O padrão é false. Defina como true para renderizar visualmente o touchpad como um botão. enabled - boolean, opcional. O padrão é true. Define o estado visual do controle como habilitado/desabilitado. Um controle desabilitado ainda receberá entrada do jogador, mas NÃO alterará o estilo visual com base na entrada. visible - boolean, opcional. O padrão é true. Determina se o controle é exibido para o jogador interagir. Para alterar durante a jogabilidade, consulte Alterando layouts de toque usando o estado do jogo. styles - object, opcional. Personalização da representação visual do controle. Os estilos são representados como um objeto por estado que pode ser estilizado. O controle pode ter os seguintes estados estilizados:
  • default - O estilo base.
  • disabled - O estilo quando o controle está desabilitado. Se não for especificado, quando o controle estiver desabilitado, uma transformação será aplicada ao estilo padrão para que ele pareça desabilitado.
  • idle - Aplicado quando o jogador NÃO está interagindo com o controle.
  • moving - Aplicado quando o jogador está tocando no controle e nenhuma action está definida.
  • activated - Aplicado quando o jogador está tocando no controle e uma action está definida.
Propriedades de estilo por estado opacity - number, opcional. A opacidade a ser aplicada ao controle. O padrão é 1.0 para todos os estados, exceto disabled. background - object, opcional. Pode ser uma cor ou um ativo de imagem. faceImage - object, opcional. Pode ser um ícone ou um ativo de imagem. Dimensões dos ativos Para cada um dos objetos de estilo que aceitam ativos de imagem, um determinado ativo é fornecido em uma resolução base e nas escalas 1.5x, 2.0x, 3.0x e 4.0x dessa resolução base. A resolução de uma determinada imagem deve ser menor ou igual às seguintes resoluções máximas:

Comentários

O touchpad é mais indicado para saídas não fixas e sem zona morta, normalmente a câmera de visão em um jogo em primeira/terceira pessoa. Para jogos que dão suporte à entrada de mouse, o touchpad pode ser usado com mouse relativo para proporcionar uma experiência de câmera de visão mais ajustada. Comentários sobre estilo Quando renderAsButton é true:
  • No estado activated, a faceImage é exibida 25% menor.
  • Há rótulos e estilo padrão para a cor de fundo dos botões que não usam ativos personalizados e têm uma única ação gamepadX, gamepadY, gamepadA ou gamepadB.

Exemplos

Exemplo 1: Touchpad com um ícone de visão

Figura 1. Controle de touchpad Usuário interagindo com um touchpad

Exemplo 2: Touchpad com um ícone de visão renderizado como um botão

Figura 1. Controle de touchpad como botão Usuário interagindo com um touchpad como botão

Requisitos

Versão do layout: 1.0+ (estilo disponível a partir da versão de layout 3.0+)
Last modified on October 6, 2026