Saltar al contenido principal
@capgo/capacitor-sintetizador de voz Multimedia De código abierto

Plugins de la plataforma plugin de Capacitor

Synthesiza el habla desde texto con control total sobre el idioma, voz, entonación, ritmo y volumen.

Instalar

bun add @capgo/capacitor-speech-synthesis bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-speech-synthesis
  • pnpm add @capgo/capacitor-speech-synthesis
  • yarn add @capgo/capacitor-speech-synthesis

Guía

Cómo usar la síntesis de voz en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Previsualización del plugin de síntesis de voz code

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.

FAQ

Preguntas frecuentes del plugin de síntesis de voz

Cómo instalo el plugin de síntesis de voz en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-speech-synthesis" (o "npm install @capgo/capacitor-speech-synthesis"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el code nativo. Importa desde "@capgo/capacitor-speech-synthesis" en tu aplicación code.

¿Funciona @capgo/capacitor-síntesis de voz con React, Vue y Angular?

Sí. Síntesis de voz es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-síntesis de voz?

Los plugins Capgo siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-síntesis de voz gratuito y de código abierto?

Sí. El código fuente code está público en GitHub en https://github.com/Cap-go/capacitor-síntesis-de-voz/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Síntesis de Voz sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia la code nativa, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios de JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Envíe cambios de síntesis de voz sin esperar la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo