@capgo/capacitor-speech-synthesis impulsa el motor de texto a voz de la plataforma para la accesibilidad, el aprendizaje de idiomas y la navegación manos libres. Elige una voz, ajusta la velocidad y el tono, pausa o reanuda pasajes largos y genera archivos de audio en iOS y Android para reproducción offline.
Llama a initialize() en iOS para una primera síntesis más rápida, y activateAudioSession() cuando necesitas una categoría de audio específica de iOS.
Soporte de plataformas
Sección titulada “Soporte de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | AVSpeechSynthesizer, helpers de sesión de audio |
| Android | Sí | Motor TTS de Android |
| Web | Parcial | Síntesis de voz del navegador cuando está disponible |
Funcionalidades principales
Sección titulada “Funcionalidades principales”speak- Habla el texto indicado con las opciones especificadas. La utterance se añade a la cola de síntesis.synthesizeToFile- Sintetiza la voz en un archivo de audio (solo Android/iOS). Devuelve la ruta del archivo donde se guardó el audio.cancel- Cancela todas las utterances en cola y detiene la síntesis actual.pause- Pausa la síntesis de voz inmediatamente.
Público API
Sección titulada “Público API”| Método | Descripción |
|---|---|
speak | Lee el texto indicado con las opciones especificadas. La locución se añade a la cola de voz. |
synthesizeToFile | Sintetiza la voz en un archivo de audio (solo Android/iOS). Devuelve la ruta del archivo donde se guardó el audio. |
cancel | Cancela todas las locuciones en cola y detiene la locución actual. |
pause | Pausa la locución inmediatamente. |
resume | Reanuda la locución pausada. |
isSpeaking | Comprueba si la síntesis de voz está hablando actualmente. |
isAvailable | Comprueba si la síntesis de voz está disponible en el dispositivo. |
getVoices | Obtiene todas las voces disponibles. |
getLanguages | Obtiene todos los idiomas disponibles. |
isLanguageAvailable | Comprueba si un idioma específico está disponible. |
isVoiceAvailable | Comprueba si una voz específica está disponible. |
initialize | Inicializa el motor de síntesis de voz (optimizado para iOS). Esto puede reducir la latencia en la primera solicitud de voz. |
activateAudioSession | Activa la sesión de audio con una categoría específica (solo iOS). |
deactivateAudioSession | Desactiva la sesión de audio (solo iOS). |
getPluginVersion | Obtiene la versión del plugin nativo. |
addListener | Escucha cuando un enunciado comienza a hablarse. |
addListener | Escucha cuando un enunciado termina de hablarse. |
addListener | Escucha los límites de palabras durante el habla. |
addListener | Escucha errores de síntesis. |
removeAllListeners | Elimina todos los listeners de eventos. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-speech-synthesis.
Continuar desde @capgo/capacitor-speech-synthesis
Sección titulada “Continuar desde @capgo/capacitor-speech-synthesis”Si estás usando @capgo/capacitor-speech-synthesis para planificar el trabajo con plugins nativos, conéctalo con Usando @capgo/capacitor-speech-synthesis para la funcionalidad nativa en Uso de @capgo/capacitor-speech-synthesis, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.