Expressions/es: Difference between revisions
No edit summary |
No edit summary |
||
| Line 71: | Line 71: | ||
|+Parámetro del controlador de animación | |+Parámetro del controlador de animación | ||
!Tipo | !Tipo | ||
!Expresión | !Expresión Bool = Falso | ||
!Expresión booleana = Verdadero | !Expresión booleana = Verdadero | ||
|- | |- | ||
Revision as of 10:46, 7 December 2025

Las expressiones son una característica de los avatares de VRChat, compuesta por menús personalizados por el usuario que permiten activar acciones o alternar entre objetos en tu avatar; están diseñadas para ofrecer acceso flexible y sencillo a funciones únicas del avatar.
Más información disponible en Documentos para creadores de avatares (en inglés).
Menú de expresiones
El menú de expresiones dentro del juego es accesible a través del menú de acción, o del panel de expresiones en el menú rápido y el menú principal en cualquier versión de VRChat. Los cambios en las expresiones de un avatar se sincronizan globalmente con otros usuarios en la misma plataforma y pueden configurarse para una sincronización multiplataforma.
Expresiones en el SDK
Las expresiones se editan utilizando varios parámetros en el SDK de VRChat.
Expresiones base
Cuando no se configura ninguna expresión, se agrega al avatar un menú de expresiones predeterminado con animaciones base, que contiene las siguientes animaciones:
- Saludar
- Aplaudir
- Señalar
- Animar
- Bailar
- Voltereta hacia atrás
- Morir
- Tristeza
Expresiones personalizadas
Para añadir expresiones personalizadas, crea un archivo llamado Expression Menu y otro llamado Expression Parameter (clic derecho en una carpeta dentro de Assets > Create > VRChat), luego asígnalos en el "Avatar Descriptor" de VRChat. El menú define las entradas de parámetros que se muestran en el menú de expresiones de tu avatar. Los parámetros son las variables que controla el menú. También puedes especificar detalles como si los parámetros deben sincronizarse para otros usuarios. Puedes configurar 256 bits para sincronizarse, dentro de un total de 8192 variables.
Controles
Puedes crear hasta 8 controles por página. Al crear un control, elige su tipo:
- Botón
- Interruptor (Toggle)
- Submenú
- Control de dos ejes
- Control de cuatro ejes
- Control radial
Ejemplo de menú de control

Al mover el joystick, el panel táctil o el ratón/mouse en diferentes direcciones, se modifican los parámetros de animación para combinar diferentes estados de ánimo (por ejemplo, "feliz" y "sorprendido"). Cualquier parámetro se puede controlar desde este menú.
Puedes abrir un menú con cada mano (o con ambas). Por defecto, desliza el dedo para seleccionar una opción. En la configuración del menú de acción, puedes usar el gatillo. Para salir de una selección en el menú de expresiones, aprieta el gatillo.
Parámetros de expresión
Los parámetros de expresión se utilizan para controlar funciones del avatar mediante el menú de expresiones, el contact receiver (receptor de contactos), OSC, controladores de parámetros o physbones. Estos parámetros luego se asignan a los parámetros del "Animator Controller" (controlador de animaciones) en los controladores: FX, Gesture o Action de tu avatar.
Parámetros de expresión no coincidentes
La discrepancia de parámetros de expresión se refiere a la práctica de usar diferentes tipos de parámetros entre tus parámetros de expresión y los parámetros locales del controlador de animaciones. Aunque se recomienda mantener los tipos de parámetros consistentes, la discrepancia se acepta y el sistema convertirá los valores entre tipos según reglas específicas, lo que puede ser útil en ciertos ajustes avanzados.
El sistema "Animator" de Unity usa números flotantes (floats) internamente para todos los tipos de parámetros, mientras que VRChat utiliza internamente SBytes para el almacenamiento de parámetros. La interfaz de usuario en Unity y el VRCSDK te permite seleccionar tipos de parámetros por conveniencia, pero bajo el capó, las conversiones son posibles. Esto significa que los parámetros no se convierten, sino que se desajustan. Este comportamiento también es compatible con herramientas populares como "Av3Emulator" y "Gesture Manager".
Parámetro de expresión Bool
| Tipo | Expresión Bool = Falso | Expresión booleana = Verdadero |
|---|---|---|
| Bool → Bool | Bool = False | Bool = True |
| Bool → Int | Int = 0 | Int = 1 |
| Bool → Float | Float = 0.0 | Float = 1.0 |
Expression Parameter Int
| Type | Behaviour |
|---|---|
| Int → Bool | Any Int value that isn’t 0 sets bool to True |
| Int → Int | Expected Behaviour |
| Int → Float | Straight Conversion: e.g. Int = 2 → Float = 2.0 |
Expression Parameter Float
| Type | Behaviour |
|---|---|
| Float → Bool | Any Float value that isn’t 0 sets bool to True |
| Float → Int | Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0 |
| Float → Float | Expected Behaviour |
Resources
- Avatar 3.0 Hub world on VRChat
- Expression Menu and Controls on Creator Docs
- Action Menu - Expression Menu on Creator Docs
- Animator Parameters on Creator Docs
- Playable Layers on Creator Docs
See also
References