[TTS services] Enhance doc to explain how to setup default voice (#12099)

Signed-off-by: Laurent Garnier <lg.hc@free.fr>

bundles/org.openhab.voice.googletts/README.md

@@ -64,11 +64,18 @@ org.openhab.voice.googletts:speakingRate=1
 org.openhab.voice.googletts:purgeCache=false
 ```
 
-## Voice Configuration
+### Default Text-to-Speech and Voice Configuration
 
-Using your favorite configuration UI:
+You can setup your preferred default Text-to-Speech and default voice in the UI:
 
 * Go to **Settings**.
 * Edit **System Services - Voice**.
 * Set **Google Cloud** as **Default Text-to-Speech**.
 * Choose your preferred **Default Voice** for your setup.
+
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=googletts
+org.openhab.voice:defaultVoice=googletts:XXX
+```

bundles/org.openhab.voice.mactts/README.md

@@ -37,6 +37,22 @@ mactts:Yuna Yuna (ko_KR)
 ...
 ```
 
+### Default Text-to-Speech and Voice Configuration
+
+You can setup your preferred default Text-to-Speech and default voice in the UI:
+
+* Go to **Settings**.
+* Edit **System Services - Voice**.
+* Set **macOS TTS** as **Default Text-to-Speech**.
+* Choose your preferred **Default Voice** for your setup.
+
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=mactts
+org.openhab.voice:defaultVoice=mactts:Alex
+```
+
 ## Supported Audio Formats
 
 The MacTTS service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth and 44.1kHz frequency.

bundles/org.openhab.voice.marytts/README.md

@@ -21,6 +21,22 @@ marytts:bits3hsmm bits3-hsmm (de)
 marytts:bits1hsmm bits1-hsmm (de)
 ```
 
+### Default Text-to-Speech and Voice Configuration
+
+You can setup your preferred default Text-to-Speech and default voice in the UI:
+
+* Go to **Settings**.
+* Edit **System Services - Voice**.
+* Set **MaryTTS** as **Default Text-to-Speech**.
+* Choose your preferred **Default Voice** for your setup.
+
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=marytts
+org.openhab.voice:defaultVoice=marytts:cmuslthsmm
+```
+
 ## Supported Audio Formats
 
 The MaryTTS service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth.

bundles/org.openhab.voice.picotts/README.md

@@ -32,6 +32,22 @@ French (fr-FR)
 Italian (it-IT)
 ```
 
+### Default Text-to-Speech and Voice Configuration
+
+You can setup your preferred default Text-to-Speech and default voice in the UI:
+
+* Go to **Settings**.
+* Edit **System Services - Voice**.
+* Set **PicoTTS** as **Default Text-to-Speech**.
+* Choose your preferred **Default Voice** for your setup.
+
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=picotts
+org.openhab.voice:defaultVoice=picotts:frFR
+```
+
 ## Supported Audio Formats
 
 The Pico service produces audio streams using WAV containers and PCM (signed) codec with 16bit depth.

bundles/org.openhab.voice.pollytts/README.md

@@ -55,6 +55,22 @@ org.openhab.voice.pollytts:cacheExpiration=0
 org.openhab.voice.pollytts:audioFormat=default
 ```
 
+### Default Text-to-Speech and Voice Configuration
+
+You can setup your preferred default Text-to-Speech and default voice in the UI:
+
+* Go to **Settings**.
+* Edit **System Services - Voice**.
+* Set **PollyTTS** as **Default Text-to-Speech**.
+* Choose your preferred **Default Voice** for your setup.
+
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=pollytts
+org.openhab.voice:defaultVoice=pollytts:XXX
+```
+
 ## Rule Examples
 
 ```

bundles/org.openhab.voice.voicerss/README.md

@@ -146,15 +146,22 @@ It supports the following voices (depending on language):
 * Omer (Turkish)
 * Chi (Vietnamese)
 
-### Voice Configuration
+### Default Text-to-Speech and Voice Configuration
 
-You can setup your preferred default voice in the UI:
+You can setup your preferred default Text-to-Speech and default voice in the UI:
 
 * Go to **Settings**.
 * Edit **System Services - Voice**.
 * Set **VoiceRSS** as **Default Text-to-Speech**.
 * Choose your preferred **Default Voice** for your setup.
 
+In case you would like to setup these settings via a text file, you can edit the file `runtime.cfg` in `$OPENHAB_ROOT/conf/services` and set the following entries:
+
+```
+org.openhab.voice:defaultTTS=voicerss
+org.openhab.voice:defaultVoice=voicerss:frFR_Zola
+```
+
 ## Supported Audio Formats
 
 It supports the following audio formats: MP3, OGG, AAC and WAV.