A.AppInitDevAcademy / Luna Virtual
Capítulo 04 / 13 · Avatar 3D

Configurar VNyan

Carga el VRM, revisa cámara, movimientos predeterminados y conecta la API local.

1. Abre VNyan y carga tu archivo VRM

  1. Ejecuta VNyan en Windows.
  2. Usa la función de cargar avatar/modelo e importa C:\StreamerVirtualTikTok\avatar\Luna.vrm.
  3. Confirma que el rostro esté orientado a la cámara y que el cuerpo aparezca dentro del encuadre.
  4. Ajusta el tamaño, el fondo y la posición según la escena que capturarás en OBS.
  5. Guarda la configuración desde los controles de VNyan cuando hayas terminado.

2. Usa los movimientos y animaciones predeterminados

En tu captura de nodos aparece Play Animation con la animación Snake Dance (BasicMotions) o una entrada de la biblioteca BasicMotions. Eso indica que el gesto seleccionado proviene de la biblioteca integrada/disponible en tu instalación, no de Pose Studio.

Vista de Node Graph en VNyan con API Message, Hotkey, Play Animation y Start Timer.
Pantalla real de VNyan: grafo LunaRegalo; callbacks API y Hotkey controlan un nodo Play Animation y un temporizador.Descargar captura original PNG ↗Descargar versión optimizada WebP ↗
  1. Abre Node Graphs (grafos de nodos).
  2. Crea un grafo para cada interacción, por ejemplo LunaRegalo.
  3. Añade un nodo Play Animation y abre el selector de animaciones.
  4. Selecciona una animación ya disponible en VNyan, como las incluidas en BasicMotions, y prueba el resultado.
  5. Ajusta intensidad/blend en cabeza, cuello, brazos y manos para evitar exageraciones.
  6. No es necesario instalar complementos de animación para este ejemplo.

3. Prepara la API local de VNyan

El Node.js de tu proyecto envía una petición HTTP a http://127.0.0.1:8069/. Debes habilitar el servicio/API REST correspondiente en VNyan y tener un grafo activo con un nodo API Message cuyo campo Action coincida con el mensaje que envía el puente.

Enviar prueba al nodo API Message
Invoke-RestMethod -Method Post `
  -Uri "http://127.0.0.1:8069/" `
  -ContentType "application/json" `
  -Body '{"action":"LunaRegalo","payload":{}}'

Si no ocurre nada, verifica que el grafo esté Active, que el campo Action sea idéntico y que exista una conexión entre la salida del callback y la animación.

4. Nombres de acciones del proyecto

Clave config.jsonAcción VNyanDisparador esperado
giftLunaRegaloRegalo
followLunaSeguidorNuevo seguidor
subscribeLunaSuscripcionSuscripción
shareLunaComparteCompartir
greetLunaSaludaSaludo
idleLookLeftLunaIdleIzquierdaMirada a la izquierda
idleLookRightLunaIdleDerechaMirada a la derecha
idlePostureLunaIdlePosturaPostura de espera
idleHandsLunaIdleManosGestos suaves
Captura ampliada