@capacitor-community/text-to-speech

Text to Speech

@capacitor-community/text-to-speech

Capacitor community plugin for synthesizing speech from text.

Maintainers

Maintainer	GitHub	Social
Robin Genz	robingenz	@robin_genz

Installation

npm install @capacitor-community/text-to-speech
npx cap sync

Android

According to the Android documentation, apps targeting Android 11 should declare TextToSpeech.Engine.INTENT_ACTION_TTS_SERVICE in the queries elements of their manifest:

<queries>
  <intent>
    <action android:name="android.intent.action.TTS_SERVICE" />
  </intent>
</queries>

Here you can find an example commit.

Configuration

No configuration required for this plugin.

Demo

A working example can be found here: robingenz/capacitor-plugin-demo

Usage

import { TextToSpeech } from '@capacitor-community/text-to-speech';

const speak = async () => {
  await TextToSpeech.speak({
    text: 'This is a sample text.',
    lang: 'en-US',
    rate: 1.0,
    pitch: 1.0,
    volume: 1.0,
    category: 'ambient',
  });
};

const stop = async () => {
  await TextToSpeech.stop();
};

const getSupportedLanguages = async () => {
  const languages = await TextToSpeech.getSupportedLanguages();
};

const getSupportedVoices = async () => {
  const voices = await TextToSpeech.getSupportedVoices();
};

const isLanguageSupported = async (lang: string) => {
  const isSupported = await TextToSpeech.isLanguageSupported({ lang });
};

API

• initialize(...)
• speak(...)
• stop()
• getSupportedLanguages()
• getSupportedVoices()
• isLanguageSupported(...)
• openInstall()
• Interfaces

initialize(...)

initialize(options: InitializeOptions) => Promise<void>

Initializes the TTS engine.

This method should be called before any other methods.

Param	Type
options	InitializeOptions

Since: 4.1.0

---

speak(...)

speak(options: TTSOptions) => Promise<void>

Starts the TTS engine and plays the desired text.

Param	Type
options	TTSOptions

---

stop()

stop() => Promise<void>

Stops the TTS engine.

---

getSupportedLanguages()

getSupportedLanguages() => Promise<{ languages: string[]; }>

Returns a list of supported BCP 47 language tags.

Returns: Promise<{ languages: string[]; }>

---

getSupportedVoices()

getSupportedVoices() => Promise<{ voices: SpeechSynthesisVoice[]; }>

Returns a list of supported voices.

Returns: Promise<{ voices: SpeechSynthesisVoice[]; }>

---

isLanguageSupported(...)

isLanguageSupported(options: { lang: string; }) => Promise<{ supported: boolean; }>

Checks if a specific BCP 47 language tag is supported.

Param	Type
options	{ lang: string; }

Returns: Promise<{ supported: boolean; }>

---

openInstall()

openInstall() => Promise<void>

Verifies proper installation and availability of resource files on the system.

Only available for Android.

---

Interfaces

InitializeOptions

Prop	Type	Description	Since
engine	string	The engine to use for TTS. Only available for Android.	4.1.0

TTSOptions

Prop	Type	Description	Default
text	string	The text that will be synthesised when the utterance is spoken.
lang	string	The language of the utterance. Possible languages can be queried using getSupportedLanguages.	"en-US"
rate	number	The speed at which the utterance will be spoken at.	1.0
pitch	number	The pitch at which the utterance will be spoken at.	1.0
volume	number	The volume that the utterance will be spoken at.	1.0
voice	number	The index of the selected voice that will be used to speak the utterance. Possible voices can be queried using getSupportedVoices.
category	string	Select the iOS Audio session category. Possible values: ambient and playback. Use playback to play audio even when the app is in the background. Only available for iOS.	"ambient"

SpeechSynthesisVoice

The SpeechSynthesisVoice interface represents a voice that the system supports.

Prop	Type	Description
default	boolean	Specifies whether the voice is the default voice for the current app (true) or not (false).
lang	string	BCP 47 language tag indicating the language of the voice.
localService	boolean	Specifies whether the voice is supplied by a local (true) or remote (false) speech synthesizer service.
name	string	Human-readable name that represents the voice.
voiceURI	string	Type of URI and location of the speech synthesis service for this voice.

Changelog

See CHANGELOG.md.

License

See LICENSE.