Cruceta direccional
Un control de cruceta direccional que siempre se asigna a la cruceta direccional del mando.Propiedades
type - “directionalPad”. Especifica el tipo de control.
scale - number, opcional. El valor predeterminado es 1. Multiplicador de tamaño, útil porque las crucetas direccionales se colocan como botones y no se escalan automáticamente como los joysticks.
deadzone - number, opcional. Un valor entre 0 y 1 que especifica el tamaño de la zona muerta como porcentaje del control. Tenga en cuenta que, a diferencia de la zona muerta de los joysticks, las zonas muertas de la cruceta direccional siempre son axiales (cuadradas).
enabled - boolean, opcional. El valor predeterminado es true. Establece el estado visual del control como habilitado o deshabilitado. Un control deshabilitado seguirá recibiendo la entrada del jugador, pero NO cambiará el estilo visual en función de la entrada.
visible - boolean, opcional. El valor predeterminado es true. Determina si el control se muestra al jugador para que interactúe con él. Para cambiarlo durante el juego, consulte Cambio de diseños táctiles mediante el estado del juego.
styles - object, opcional. Personalización de la representación visual del control. Los estilos se representan como un objeto por cada estado al que se pueden aplicar estilos.
interaction - object, opcional. Definiciones de propiedades que pueden modificar los mecanismos de interacción del usuario con el control.
Interacción
activationType - string, opcional. Define el tipo de activación permitido para cualquier dirección determinada en la interacción con la cruceta direccional. El valor predeterminado es allowNeighboring. Cuando se establece en exclusive, solo se puede activar una única dirección de la cruceta direccional a la vez (es decir, solo una de “Arriba”, “Derecha”, “Abajo” o “Izquierda”). Cuando se establece en allowNeighboring, se pueden activar simultáneamente una dirección y cualquiera de sus direcciones contiguas tocando entre ellas (es decir, el usuario puede activar “Arriba+Derecha”, “Derecha+Abajo”, “Abajo+Izquierda” o “Izquierda+Arriba” tocando entre cada una de ellas, además de la posibilidad de activar cada dirección individual).
Estados y propiedades de estilo
El control de cruceta direccional puede tener estilos aplicados a los siguientes estados:
default- El estilo base.disabled- El estilo cuando el control está deshabilitado. Si no se especifica, cuando el control esté deshabilitado, se aplicará una transformación al estilo predeterminado para que parezca deshabilitado.idle- Se aplica cuando el jugador NO está interactuando con el control.activated- Se aplica cuando el jugador está tocando el botón.
opacity - number, opcional. La opacidad que se aplica al control. El valor predeterminado es 1.0 para todos los estados excepto disabled.
fill - object, opcional. Un objeto con un color definido para el degradado que se usará cuando se active la cruceta direccional.
gradient - object, opcional. Un objeto con un color definido para el degradado que se usará cuando se active la cruceta direccional.
background - object, opcional. Puede ser un color o un recurso de imagen.
stroke - object, opcional. Color que se usará en el contorno de la cruceta direccional. Debe ser un objeto de trazo.
Dimensiones de los recursos
Para cada uno de los objetos de estilo que aceptan recursos de imagen, un recurso determinado se proporciona en una resolución base y en escalas de 1.5x, 2.0x, 3.0x y 4.0x de esa resolución base. La resolución de una imagen determinada debe ser menor o igual que las siguientes resoluciones máximas:
Comentarios
La cruceta direccional se usa para proporcionar una experiencia similar a la de la cruceta direccional del mando físico. Si se usa como mecanismo de movimiento principal del jugador (normalmente en la ranurainner de left), se recomienda usar una escala de 2.
Comentarios sobre estilos
Si usa un recurso de imagen personalizado para el background, las resoluciones máximas indicadas corresponden a scale=1.0. Si usa una escala diferente, las resoluciones máximas serán iguales al producto de la resolución y la escala. Por ejemplo, scale=1.5 implica que una imagen de fondo de PPP @1.0x puede tener una resolución máxima de 90x90.
Ejemplos
Ejemplo 1: Cruceta direccional predeterminada
Figura 1. Cruceta direccional
Ejemplo 2: Cruceta direccional más grande con colores personalizados.
Figura 1. Cruceta direccional personalizada