Solución de problemas
Arregla animaciones, cámara, voz, API 8069, overlay y conexión de TikFinity.
Problemas de VNyan y sus grafos
| Problema | Diagnóstico | Solución |
|---|---|---|
| Nada pasa al llamar puerto 8069 | API desactivada o puerto incorrecto | Activa API local en VNyan y revisa apiUrl. |
| Hotkey sí; API no | Action o callback equivocado | Iguala nombre de API Message con config.json. |
| HTTP 200, sin animación | Grafo no activo o cables incompletos | Revisa Active, conexiones y Play Animation. |
| Movimiento no termina | Temporizador incongruente | Start Timer y Timer deben usar el mismo nombre. |
| Movimientos predeterminados no aparecen | Biblioteca o versión diferente | Elige otra animación disponible de VNyan. |
Si no hay respuesta, empieza con el grafo de LunaRegalo y una hotkey. Después habilita HTTP. La prueba de hotkey reduce el número de variables y ayuda a aislar el problema.
Problemas de OBS, cámara virtual y overlay
| Síntoma | Qué revisar |
|---|---|
| Pantalla negra en LIVE Studio | OBS Virtual Camera iniciada, dispositivo correcto y aplicación actualizada. |
| No aparece «Luna Virtual» | Node activo en 8787 y fuente Navegador con URL correcta. |
| Avatar tapado por texto | Orden de fuentes, tamaño y posición del navegador. |
| El personaje sale cortado | Resolución 720×1280 y redimensionamiento en OBS. |
| OBS muestra líneas o bordes de transformación | Los marcos rojos son controles de edición; no aparecen como parte de la salida al público. |
Comprobar salud de overlay desde un navegador
http://127.0.0.1:8787/healthLa ruta /health devuelve un JSON cuando el servidor está funcionando. Si no existe respuesta HTTP, revisa el log de Node y confirma que no haya otro proceso ocupando el puerto.
Problemas de Piper, lipsync y eco
- SoundPlayer no reproduce: confirma que
piper.pythonPathapunta al entorno .venv y que el modelo ONNX existe. - Hay WAV pero no movimiento labial: revisa VNyan Lip Sync Input y el cable virtual.
- Se escucha solo en auriculares: revisa si LIVE Studio está capturando ese mismo dispositivo o CABLE Output.
- Hay eco: deshabilita una ruta de captura y evita monitorización duplicada.
- El audio no llega por cámara virtual: es el comportamiento esperado: debes capturarlo de forma independiente.
OBS: capturas y fuentes de audioEvitar dispositivos duplicados.
Sitio oficial ↗OBS: captura de audio de aplicacionesOpciones para controlar captura por aplicación.
Sitio oficial ↗Problemas de TikFinity y eventos
- Confirma un LIVE autorizado y activo.
- Pulsa el botón de conexión y verifica el estado de TikFinity.
- Revisa que el WebSocket
21213esté accesible desde el mismo equipo. - Activa brevemente el registro raw y comprueba qué evento y campos entrega el proveedor.
- Recuerda los activadores y cooldowns de chat.
- No asumas que se entregan eventos de bienvenida a todos los espectadores.
Mantenimiento, seguridad y fallos que el sistema no resuelve solo
El script supervisor del ZIP puede intentar reiniciar el proceso Node si falla, pero no reinicia una emisión en TikTok, ni garantiza recuperar OBS, VNyan, LIVE Studio o TikFinity. Mantén supervisión, moderación y un procedimiento de cierre seguro.
Solución de problemas originalReferencia extraída del archivo adjunto.
Descargar ↘