Expressions/es

Ver · Editar¡Esta es una página de información oficial de VRChat!

Es revisada y aprobada por el equipo de VRCWiki. Aprende cómo contribuir a esta página leyendo la guía de contribución.

Un ejemplo del menú de expresiones en el menú de acción.

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 asset llamado Expression Menu y otro asset llamado Expression Parameters en Unity, y luego asígnalos en la sección Expressions del "VRChat Avatar Descriptor". El menú define qué controles aparecen en el menú dentro del juego, mientras que el asset de parámetros define los nombres, tipos, valores por defecto y el comportamiento de sincronización de los valores que esos controles cambian.

Cada parámetro personalizado puede marcarse como Saved y Synced. Los parámetros personalizados sincronizados (Synced) cuentan para el presupuesto de sincronización de 256 bits del avatar, mientras que los avatares pueden definir hasta 8192 parámetros personalizados en total. Los parámetros de este asset también pueden ser modificados por Contact Receivers, parameter drivers, PhysBones y OSC.

El SDK también incluye un botón de Default Parameters. Este restaura los tres parámetros alias utilizados por los controladores AV3 predeterminados de VRChat: VRCEmote, VRCFaceBlendH y VRCFaceBlendV.

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

Ejemplo del menú de acción y el espejo facial en uso. (GIF animado)

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.

Cuando un control tipo radial está abierto, VRChat sincroniza sus valores en tiempo real usando el modo de sincronización IK, que es más rápido. Después de cerrarlo, el valor se mantiene congelado hasta que se cambie nuevamente.

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.

Ajustes

Cada entrada en el asset de Expression Parameters almacena:

• Name, que debe coincidir exactamente con el nombre del parámetro en el Animator.
• Type, que puede ser Bool, Int o Float.
• Default, que se utiliza cuando se reinicia el avatar.
• Saved, que controla si el valor persiste entre sesiones.
• Synced, que controla si el valor se envía a otros usuarios.

Por defecto, la sincronización de parámetros personalizados utiliza el modo de sincronización Playable de VRChat. Los controles radiales usan temporalmente la sincronización más rápida IK mientras están abiertos y activos.

Parámetros integrados

VRChat also provides built-in Animator parameters. These do not need to be added to the Expression Parameters asset, and they do not count toward the custom parameter budget.

Built-in parameters are read-only. They are added directly to a playable layer's Animator Controller by name, and VRChat updates them automatically at runtime. They are not set on sub-animators, only on playable-layer animators.

Additional built-in parameters include:

• Viseme (Int) — Set by lip sync from 0 (silence) to 14 (the "u" vowel) when the Avatar Descriptor's Lip Sync is set to Viseme Blend Shape or Viseme Parameter Only.
• Voice (Float) — Perceived microphone volume from 0.0 to 1.0, affected by distance and earmuff settings.
• VelocityX, VelocityY, VelocityZ, VelocityMagnitude (Float) — Movement speed in m/s along each axis and total magnitude. Locally, playspace movement does not count; remotely, it does.
• Upright (Float) — 0 when prone, 1 when standing.
• Grounded (Bool) — Whether the user is touching the ground.
• MuteSelf (Bool) — Whether the user's microphone is muted.
• Earmuffs (Bool) — Whether the user has earmuffs enabled.
• IsOnFriendsList (Bool) — Whether the viewer is friends with the avatar's wearer (shows False locally).
• ScaleFactor, ScaleFactorInverse, EyeHeightAsMeters, EyeHeightAsPercent (Float) — Scaling-related parameters for avatar scaling. EyeHeightAsMeters is recommended for scale-aware systems because it is linear and does not depend on upload height.

Each built-in parameter has a sync type determining when it is sent to remote users: IK for tracking-derived values (gestures, velocity, grounded), Speech for voice-related values (viseme, voice), Playable for user-state values (mute, earmuffs, tracking type, scale), or None for local-only values (IsLocal, PreviewMode).

Network synchronization

Only synced expression parameters and certain built-in parameters are sent over the network. The full list of data sent for each avatar includes:

• IK targets — Head, jaw, and hands for desktop and 3-point tracking; additionally hip and feet for full-body tracking. Index controller users also sync finger positions.
• Synced expression parameters — Only parameters marked as Synced are transmitted. Values are quantized: Int values sync in the range 0–255, Float values sync as multiples of 1/127 between −1 and 1, and Bools sync as true or false.
• Built-in VRC parameters — Including gestures, velocity, voice, and other runtime parameters.
• PhysBones — Pose position data is sent to late joiners.

For reliable late-joiner support, a recommended pattern is to split animator logic using the IsLocal parameter: local-side layers handle contacts, parameter drivers, and all logic, then set synced parameters, while remote-side layers only read those synced parameters to play the correct visualization.

Gestures and facial expressions

The built-in GestureLeft and GestureRight parameters identify the user's hand gesture, while GestureLeftWeight and GestureRightWeight expose analog trigger pressure. On humanoid avatars, the Gesture playable layer is commonly used for hand poses, while facial expressions are often driven from the FX layer with blendshapes, material properties, or other non-humanoid animations.

On tracked controllers where finger tracking overrides animation by default, creators can use a Tracking Control state behavior to switch the relevant fingers from Tracking to Animation when needed.

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

Parámetro del controlador de animación

Tipo	Expresión Bool = Falso	Expresión Bool = Verdadero
Bool → Bool	Bool = False	Bool = True
Bool → Int	Int = 0	Int = 1
Bool → Float	Float = 0.0	Float = 1.0

Parámetro de expresión Int

Parámetro del controlador de animación

Tipo	Comportamiento
Int → Bool	Cualquier valor "Int" que no sea 0 establece "Bool" en verdadero
Int → Int	Comportamiento esperado
Int → Float	Conversión directa: ej. Int = 2 → Float = 2.0

Parámetro de expresión Float

Parámetro del controlador de animación

Tipo	Comportamiento
Float → Bool	Cualquier valor "Float" que no sea 0 establece "Bool" en verdadero
Float → Int	Conversión redondeada: ≥0.5 → 1 ; <0.5 → 0
Float → Float	Comportamiento esperado

Recursos

• Avatar 3.0 Hub mundo en VRChat
• Menú de expresiones y controles en Creator Docs
• Menú de acción - Menú de expresiones en Creator Docs
• Parámetros del Animator en Creator Docs
• Capas reproducibles en Creator Docs
• Comportamientos de los estados en Creator Docs

Véase también

• Avatares
  • Avatar Dynamics
• Menú de acción
• SDK de VRChat

Referencias

• VRC School: Expressions Menu and Parameters
• VRC School: Hand Gestures/Facial Expressions
• VRC School: Built-In VRC Parameters
• VRC School: Network Sync
• VRC School: Expression Parameter Mismatching