A.AppInitDevAcademy / Luna Virtual
Capítulo 07 / 13 · Audio

Piper, audio y lipsync

Genera voz, conecta la boca del avatar y evita audio duplicado con un cable virtual.

1. Comprueba Piper y la voz descargada

En el ZIP se observa voices/es_MX-claude-high.onnx y su archivo de configuración. El proyecto utiliza Piper para generar un WAV y SoundPlayer de Windows para reproducirlo en el dispositivo de salida predeterminado.

Reproducir una frase de prueba
.\scripts\probar_voz.ps1

Si todavía no tienes Piper instalado ejecuta .\scripts\instalar.ps1 seguido de .\scripts\descargar_voz.ps1. La prueba de voz debería ejecutarse antes de configurar la sincronización de labios.

2. Comprende qué envía cada programa

Piper / SoundPlayer→CABLE Input (salida)→CABLE Output (entrada)→VNyan + LIVE Studio

El cable virtual permite que la salida de audio de Windows sea vista como una entrada de grabación por VNyan y LIVE Studio. Es necesario si quieres que la boca reaccione al sonido generado por Piper sin depender de un micrófono físico.

VB-CABLE (fabricante)Descarga el controlador oficial y revisa sus condiciones de uso.
Sitio oficial ↗

3. Configura la ruta de audio en Windows

  1. Instala VB-CABLE desde el fabricante y reinicia Windows si el instalador lo solicita.
  2. Abre Configuración → Sistema → Sonido → Mezclador de volumen.
  3. Reproduce una frase con probar_voz.ps1 y dirige la salida del proceso de reproducción a CABLE Input si Windows te deja asignarla.
  4. Si no puedes asignar ese proceso, cambia temporalmente la salida predeterminada de Windows a CABLE Input.
  5. En VNyan configura Settings → Audio → Lip Sync Input para escuchar CABLE Output.
  6. Ajusta Gain y Smoothing hasta que la boca se abra con la frase y se cierre al terminar.
  7. En LIVE Studio agrega una fuente de audio que capture CABLE Output; revisa sus medidores.
  8. Haz una grabación local de prueba y escucha el resultado completo.

4. Evita duplicación, eco o ausencia de voz

SíntomaCausa probablePrueba
El avatar no abre la bocaVNyan no escucha CABLE OutputRevisa el dispositivo de entrada y su medidor.
La voz no se escucha en LIVELIVE Studio no captura CABLE OutputSelecciona fuente audio correcta en LIVE Studio.
Eco o voz dobleMismo dispositivo capturado dos vecesDeja una sola ruta de captura.
La boca siempre abiertaGain excesivo / ruidoBaja Gain o ajusta sensibilidad.
Boca sin relación con palabrasEntrada de micrófono incorrectaRevisa de dónde sale SoundPlayer.

5. Archivo fuente y prueba

voz.mjs: implementación de PiperGeneración WAV y reproducción con SoundPlayer.
Descargar ↘
probar_voz.ps1Prueba de audio sin TikTok.
Descargar ↘
Configuración de lipsync originalDocumento incluido en tu ZIP.
Descargar ↘
Captura ampliada