Joystick
Um controle analógico que se comporta como um joystick.Propriedades
type - “joystick”
axis - object ou array. Um único eixo ou uma matriz de eixos que descrevem o mapeamento deste controle de joystick.
action - object, opcional. Uma ou mais ações a serem invocadas além do mapeamento de eixo.
actionThreshold - number, opcional. Valor mínimo normalizado do joystick (radial) necessário para invocar a ação. Valor padrão de 0.
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.
expand - boolean, opcional. Valor padrão de true. Expande o alcance do joystick para corresponder às preferências ergonômicas do usuário quando posicionado em um soquete de controle central. Defina como false para usar um tamanho de joystick fixo padronizado.
relative - boolean, opcional.
Por padrão (true), o joystick calculará seu valor usando um cálculo relativo com base no toque inicial do usuário. Definir esse valor como false fará com que o valor seja calculado com base no ponto central do controle.
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 há interação com o botão do joystick, independentemente da zona morta definida.activated- Aplicado quando umaactioné definida e o botão é movido para fora do limite para executar a ação.
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.
knob - object, opcional. O objeto knob especifica o estilo da parte do joystick semelhante a um botão com a qual o jogador pode interagir.
outline - object, opcional. O objeto outline especifica o estilo do contorno e do indicador apresentados quando há interação com o joystick.
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 controlejoystick pode ser usado para fornecer controle analógico mapeado para os diferentes joysticks do controle físico.
Se o joystick for o principal método de movimento, é recomendável posicioná-lo no slot central esquerdo e definir expand como true para proporcionar a melhor experiência ao jogador.
Considere personalizar a faceImage para dar uma dica ao jogador sobre o que o joystick controlará (isso é especialmente importante se o seu jogo utilizar mais de um joystick).
Para movimentos que dependem de apenas 1 eixo, utilize um joystick de eixo único para maximizar a jogabilidade.
Comentários sobre estilo
Se você usar um ativo de background e expand for true, o ativo de background NÃO será dimensionado para o tamanho total do soquete central.
Por padrão, o outline só é exibido enquanto o jogador está interagindo com o controle.
Se você usar um ativo de background personalizado e expand estiver definido como true, observe que o ativo NÃO será expandido com a personalização do controle feita pelo jogador.
Exemplos
Exemplo 1: Joystick simples
Um mapeamento básico 1:1 para um joystick com uma pequena zona morta. Os direcionais analógicos do controle físico calculam seu valor por meio de rotação. Figura 1. Controle de joystick
Exemplo 2: Joystick que alterna de caminhar para correr quando o limite é ultrapassado.
Quando o limite (0.75) é ultrapassado, o leftTrigger será enviado junto com o movimento do joystick. O ícone mudará de ‘walk’ para ‘sprint’ Figura 1. Controle de joystick com limite de ação
Exemplo 3: Joystick de eixo único (horizontal) que se parece com um volante
Figura 1. Controle de joystick de volante horizontal
Exemplo 4: Joystick com cores personalizadas
Figura 1. Controle de joystick personalizado