Guía
Cómo usar la síntesis de voz en Capacitor
Usando @capgo/capacitor-speech-synthesis
Plugin de Síntesis de Habla para sintetizar habla a partir de texto.
Instalar
bun add @capgo/capacitor-speech-synthesis
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Correlo nuevamente después de cada actualización del plugin.
Importar
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
API a la vista
| Método | Descripción |
|---|---|
speak |
Habla el texto dado con opciones especificadas. La emisión se agrega a la cola de habla. |
synthesizeToFile |
Sintetiza el habla a un archivo de audio (solo Android/iOS). Devuelve la ruta del archivo donde se guardó el audio. |
cancel |
Cancela todas las emisiones programadas y detiene la habla en curso. |
pause |
Detiene la habla inmediatamente. |
resume |
Reanuda la habla pausada. |
isSpeaking |
Verifica si la síntesis de voz está hablando actualmente. |
isAvailable |
Verifica si la síntesis de habla está disponible en el dispositivo. |
getVoices |
Obtiene todas las voces disponibles. |
getLanguages |
Obtiene todos los idiomas disponibles. |
isLanguageAvailable |
Verifica si un idioma específico está disponible. |
isVoiceAvailable |
Verifica si una voz específica está disponible. |
initialize |
Inicia el motor de síntesis de voz (optimización de iOS). Esto puede reducir la latencia para 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). |
Ejemplos
speak()
Habla el texto dado con opciones especificadas. La emisión se agrega a la cola de habla.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const result = await SpeechSynthesis.speak({
text: 'Hello, world!',
language: 'en-US',
rate: 1.0,
pitch: 1.0,
volume: 1.0,
queueStrategy: 'Add'
});
console.log('Utterance ID:', result.utteranceId);
synthesizeToFile()
Sintetiza habla a un archivo de audio (solo Android/iOS). Devuelve la ruta del archivo donde se guardó el audio.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const result = await SpeechSynthesis.synthesizeToFile({
text: 'Hello, world!',
language: 'en-US'
});
console.log('Audio file saved at:', result.filePath);
cancel()
Cancela todas las emisiones programadas y detiene la habla en curso.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.cancel();
pause()
Pausa la habla inmediatamente.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.pause();
resume()
Reanuda la habla pausada.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
await SpeechSynthesis.resume();
isSpeaking()
Verifica si la síntesis de habla está hablando actualmente.
import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';
const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);
La tabla anterior muestra los 14 métodos básicos. Los ayudantes de escucha y versión, y el contrato completo de cada método, se documentan en el repositorio GitHub.
Escuchar eventos
addListener devuelve un manejador. Llamar handle.remove() cuando la pantalla se desmonta, o SpeechSynthesis.removeAllListeners() para eliminar todos los oyentes.
Referencia completa
Sigue adelante desde Usando @capgo/capacitor-speech-synthesis
Si estás utilizando Usando @capgo/capacitor-speech-synthesis para planificar el trabajo de plugin nativo, conectarlo con @capgo/capacitor-síntesis-de-habla para el detalle de implementación en @capgo/capacitor-síntesis-de-habla Getting Started para el detalle de implementación en Inicio Directorio de Plugins de Capgo para el flujo de trabajo del producto en el directorio de plugins Capgo Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, y Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins.