Direcional
Um controle direcional que sempre é mapeado para o direcional do gamepad.Propriedades
type - “directionalPad”. Especifica o tipo de controle.
scale - number, opcional. O padrão é 1. Multiplicador de tamanho, útil porque os direcionais são posicionados como botões e não são dimensionados automaticamente como os joysticks.
deadzone - number, opcional. Um valor entre 0 e 1 que especifica o tamanho da zona morta como uma porcentagem do controle. Observe que, diferentemente da zona morta dos joysticks, as zonas mortas do direcional são sempre axiais (quadradas).
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.
interaction - object, opcional. Definições de propriedades que podem alterar os mecanismos de interação do usuário com o controle
Interação
activationType - string, opcional. Define o tipo de ativação permitido para qualquer direção na interação do direcional. O padrão é allowNeighboring. Quando definido como exclusive, somente uma única direção pode ser ativada no direcional por vez (ou seja, apenas uma entre ‘Up’, ‘Right’, ‘Down’ ou ‘Left’). Quando definido como allowNeighboring, uma direção e qualquer uma de suas direções vizinhas podem ser ativadas simultaneamente tocando entre elas (ou seja, o usuário pode ativar ‘Up+Right’, ‘Right+Down’, ‘Down+Left’ ou ‘Left+Up’ tocando entre cada uma delas, além de poder ativar cada direção individualmente).
Estados e propriedades de estilo
O controle direcional 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.activated- Aplicado quando o jogador está tocando no botão.
opacity - number, opcional. A opacidade a ser aplicada ao controle. O padrão é 1.0 para todos os estados, exceto disabled.
fill - object, opcional. Um objeto com uma cor definida para o gradiente a ser usado quando o direcional é ativado.
gradient - object, opcional. Um objeto com uma cor definida para o gradiente a ser usado quando o direcional é ativado.
background - object, opcional. Pode ser uma cor ou um ativo de imagem.
stroke - object, opcional. Cor a ser usada no contorno do direcional. Deve ser um objeto stroke.
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 direcional é usado para fornecer uma experiência semelhante à do direcional do controle físico. Se ele estiver sendo usado como o principal mecanismo de movimento do jogador (normalmente no slotleft inner), é recomendável usar uma escala de 2.
Comentários sobre estilo
Se você usar um ativo de imagem personalizado para o background, as resoluções máximas mencionadas são para scale=1.0. Se usar uma escala diferente, as resoluções máximas serão iguais ao produto da resolução pela escala. Por exemplo, scale=1.5 implica que uma imagem de fundo de DPI @1.0x pode ter uma resolução máxima de 90x90.
Exemplos
Exemplo 1: Direcional padrão
Figura 1. Direcional
Exemplo 2: Direcional maior com cores personalizadas.
Figura 1. Direcional personalizado