Botão
Um controle básico que pode responder à entrada por toque do jogador. Pode ser estilizado para ter arte personalizada tanto para o fundo quanto para a imagem frontal.Propriedades
type - “button”. Especifica o tipo de controle.
action - string. Ação(ões) a serem invocadas quando um jogador toca no 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.
pullAction - string ou object, opcional. A(s) Ação(ões) a serem invocadas quando um jogador puxa o botão durante um toque. Ao definir a ação de puxar como um objeto, conforme mostrado nos exemplos abaixo, o botão de puxar se torna segmentado, de modo que cada item na matriz items da ação de puxar atribui uma ação a esse segmento. Os segmentos são espaçados uniformemente ao redor do botão, com até 4 segmentos permitidos.
-
Propriedades da ação de puxar segmentada (introduzidas na v4.1)
-
type- “segmented”. Especifica que o tipo da ação de puxar é uma ação de puxar segmentada. -
items- array. Uma matriz de até 4 Ações, cada uma delas invocada quando um jogador arrasta ou puxa um toque até a borda do controle na direção desse segmento.
-
toggle - boolean, opcional. O padrão é false.
- Se
false, a entrada do botão será enviada quando ele estiver pressionado e não será enviada quando não estiver pressionado. - Se
true, cada pressionamento do botão alternará se a entrada está sendo enviada para as ações correspondentes.
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 de botão 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.pulled- Aplicado quando o jogador está tocando e puxando um botão. Para ações de puxar segmentadas, somente o segmento que está sendo puxado é estilizado com esse estado; os outros segmentos mantêm o estiloactivated.toggled- Aplicado quando o botão está em um estado alternado e o jogador não 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.
faceImage - object, opcional. Pode ser um ícone ou um ativo de imagem.
background - object, opcional. Pode ser uma cor ou um ativo de imagem. Não fica visível nos estados ocioso e desabilitado.
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
Os botões são comumente usados para permitir que o jogador execute ações que normalmente seriam feitas por um ou mais botões físicos em seu controle físico. Utilize várias ações para permitir que o jogador reproduza facilmente ações combinadas (por exemplo, pressionar o botão LB e o botão RB simultaneamente). Comentários sobre estilo No estadoactivated, 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: Botão de pular mapeado para o botão A
Exemplo 2: Botão de agachar mapeado para pressionar o botão LB e o botão RB simultaneamente
Exemplo 3: Botão com imagem frontal e imagem de fundo personalizadas
Exemplo 4: Ação de puxar segmentada com estilo personalizado por segmento
Para estilizar botões de puxar segmentados, a matriz
pullIndicator deve ter o mesmo comprimento que a propriedade items que definiu os segmentos. Em outras palavras, cada segmento deve ter uma definição de estilo, ou null deve ser usado para omitir substituições de estilo para um segmento específico.