Acelerador

Uma versão especializada de um joystick somente do eixo Y. Projetado para jogos de corrida.

Propriedades

type - “throttle” axisUp - string. O gatilho para o qual a parte superior do controle é mapeada. Deve ser "leftTrigger" ou "rightTrigger". axisDown - string. O gatilho para o qual a parte inferior do controle é mapeada. Deve ser "leftTrigger" ou "rightTrigger". relative - boolean, opcional. Controla como o acelerador calcula seu valor. Se true, o valor será baseado no local do toque inicial do usuário. Se false, o valor será baseado no ponto central do controle. O padrão é true. sticky - boolean, opcional. Controla o que acontece quando o usuário para de tocar no controle. Se true, o acelerador permanecerá no último valor. Se false, ele será redefinido para 0. O padrão é false. 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 isso 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 de acelerador pode ter os seguintes estados estilizados.

default - O estilo base.
activated - Aplicado quando o jogador está tocando no botão e ele está exatamente no valor 0 ao longo do eixo.
activatedDown - Aplicado quando o jogador está tocando no botão e o moveu de forma que ele fique na seção negativa (inferior) do eixo do acelerador.
activatedUp - Aplicado quando o jogador está tocando no botão e o moveu de forma que ele fique na seção positiva (superior) do eixo do acelerador.
idle - Aplicado quando o jogador não está interagindo com o controle e o botão também não está fixo (sticky) na seção superior do eixo.
idleUp - Aplicado quando o jogador não está interagindo com o controle, o botão foi movido para a seção superior e sticky foi definido como true.

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. axisUp - object, opcional. Um objeto axis que especifica o estilo da parte positiva (superior) do acelerador. axisDown - object, opcional. Um objeto axis que especifica o estilo da parte negativa (inferior) do acelerador. knob - object, opcional. O objeto knob que especifica o estilo da parte do botão do acelerador. indicator - object, opcional. Um stroke que especifica o estilo a ser aplicado ao componente que conecta o botão à posição atual no eixo. 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.

Objeto	@1.0x	@1.5x	@2.0x	@3.0x	@4.0x
knob.faceImage	60x60	90x90	120x120	180x180	240x240
knob.background	60x60	90x90	120x120	180x180	240x240

Comentários

O controle throttle permite que o jogador forneça a pressão variável de um gatilho usando um controle de toque. O controle throttle foi projetado para ser posicionado no ponto central da roda e para ser o único controle entre esse ponto e a lateral da tela. Defina sticky como true se o jogador provavelmente quiser aplicar uma pressão constante ao gatilho, permitindo que ele defina o valor e depois use os dedos para outras ações. Comentários sobre estilo

Ao fazer streaming pela versão Windows do Content Test Application, nem todos os estilos serão exibidos corretamente.

Exemplo

Exemplo 1: Acelerador básico

Figura 1. Controle de acelerador

Este exemplo usa o estilo padrão.

{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true
}

Exemplo 2: Acelerador com contorno estilizado e ícones definidos explicitamente

Figura 1. Controle de acelerador personalizado

Usuário interagindo com um acelerador personalizado

{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true,
    "styles": {
        "default": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "gasPedal"
                }
            },
            "axisUp": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                },
                "cap" : {
                    "type": "color",
                    "value": "#107C10"
                }
            },
            "axisDown": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#ff0000"
                },
                "cap" : {
                    "type": "color",
                    "value": "#ff0000"
                }
            }
        },
        "idleUp" : {
            "knob" : {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedUp" : {
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedDown": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "brakePedal"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#ff0000"
            }
        }
    }
}

Requisitos

Versão do layout: 1.0+ (estilo disponível a partir da versão de layout 3.2+)

Porting

Build Paths

Acelerador

Acelerador

Propriedades

Comentários

Exemplo

Exemplo 1: Acelerador básico

Exemplo 2: Acelerador com contorno estilizado e ícones definidos explicitamente

Requisitos

​Acelerador

​Propriedades

​Comentários

​Exemplo

​Exemplo 1: Acelerador básico

​Exemplo 2: Acelerador com contorno estilizado e ícones definidos explicitamente

​Requisitos

Acelerador

Propriedades

Comentários

Exemplo

Exemplo 1: Acelerador básico

Exemplo 2: Acelerador com contorno estilizado e ícones definidos explicitamente

Requisitos