mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-03-09 20:57:11 +00:00
98_Text2Speech.pm: some Improvements by Mirko
git-svn-id: https://svn.fhem.de/fhem/trunk@24138 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
Tobias.Faust
parent
687e42c137
commit
b48c93bf4f
@ -1,5 +1,6 @@
|
||||
# Add changes at the top of the list. Keep it in ASCII, and 80-char wide.
|
||||
# Do not insert empty lines here, update check depends on it.
|
||||
- bugfix: 98_Text2Speech.pm: some Improvements by Mirko
|
||||
- change: 73_GardenaSmartBridge: Change part of code for new API
|
||||
- bugfix: 47_OBIS: fixed bug with 64 bit integer numbers
|
||||
- change: 46_TeslaPowerwall2AC: Code rewrite for new Auth API and
|
||||
|
||||
@ -15,8 +15,6 @@
|
||||
# ALL ALL = NOPASSWD: /usr/bin/mplayer
|
||||
##############################################
|
||||
|
||||
# VoiceRSS: http://www.voicerss.org/api/documentation.aspx
|
||||
|
||||
package main;
|
||||
use strict;
|
||||
use warnings;
|
||||
@ -240,37 +238,37 @@ sub Text2Speech_loadmodules($$) {
|
||||
require IO::File;
|
||||
IO::File->import;
|
||||
1;
|
||||
} or return "IO::File Module not installed, please install";
|
||||
} or return "IO::File Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require Digest::MD5;
|
||||
Digest::MD5->import;
|
||||
1;
|
||||
} or return "Digest::MD5 Module not installed, please install";
|
||||
} or return "Digest::MD5 Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require URI::Escape;
|
||||
URI::Escape->import;
|
||||
1;
|
||||
} or return "URI::Escape Module not installed, please install";
|
||||
} or return "URI::Escape Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require Text::Iconv;
|
||||
Text::Iconv->import;
|
||||
1;
|
||||
} or return "Text::Iconv Module not installed, please install";
|
||||
} or return "Text::Iconv Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require Encode::Guess;
|
||||
Encode::Guess->import;
|
||||
1;
|
||||
} or return "Encode::Guess Module not installed, please install";
|
||||
} or return "Encode::Guess Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require MP3::Info;
|
||||
MP3::Info->import;
|
||||
1;
|
||||
} or return "MP3::Info Module not installed, please install";
|
||||
} or return "MP3::Info Module not installed. Please install.";
|
||||
|
||||
if ($TTS_Ressource eq "Amazon-Polly") {
|
||||
# Module werden nur benötigt mit der Polly Engine
|
||||
@ -278,7 +276,7 @@ sub Text2Speech_loadmodules($$) {
|
||||
require Paws::Polly;
|
||||
Paws::Polly->import;
|
||||
1;
|
||||
} or return "Paws Module not installed. Please install, goto https://metacpan.org/source/JLMARTIN/Paws-0.39";
|
||||
} or return "Paws Module not installed. Please install.";
|
||||
|
||||
eval {
|
||||
require File::HomeDir;
|
||||
@ -522,6 +520,8 @@ sub Text2Speech_Set($@)
|
||||
|
||||
if($cmd ne "tts") {
|
||||
return "$cmd needs $sets{$cmd} parameter(s)" if(@a-$sets{$cmd} != 0);
|
||||
} else {
|
||||
return "$cmd needs text parameter" if(@a-$sets{$cmd} < 0);
|
||||
}
|
||||
|
||||
# Abbruch falls Disabled
|
||||
@ -585,6 +585,18 @@ sub Text2Speech_PrepareSpeech($$) {
|
||||
my $TTS_ForceSplit = 0;
|
||||
my $TTS_AddDelimiter;
|
||||
|
||||
# Cleanup string
|
||||
$hash->{helper}{TTS_PlayerOptions} = "";
|
||||
while ($t =~ s/^ //isg) {};
|
||||
$t =~ s/^'(.*)'$/$1/;
|
||||
$t =~ s/^"(.*)"$/$1/;
|
||||
|
||||
# Check text for command string
|
||||
if ($t =~ /^\[(.*?)\](.*?)$/) {
|
||||
($hash->{helper}{TTS_PlayerOptions}, $t) = ($1, $2);
|
||||
while ($t =~ s/^ //isg) {};
|
||||
}
|
||||
|
||||
if($TTS_Delimiter && $TTS_Delimiter =~ m/^[+-]a[lfn]/i) {
|
||||
$TTS_ForceSplit = 1 if(substr($TTS_Delimiter,0,1) eq "+");
|
||||
$TTS_ForceSplit = 0 if(substr($TTS_Delimiter,0,1) eq "-");
|
||||
@ -771,13 +783,13 @@ sub Text2Speech_BuildMplayerCmdString($$) {
|
||||
|
||||
my $NoDebug = $mplayerNoDebug;
|
||||
$NoDebug = "" if($verbose >= 5);
|
||||
|
||||
# anstatt mplayer wird ein anderer Player verwendet
|
||||
if ($TTS_MplayerCall !~ m/mplayer/) {
|
||||
$TTS_MplayerCall =~ s/{device}/$AlsaDevice/g;
|
||||
$TTS_MplayerCall =~ s/{volume}/$hash->{VOLUME}/g;
|
||||
$TTS_MplayerCall =~ s/{volumeadjust}/$TTS_VolumeAdjust/g;
|
||||
$TTS_MplayerCall =~ s/{file}/$file/g;
|
||||
$TTS_MplayerCall =~ s/{options}/$hash->{helper}{TTS_PlayerOptions}/g;
|
||||
|
||||
$cmd = $TTS_MplayerCall;
|
||||
} else {
|
||||
@ -993,7 +1005,7 @@ sub Text2Speech_DoIt($) {
|
||||
$file = $TTS_CacheFileDir."/".$filename;
|
||||
Log3 $hash->{NAME}, 4, $hash->{NAME}.": $filename als direkte MP3 Datei erkannt!";
|
||||
} else {
|
||||
$filename = md5_hex($language{$TTS_Ressource}{$TTS_Language} ."|". $t) . ".mp3";
|
||||
$filename = md5_hex($TTS_Ressource ."|". $t) . ".mp3";
|
||||
$file = $TTS_CacheFileDir."/".$filename;
|
||||
Log3 $hash->{NAME}, 4, $hash->{NAME}.": Textbaustein ist keine direkte MP3 Datei, ermittle MD5 CacheNamen: $filename";
|
||||
}
|
||||
@ -1211,8 +1223,11 @@ sub Text2Speech_WriteStats($$$$){
|
||||
|
||||
=pod
|
||||
=item helper
|
||||
=item summary speaks given text via loudspeaker
|
||||
=item summary_DE wandelt Text in Sprache um zur Ausgabe auf Lautsprecher
|
||||
=item summary A module that converts text to speech and also plays \
|
||||
the result on a local or remote loudspeaker
|
||||
|
||||
=item summary_DE Modul, das Text in Sprache umwandelt und das Ergebnis \
|
||||
über einen lokalen oder entfernten Lautsprecher wiedergibt
|
||||
=begin html
|
||||
|
||||
<a name="Text2Speech"></a>
|
||||
@ -1224,22 +1239,25 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<ul>
|
||||
<b>Local : </b><code>define <name> Text2Speech <alsadevice></code><br>
|
||||
<b>Remote: </b><code>define <name> Text2Speech <host>[:<portnr>][:SSL] [portpassword]</code>
|
||||
<b>Server: </b><code>define <name> Text2Speech none</code><br>
|
||||
<p>
|
||||
This module converts any text into speech with serveral possible providers. The Device can be defined as locally
|
||||
or remote device.
|
||||
This module converts any text into speech with several possible providers. The Device can be defined as locally
|
||||
or remote instance.
|
||||
</p>
|
||||
|
||||
<li>
|
||||
<b>Local Device</b><br>
|
||||
<ul>
|
||||
The output will be send to any connected audiodevice. For example external speakers connected per jack
|
||||
or with bluetooth speakers - connected per bluetooth dongle. Its important to install mplayer.<br>
|
||||
The output will be sent to any connected audio device. For example speakers connected per jack,
|
||||
network, WiFI or Bluetooth. Playback can be done using MPlayer or any other application.<br>
|
||||
<br>
|
||||
Mplayer installation under Debian/Ubuntu/Raspbian:<br>
|
||||
<code>apt-get install mplayer</code><br>
|
||||
The given alsadevice has to be configured in <code>/etc/asound.conf</code>
|
||||
The given alsa device has to be configured in <code>/etc/asound.conf</code>
|
||||
<p>
|
||||
<b>Special AlsaDevice: </b><i>default</i><br>
|
||||
The internal mplayer command will be without any audio directive if the given alsadevice is <i>default</i>.
|
||||
In this case mplayer is using the standard audiodevice.
|
||||
The internal Mplayer command will be without any audio directive if the given alsa device is <i>default</i>.
|
||||
In this case Mplayer is using the standard audio device.
|
||||
</p>
|
||||
<p>
|
||||
<b>Example:</b><br>
|
||||
@ -1252,7 +1270,7 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<li>
|
||||
<b>Remote Device</b><br>
|
||||
<ul>
|
||||
This module can configured as remote-device for client-server Environments. The Client has to be configured
|
||||
This module can be configured as remote-device for client-server environments. The Client has to be configured
|
||||
as local device.<br>
|
||||
Notice: the Name of the locally instance has to be the same!
|
||||
<ul>
|
||||
@ -1273,9 +1291,13 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<li>
|
||||
<b>Server Device</b>
|
||||
<ul>
|
||||
In case of an usage of an Server, only the mp3 file will be generated.It makes no sence to use the attribute <i>TTS_speakAsFastAsPossible</i>.
|
||||
Its recommend, to use the attribute <i>TTS_useMP3Wrap</i>. Otherwise only the last audiobrick will be shown is reading <i>lastFilename</i>.
|
||||
In case of an usage as a server, only the mp3 file will be generated and displayed as lastFilename reading. It makes no sense to use the attribute <i>TTS_speakAsFastAsPossible</i> here.
|
||||
Its recommend, to use the attribute <i>TTS_useMP3Wrap</i>. Otherwise only the last audiobrick will be shown in reading <i>lastFilename</i>.
|
||||
</ul>
|
||||
<p>
|
||||
<b>Example:</b><br>
|
||||
<code>define MyTTS Text2Speech none</code>
|
||||
</p>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@ -1285,9 +1307,11 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<b>Set</b>
|
||||
<ul>
|
||||
<li><b>tts</b>:<br>
|
||||
Giving a text to translate into audio. You play set mp3-files directly. In this case you have to enclosure them with a single colon before and after the declaration.
|
||||
The files must save under the directory of given <i>TTS_FileTemplateDir</i>.
|
||||
Please note: The text doesn´t have any colons itself.
|
||||
Definition of text for voice output. To output mp3 files directly, they must be specified with
|
||||
leading and closing colons. Therefore, the text itself must not contain any double punctuation.
|
||||
The mp3 files must be stored in the <i>TTS_FileTemplateDir</i> directory.
|
||||
SSML can be used for the Amazon Polly language engine. See examples.
|
||||
|
||||
</li>
|
||||
<li><b>volume</b>:<br>
|
||||
Setting up the volume audio response.<br>
|
||||
@ -1303,33 +1327,32 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<b>Attributes</b>
|
||||
<ul>
|
||||
<li>TTS_Delimiter<br>
|
||||
optional: By using the google engine, its not possible to convert more than 100 characters in a single audio brick.
|
||||
With a Delimiter the audio brick will be split at this character. A Delimiter must be a single character.!<br>
|
||||
By default, ech audio brick will be split at sentence end. Is a single sentence longer than 100 characters,
|
||||
Optional: By using the Google engine, its not possible to convert more than 100 characters in a single audio brick.
|
||||
With a delimiter the audio brick will be split at this character. A delimiter must be a single character!<br>
|
||||
By default, each audio brick will be split at sentence end. Is a single sentence longer than 100 characters,
|
||||
the sentence will be split additionally at comma, semicolon and the word <i>and</i>.<br>
|
||||
Notice: Only available in locally instances with Google engine!
|
||||
</li>
|
||||
|
||||
<li>TTS_Ressource<br>
|
||||
optional: Selection of the Translator Engine<br>
|
||||
Optional: Selection of the Translator Engine<br>
|
||||
Notice: Only available in locally instances!
|
||||
<ul>
|
||||
<li>Google<br>
|
||||
Using the Google Engine. It´s nessessary to have internet access. This engine is the recommend engine
|
||||
because the quality is fantastic. This engine is using by default.
|
||||
Google Engine. Prerequisite: Active Internet connection<br>
|
||||
This engine is recommended for its quality and is used by default.
|
||||
</li>
|
||||
<li>VoiceRSS<br>
|
||||
Using the VoiceRSS Engine. Its a free engine till 350 requests per day. If you need more, you have to pay.
|
||||
It´s nessessary to have internet access. This engine is the 2nd recommend engine
|
||||
because the quality is also fantastic. To use this engine you need an APIKey (see TTS_APIKey)
|
||||
VoiceRSS Engine. Prerequisite: Active Internet connection<br>
|
||||
Free of charge up to 350 requests per day. If you need more, you have to pay.
|
||||
This engine is also recommended due to its quality. To use this engine, you need an APIKey (see TTS_APIKey)
|
||||
</li>
|
||||
<li>ESpeak<br>
|
||||
Using the ESpeak Engine. Installation Espeak and lame is required.<br>
|
||||
<code>apt-get install espeak lame</code>
|
||||
eSpeak Engine. Prerequisite: Installation of Espeak and lame<br>
|
||||
eSpeak is an open source software speech synthesizer for English and other languages.
|
||||
</li>
|
||||
<li>SVOX-pico<br>
|
||||
Using the SVOX-Pico TTS-Engine (from the AOSP).<br>
|
||||
Installation of the engine and <code>lame</code> is required:<br>
|
||||
SVOX-Pico TTS-Engine (from the AOSP). Prerequisite: Installation of SVOX-Pico and lame<br>
|
||||
<code>sudo apt-get install libttspico-utils lame</code><br><br>
|
||||
On ARM/Raspbian the package <code>libttspico-utils</code>,<br>
|
||||
so you may have to compile it yourself or use the precompiled package from <a target="_blank" href"http://www.robotnet.de/2014/03/20/sprich-freund-und-tritt-ein-sprachausgabe-fur-den-rasberry-pi/">this guide</a>, in short:<br>
|
||||
@ -1339,8 +1362,8 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<code>sudo dpkg --install pico2wave.deb</code>
|
||||
</li>
|
||||
<li>Amazon-Polly<br>
|
||||
Using the Amazon Polly engine, the same as Amazon Alexa.<br>
|
||||
The perl package Paws is required. An AWS Access and Polly Aws User is required too<br>
|
||||
Amazon Polly Engine. Prerequisite: Active Internet connection, Perl package Paws<br>
|
||||
Amazon service that turns text into lifelike speech. An AWS Access and Polly Aws User is required.<br>
|
||||
<code>cpan paws</code><br>
|
||||
The credentials to your AWS Polly are expected at ~/.aws/credentials<br>
|
||||
<code>[default]
|
||||
@ -1356,52 +1379,67 @@ sub Text2Speech_WriteStats($$$$){
|
||||
</li>
|
||||
|
||||
<li>TTS_Language_Custom<br>
|
||||
if you want another engine and speech of default languages, you can insert this here.<br>
|
||||
The definition is dependent of used engine. This attribute overrides an TTS_Language attribute.<br>
|
||||
Please refer the specific API reference.
|
||||
If you want another engine and speech of default languages, you can insert this here.<br>
|
||||
The definition depends on the used engine. This attribute overrides an TTS_Language attribute.<br>
|
||||
Please refer to the specific API reference.
|
||||
</li>
|
||||
|
||||
<li>TTS_APIKey<br>
|
||||
An APIKey its needed if you want to use VoiceRSS. You have to register at the following page:<br>
|
||||
http://www.voicerss.org/registration.aspx <br>
|
||||
After this, you will get your personal APIKey.
|
||||
An APIKey is needed if you want to use VoiceRSS. You have to register at the following page:<br>
|
||||
http://www.voicerss.org/registration.aspx
|
||||
</li>
|
||||
|
||||
<li>TTS_User<br>
|
||||
Actual without any usage. Needed in case if a TTS Engine need an username and an apikey for each request.
|
||||
Actual without any usage. Needed in case if a TTS Engine needs a username and an APIKey for a request.
|
||||
</li>
|
||||
|
||||
<li>TTS_CacheFileDir<br>
|
||||
optional: The downloaded Goole audio bricks are saved in this folder for reusing.
|
||||
No automatically implemented deleting are available.<br>
|
||||
Optional: The downloaded Google audio bricks are saved in this folder.
|
||||
No automatic delete/cleanup available.<br>
|
||||
Default: <i>cache/</i><br>
|
||||
Notice: Only available in locally instances!
|
||||
Notice: Available on local instances only!
|
||||
</li>
|
||||
|
||||
<li>TTS_UseMP3Wrap<br>
|
||||
optional: To become a liquid audio response its recommend to use the tool mp3wrap.
|
||||
Each downloaded audio bricks are concatinated to a single audio file to play with mplayer.<br>
|
||||
Installtion of the mp3wrap source is required.<br>
|
||||
For best voice output, it is recommended that the individual downloads are combined into a single file.
|
||||
Each downloaded audio bricks are concatinated to a single audio file to play with Mplayer.<br>
|
||||
Installtion of the mp3wrap package is required.<br>
|
||||
<code>apt-get install mp3wrap</code><br>
|
||||
Notice: Only available in locally instances!
|
||||
Notice: Available on local instances only!
|
||||
</li>
|
||||
|
||||
<li>TTS_MplayerCall<br>
|
||||
optional: Setting up the Mplayer system call. The following example is default.<br>
|
||||
Example: <code>sudo /usr/bin/mplayer</code>
|
||||
Optional: Definition of the system call to Mplayer or a different tool.<br>
|
||||
If a tool other than Mplayer is used, the following templates apply:<br>
|
||||
<ul>
|
||||
<li>{device}</li>
|
||||
<li>{volume}</li>
|
||||
<li>{volumeadjust}</li>
|
||||
<li>{file}</li>
|
||||
<li>{options}</li>
|
||||
</ul>
|
||||
{options} are provided inside the text in parentheses during the set command.
|
||||
Used for example to set special parameters for each call separately<br>
|
||||
Example: <code>set myTTS tts [192.168.0.1:7000] This is my text</code><br><br>
|
||||
|
||||
Examples:<br>
|
||||
<code>attr myTTS TTS_MplayerCall sudo /usr/bin/mplayer</code><br>
|
||||
<code>attr myTTS TTS_MplayerCall AUDIODEV={device} play -q -v {volume} {file}</code><br>
|
||||
<code>attr myTTS TTS_MplayerCall player {file} {options}</code><br>
|
||||
|
||||
</li>
|
||||
|
||||
<li>TTS_SentenceAppendix<br>
|
||||
Optional: Definition of one mp3-file to append each time of audio response.<br>
|
||||
Using of Mp3Wrap is required. The audio bricks has to be downloaded before into CacheFileDir.
|
||||
Mp3Wrap is required. The audio chunks must be downloaded to the CacheFileDir beforehand.
|
||||
Example: <code>silence.mp3</code>
|
||||
</li>
|
||||
|
||||
<li>TTS_FileMapping<br>
|
||||
Definition of mp3files with a custom templatedefinition. Separated by space.
|
||||
All templatedefinitions can used in audiobricks by <i>tts</i>.
|
||||
The definition must begin and end with e colon.
|
||||
The mp3files must saved in the given directory by <i>TTS_FIleTemplateDir</i>.<br>
|
||||
Definition of mp3files with a custom template definition. Separated by space.
|
||||
All template definitions can be used in audiobricks by <i>tts</i> command.
|
||||
The definition must begin and end with a colon.
|
||||
The mp3files must be saved in <i>TTS_FIleTemplateDir</i>.<br>
|
||||
<code>attr myTTS TTS_FileMapping ring:ringtone.mp3 beep:MyBeep.mp3</code><br>
|
||||
<code>set MyTTS tts Attention: This is my ringtone :ring: Its loud?</code>
|
||||
</li>
|
||||
@ -1411,41 +1449,60 @@ sub Text2Speech_WriteStats($$$$){
|
||||
Optional, Default: <code>cache/templates</code>
|
||||
</li>
|
||||
|
||||
<li>TTS_VolumeAdjust<br>
|
||||
Basic volume increase<br>
|
||||
Default: 110<br>
|
||||
<code>attr myTTS TTS_VolumeAdjust 400</code>
|
||||
</li>
|
||||
|
||||
<li>TTS_noStatisticsLog<br>
|
||||
If set to <b>1</b>, it prevents logging statistics to DbLog Devices, default is <b>0</b><br>
|
||||
But please notice: this looging is important to able to delete longer unused cachefiles. If you disable this
|
||||
please take care to cleanup your cachedirectory by yourself.
|
||||
Note: This logging is important to be able to delete cache files that have not been used for a longer period of time.
|
||||
If you disable this, you will have to clean your cache directory manually.
|
||||
</li>
|
||||
|
||||
<li>TTS_speakAsFastAsPossible<br>
|
||||
Trying to get an speach as fast as possible. In case of not present audiobricks, you can hear a short break.
|
||||
The audiobrick will be download at this time. In case of an presentation of all audiobricks at local cache,
|
||||
this attribute has no impact.<br>
|
||||
Attribute only valid in case of an local or server instance.
|
||||
Trying to get a speech as fast as possible. In case of not present audio bricks, you can
|
||||
hear a short break as the audio brick will be downloaded at this time.
|
||||
In case of a presentation of all audio bricks at local cache, this attribute has no impact.<br>
|
||||
Attribute is only valid on local or server instances.
|
||||
</li>
|
||||
|
||||
<li>TTS_OutputFile<br>
|
||||
Definition of a fixed file name as mp3 output. The attribute is only relevant in conjunction with TTS_UseMP3Wrap.
|
||||
If a file name is specified, then TTS_CacheFileDir is also taken into account.<br>
|
||||
<code>attr myTTS TTS_OutputFile output.mp3</code><br>
|
||||
<code>attr myTTS TTS_OutputFile /media/miniDLNA/output.mp3</code><br>
|
||||
</li>
|
||||
|
||||
<li><a href="#readingFnAttributes">readingFnAttributes</a></li><br>
|
||||
|
||||
<li><a href="#disable">disable</a><br>
|
||||
If this attribute is activated, the soundoutput will be disabled.<br>
|
||||
If this attribute is activated, the sound output will be disabled.<br>
|
||||
Possible values: 0 => not disabled , 1 => disabled<br>
|
||||
Default Value is 0 (not disabled)<br><br>
|
||||
</li>
|
||||
|
||||
<li><a href="#verbose">verbose</a><br>
|
||||
<li><a href="#verbose">verbose</a><br>
|
||||
<b>4:</b> each step will be logged<br>
|
||||
<b>5:</b> Additionally the individual debug informations from mplayer and mp3wrap will be logged
|
||||
<b>5:</b> Additionally the individual debug information from Mplayer and mp3wrap will be logged
|
||||
</li>
|
||||
|
||||
</ul><br>
|
||||
|
||||
<a name="Text2SpeechExamples"></a>
|
||||
<b>Beispiele</b>
|
||||
<b>Examples</b>
|
||||
<ul>
|
||||
<code>define TTS_EG_WZ Text2Speech hw=/dev/snd/controlC3</code><br>
|
||||
<code>attr TTS_EG_WZ TTS_Language English</code><br>
|
||||
<code>attr TTS_EG_WZ TTS_Ressource Amazon-Polly</code><br>
|
||||
<code>attr TTS_EG_WZ TTS_UseMP3Wrap 1</code><br><br>
|
||||
<code>set MyTTS tts <speak>Mary had a little lamb.</speak></code>
|
||||
<br>
|
||||
<code>define MyTTS Text2Speech hw=0.0</code><br>
|
||||
<code>set MyTTS tts Die Alarmanlage ist bereit.</code><br>
|
||||
<code>set MyTTS tts The alarm system is ready.</code><br>
|
||||
<code>set MyTTS tts :beep.mp3:</code><br>
|
||||
<code>set MyTTS tts :mytemplates/alarm.mp3:Die Alarmanlage ist bereit.:ring.mp3:</code><br>
|
||||
<code>set MyTTS tts :mytemplates/alarm.mp3:The alarm system is ready.:ring.mp3:</code><br>
|
||||
</ul>
|
||||
|
||||
=end html
|
||||
@ -1469,14 +1526,17 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<li>
|
||||
<b>Local Device</b><br>
|
||||
<ul>
|
||||
Die Ausgabe erfolgt auf angeschlossenen Audiodevices, zb. Lautsprecher direkt am Gerät oder per
|
||||
Bluetooth-Lautsprecher per Mplayer. Dazu ist Mplayer zu installieren.<br>
|
||||
Die Ausgabe wird an jedes angeschlossene Audiogerät gesendet. Zum Beispiel an einen lokalen Lautsprecher oder an
|
||||
entfernte Geräte via Netzwerk, WiFI oder Bluetooth. Die Wiedergabe kann über MPlayer oder jede andere
|
||||
Anwendung erfolgen.<br>
|
||||
<br>
|
||||
Mplayer-Installation unter Debian/Ubuntu/Raspbian:<br>
|
||||
<code>apt-get install mplayer</code><br>
|
||||
Das angegebene Alsadevice ist in der <code>/etc/asound.conf</code> zu konfigurieren.
|
||||
Das angegebene Alsa-Device ist in der <code>/etc/asound.conf</code> zu konfigurieren.
|
||||
<p>
|
||||
<b>Special AlsaDevice: </b><i>default</i><br>
|
||||
Ist als Alsa-Device <i>default</i> angegeben, so wird mplayer ohne eine Audiodevice Angabe aufgerufen.
|
||||
Dementsprechend verwendet mplayer das Standard Audio Ausgabedevice.
|
||||
Ist als Alsa-Device <i>default</i> angegeben, so wird Mplayer ohne eine Audiodevice-Angabe aufgerufen.
|
||||
Dementsprechend verwendet Mplayer dann das Standard-Audio Ausgabedevice.
|
||||
</p>
|
||||
<p>
|
||||
<b>Beispiel:</b><br>
|
||||
@ -1492,33 +1552,34 @@ sub Text2Speech_WriteStats($$$$){
|
||||
Das Modul ist Client-Server fäas bedeutet, das auf der Haupt-FHEM Installation eine Text2Speech-Instanz
|
||||
als Remote definiert wird. Auf dem Client wird Text2Speech als Local definiert. Die Sprachausgabe erfolgt auf
|
||||
der lokalen Instanz.<br>
|
||||
Zu beachten ist, das die Text2Speech Instanz (Definition als local Device) auf dem Zieldevice identisch benannt ist.
|
||||
Zu beachten ist, dass die Text2Speech Instanz (Definition als Local-Device) auf dem Zieldevice identisch benannt ist.
|
||||
<ul>
|
||||
<li>Host: Angabe der IP-Adresse</li>
|
||||
<li>PortNr: Angabe des TelnetPorts von FHEM; default: 7072</li>
|
||||
<li>SSL: Angabe ob der der Zugriff per SSL erfolgen soll oder nicht; default: kein SSL</li>
|
||||
<li>PortPassword: Angabe des in der Ziel-FHEM-Installtion angegebene Telnet Portpasswort</li>
|
||||
<li>PortNr: Angabe des Telnet-Ports von FHEM; default: 7072</li>
|
||||
<li>SSL: Angabe, ob der Zugriff per SSL erfolgen soll oder nicht; default: kein SSL</li>
|
||||
<li>PortPassword: Angabe des in der Ziel-FHEM-Installation angegebenen Telnet-Passworts</li>
|
||||
</ul>
|
||||
<p>
|
||||
<b>Beispiel:</b><br>
|
||||
<code>define MyTTS Text2Speech 192.168.178.10:7072 fhempasswd</code>
|
||||
<code>define MyTTS Text2Speech 192.168.178.10</code>
|
||||
</p>
|
||||
Wenn ein PRESENCE Gerät die Host IP-Adresse abfragt, wird die blockierende interne Prüfung auf Erreichbarkeit umgangen und das PRESENCE Gerät genutzt.
|
||||
Wenn ein PRESENCE Gerät die Host-IP-Adresse abfragt, wird die blockierende interne Prüfung auf Erreichbarkeit umgangen und das PRESENCE Gerät genutzt.
|
||||
</ul>
|
||||
</li>
|
||||
|
||||
<li>
|
||||
<b>Server Device</b>
|
||||
<ul>
|
||||
Im Falle der Verwendung als Server, wird nur die MP3 Datei erstellt und als Reading lastFilename dargestellt. Es macht keinen Sinn
|
||||
hier das Attribut <i>TTS_speakAsFastAsPossible</i> zu verwenden. Die Verwendung des Attributes <i>TTS_useMP3Wrap</i> wird dringend empfohlen.
|
||||
Im Falle der Verwendung als Server wird nur die MP3-Datei erstellt und als Reading lastFilename dargestellt.
|
||||
Es ergibt keinen Sinn hier das Attribut <i>TTS_speakAsFastAsPossible</i> zu verwenden.
|
||||
Die Verwendung des Attributs <i>TTS_useMP3Wrap</i> wird dringend empfohlen.
|
||||
Ansonsten wird hier nur der letzte Teiltext als mp3 Datei im Reading dargestellt.
|
||||
</ul>
|
||||
<p>
|
||||
<b>Beispiel:</b><br>
|
||||
<code>define MyTTS Text2Speech none</code>
|
||||
</p>
|
||||
</p>
|
||||
</li>
|
||||
|
||||
</ul>
|
||||
@ -1530,8 +1591,8 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<li><b>tts</b>:<br>
|
||||
Setzen eines Textes zur Sprachausgabe. Um mp3-Dateien direkt auszugeben, müssen diese mit führenden
|
||||
und schließenden Doppelpunkten angegebenen sein. Die MP3-Dateien müssen unterhalb des Verzeichnisses <i>TTS_FileTemplateDir</i> gespeichert sein.<br>
|
||||
Der Text selbst darf deshalb selbst keine Doppelpunte beinhalten. <br>
|
||||
Für die SpracheEngine Amazon Polly kann auch SSML verwendet werden, Siehe Beispiele.
|
||||
Der Text selbst darf deshalb selbst keine Doppelpunkte beinhalten. <br>
|
||||
Für die Sprachengine Amazon Polly kann auch SSML verwendet werden. Siehe Beispiele.
|
||||
</li>
|
||||
<li><b>volume</b>:<br>
|
||||
Setzen der Ausgabe Lautstärke.<br>
|
||||
@ -1549,13 +1610,13 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<li>TTS_Delimiter<br>
|
||||
Optional: Wird ein Delimiter angegeben, so wird der Sprachbaustein an dieser Stelle geteilt.
|
||||
Als Delimiter ist nur ein einzelnes Zeichen zulässig.
|
||||
Hintergrund ist die Tatsache, das die einige Sprachengines nur eine bestimmt Anzahl an Zeichen (zb. Google nur 100Zeichen) zulässt.<br>
|
||||
Hintergrund ist die Tatsache, dass die einige Sprachengines nur eine bestimmte Anzahl an Zeichen (z. B. Google nur 100Zeichen) zulässt.<br>
|
||||
Im Standard wird nach jedem Satzende geteilt. Ist ein einzelner Satz länger als 100 Zeichen,
|
||||
so wird zusätzlich nach Kommata, Semikolon und dem Verbindungswort <i>und</i> geteilt.<br>
|
||||
Achtung: Nur bei einem lokal definierter Text2Speech Instanz möglich!<br>
|
||||
<b>Notation</b><br>
|
||||
+ -> erzwinge das Trennen, auch wenn Textbaustein < x Zeichen<br>
|
||||
- -> Trenne nur wenn Textbaustein > x Zeichen
|
||||
- -> trenne, nur wenn Textbaustein > x Zeichen
|
||||
af -> add first -> füge den Delimiter am Satzanfang wieder hinzu<br>
|
||||
al -> add last -> füge den Delimiter am Satzende wieder hinzu<br>
|
||||
an -> add nothing -> Delimiter nicht wieder hinzufügen<br>
|
||||
@ -1569,22 +1630,22 @@ sub Text2Speech_WriteStats($$$$){
|
||||
Achtung: Nur bei einem lokal definierter Text2Speech Instanz möglich!
|
||||
<ul>
|
||||
<li>Google<br>
|
||||
Nutzung der Google Sprachengine. Ein Internetzugriff ist notwendig! Aufgrund der Qualität ist der
|
||||
Einsatz diese Engine zu empfehlen und der Standard.
|
||||
Google Sprachengine. Voraussetzung: Aktive Internetverbindung<br>
|
||||
Aufgrund der Qualität ist der Einsatz der Engine empfohlen und daher der Standard.
|
||||
</li>
|
||||
<li>VoiceRSS<br>
|
||||
Nutzung der VoiceRSS Sprachengine. Die Nutzung ist frei bis zu 350 Anfragen pro Tag.
|
||||
Wenn mehr benötigt werden ist ein Bezahlmodell wählbar. Ein Internetzugriff ist notwendig!
|
||||
Aufgrund der Qualität ist der Einsatz diese Engine ebenfalls zu empfehlen.
|
||||
Wenn diese Engine benutzt wird, ist ein APIKey notwendig (siehe TTS_APIKey)
|
||||
VoiceRSS Sprachengine. Voraussetzung: Aktive Internetverbindung<br>
|
||||
Die Nutzung ist frei bis zu 350 Anfragen pro Tag. Wenn mehr benötigt werden, ist ein Bezahlmodell wählbar.
|
||||
Aufgrund der Qualität ist der Einsatz dieser Engine ebenfalls empfohlen.
|
||||
Wird diese Engine benutzt, ist ein APIKey notwendig (siehe TTS_APIKey)
|
||||
</li>
|
||||
<li>ESpeak<br>
|
||||
Nutzung der ESpeak Offline Sprachengine. Die Qualitä ist schlechter als die Google Engine.
|
||||
ESpeak und lame sind vor der Nutzung zu installieren.<br>
|
||||
<code>apt-get install espeak lame</code>
|
||||
ESpeak Sprachengine. Voraussetzung: Installation von Espeak und lame<br>
|
||||
eSpeak ist ein Open-Source-Software-Sprachsynthesizer für Englisch und andere Sprachen.
|
||||
Die Qualitä ist schlechter als die der Google Engine<br>
|
||||
</li>
|
||||
<li>SVOX-pico<br>
|
||||
Nutzung der SVOX-Pico TTS-Engine (aus dem AOSP).<br>
|
||||
SVOX-Pico TTS-Engine (aus dem AOSP). Voraussetzung: Installation von SVOX-Pico and lame<br>
|
||||
Die Sprachengine sowie <code>lame</code> müssen installiert sein:<br>
|
||||
<code>sudo apt-get install libttspico-utils lame</code><br><br>
|
||||
Für ARM/Raspbian sind die <code>libttspico-utils</code> leider nicht verfügbar,<br>
|
||||
@ -1595,8 +1656,8 @@ sub Text2Speech_WriteStats($$$$){
|
||||
<code>sudo dpkg --install pico2wave.deb</code>
|
||||
</li>
|
||||
<li>Amazon-Polly<br>
|
||||
Nutzung der Amazon Polly Sprachengine, dieselbe Engine wie für Amazon Alexa verwendet wird.<br>
|
||||
Es muss das Perl Package Paws installiert sowie ein AWS Konto und ein Polly AWS User verfügbar sein<br>
|
||||
Amazon Polly Sprachengine. Voraussetzung: Aktive Internetverbindung und Perl Package Paws<br>
|
||||
Amazon-Dienst, der Text in lebensechte Sprache umwandelt. Ein AWS Konto und ein Polly AWS User müssen verfügbar sein<br>
|
||||
<code>cpan paws</code><br>
|
||||
Die Zugangsdaten zum eigenen AWS Konto müssen unter ~/.aws/credentials liegen. <br>
|
||||
<code>[default]
|
||||
@ -1608,12 +1669,12 @@ sub Text2Speech_WriteStats($$$$){
|
||||
</li>
|
||||
|
||||
<li>TTS_Language<br>
|
||||
Auswahl verschiendener Standardsprachen
|
||||
Auswahl verschiedener Standardsprachen.
|
||||
</li>
|
||||
|
||||
<li>TTS_Language_Custom<br>
|
||||
Möchte man eine Spreche und Stimme abweichend der Standardspreachen verwenden, so kann man diese hier eintragen. <br>
|
||||
Die Definition ist abhängig der verwendeten Sprachengine. Diesea Attribut überschreibt ein ev. vorhandenes TTS_Langugae Attribut.<br>
|
||||
Möchte man eine Sprache und Stimme abweichend der Standardsprachen verwenden, so kann man diese hier eintragen. <br>
|
||||
Die Definition ist abhängig der verwendeten Sprachengine. Dieses Attribut überschreibt ein ev. vorhandenes TTS_Langugae Attribut.<br>
|
||||
Siehe in die jeweilige API Referenz
|
||||
</li>
|
||||
|
||||
@ -1628,10 +1689,10 @@ sub Text2Speech_WriteStats($$$$){
|
||||
</li>
|
||||
|
||||
<li>TTS_CacheFileDir<br>
|
||||
Optional: Die per Google geladenen Sprachbausteine werden in diesem Verzeichnis zur Wiedeverwendung abgelegt.
|
||||
Es findet zurZeit keine automatisierte Löschung statt.<br>
|
||||
Optional: Die per Google geladenen Sprachbausteine werden in diesem Verzeichnis zur Wiederverwendung abgelegt.
|
||||
Es findet zurzeit keine automatisierte Löschung statt.<br>
|
||||
Default: <i>cache/</i><br>
|
||||
Achtung: Nur bei einem lokal definierter Text2Speech Instanz möglich!
|
||||
Achtung: Nur bei einer lokal definierten Text2Speech-Instanz möglich!
|
||||
</li>
|
||||
|
||||
<li>TTS_UseMP3Wrap<br>
|
||||
@ -1639,21 +1700,27 @@ sub Text2Speech_WriteStats($$$$){
|
||||
geladenen Sprachbausteine zu einem einzelnen Sprachbaustein zusammenfassen zu lassen bevor dieses per
|
||||
Mplayer ausgegeben werden. Dazu muss Mp3Wrap installiert werden.<br>
|
||||
<code>apt-get install mp3wrap</code><br>
|
||||
Achtung: Nur bei einem lokal definierter Text2Speech Instanz möglich!
|
||||
Achtung: Nur bei einer lokal definierten Text2Speech-Instanz möglich!
|
||||
</li>
|
||||
|
||||
<li>TTS_MplayerCall<br>
|
||||
Optional: Angabe des Systemaufrufes zu Mplayer oder einem anderem Tool. Wird ein anderes Tool als mplayer<br>
|
||||
dort verwendet gelten folgende Templates: <br>
|
||||
Optional: Angabe des Systemaufrufs für einen alternativen Player. Wird der Aufruf gesetzt,<br>
|
||||
können folgende Templates genutzt werden: <br>
|
||||
<ul>
|
||||
<li>{device}</li>
|
||||
<li>{volume}</li>
|
||||
<li>{volumeadjust}</li>
|
||||
<li>{file}</li>
|
||||
<li>{options}</li>
|
||||
</ul>
|
||||
Beispiele:<br>
|
||||
<code>attr myTTS TTS_MplayerCall sudo /usr/bin/mplayer</code>
|
||||
<code>attr myTTS TTS_MplayerCall AUDIODEV={device} play -q -v {volume} {file}</code>
|
||||
{options} werden als Text in Klammern bei der Ausführung von set gesetzt, um beispielsweise spezielle
|
||||
Parameter für jeden Aufruf separat zu setzen<br>
|
||||
Beispiel: <code>set myTTS tts [192.168.0.1:7000] Das ist mein Text</code><br><br>
|
||||
|
||||
Beispiel der Definition:<br>
|
||||
<code>attr myTTS TTS_MplayerCall sudo /usr/bin/mplayer</code><br>
|
||||
<code>attr myTTS TTS_MplayerCall AUDIODEV={device} play -q -v {volume} {file}</code><br>
|
||||
<code>attr myTTS TTS_MplayerCall player {file} {options}</code><br>
|
||||
</li>
|
||||
|
||||
<li>TTS_SentenceAppendix<br>
|
||||
@ -1664,8 +1731,8 @@ sub Text2Speech_WriteStats($$$$){
|
||||
</li>
|
||||
|
||||
<li>TTS_FileMapping<br>
|
||||
Angabe von möglichen MP3-Dateien mit deren Templatedefinition. Getrennt duch Leerzeichen.
|
||||
Die Templatedefinitionen können in den per <i>tts</i> übergebenen Sprachbausteinen verwendet werden
|
||||
Angabe von möglichen MP3-Dateien mit deren Template-Definition. Getrennt durch Leerzeichen.
|
||||
Die Template-Definitionen können in den per <i>tts</i> übergebenen Sprachbausteinen verwendet werden
|
||||
und müssen mit einem beginnenden und endenden Doppelpunkt angegeben werden.
|
||||
Die Dateien müssen im Verzeichnis <i>TTS_FileTemplateDir</i> gespeichert sein.<br>
|
||||
<code>attr myTTS TTS_FileMapping ring:ringtone.mp3 beep:MyBeep.mp3</code><br>
|
||||
@ -1685,34 +1752,33 @@ sub Text2Speech_WriteStats($$$$){
|
||||
</li>
|
||||
|
||||
<li>TTS_noStatisticsLog<br>
|
||||
<b>1</b>, verhindert das Loggen von Statistikdaten in DbLog Geräten, default ist <b>0</b><br>
|
||||
Bitte zur Beachtung: Das Logging ist wichtig um alte, lang nicht genutzte Cachedateien automatisiert zu loeschen.
|
||||
Wenn dieses hier dektiviert wird muss sich der User selbst darum kuemmern.
|
||||
<b>1</b>, verhindert das Loggen von Statistikdaten in DbLog Geräten. Default ist <b>0</b><br>
|
||||
Hinweis: Das Logging ist wichtig um alte, lang nicht genutzte Cachedateien automatisiert zu löschen.
|
||||
Wird die Option hier aktiviert, muss sich der Nutzer selbst darum küümmern.
|
||||
</li>
|
||||
|
||||
<li>TTS_speakAsFastAsPossible<br>
|
||||
Es wird versucht, so schnell als möglich eine Sprachausgabe zu erzielen. Bei Sprachbausteinen die nicht bereits lokal vorliegen,
|
||||
ist eine kurze Pause wahrnehmbar. Dann wird der benötigte Sprachbaustein nachgeladen. Liegen alle Sprachbausteine im Cache vor,
|
||||
so hat dieses Attribut keine Auswirkung.<br>
|
||||
Es wird versucht, so schnell als möglich eine Sprachausgabe zu erzielen. Bei Sprachbausteinen
|
||||
die nicht bereits lokal vorliegen, ist eine kurze Pause wahrnehmbar. Dann wird der benötigte
|
||||
Sprachbaustein nachgeladen. Liegen alle Sprachbausteine im Cache vor, so hat dieses Attribut keine Auswirkung.<br>
|
||||
Attribut nur verfügbar bei einer lokalen oder Server Instanz
|
||||
</li>
|
||||
|
||||
<li>TTS_OutputFile<br>
|
||||
Angabe eines fixen Dateinamens als mp3 Output. Das Attribut ist nur relevant in Verbindung mit TTS_UseMP3Wrap.<br>
|
||||
Wenn ein Dateinamen angegeben wird, so wird zusätzlich TTS_CacheFileDir beachtet. Bei einer absoluten Pfadangabe <br>
|
||||
Wenn ein Dateiname angegeben wird, so wird zusätzlich TTS_CacheFileDir beachtet. Bei einer absoluten Pfadangabe
|
||||
muss der Dateipfad durch FHEM schreibbar sein.<br>
|
||||
<code>attr myTTS TTS_OutputFile output.mp3</code><br>
|
||||
<code>attr myTTS TTS_OutputFile /media/miniDLNA/output.mp3</code><br>
|
||||
</li>
|
||||
|
||||
|
||||
<li><a href="#readingFnAttributes">readingFnAttributes</a>
|
||||
</li><br>
|
||||
|
||||
<li><a href="#disable">disable</a><br>
|
||||
If this attribute is activated, the soundoutput will be disabled.<br>
|
||||
Possible values: 0 => not disabled , 1 => disabled<br>
|
||||
Default Value is 0 (not disabled)<br><br>
|
||||
Wird das Attribut aktiviert, wird die Audioausgabe deaktiviert.<br>
|
||||
Mögliche Werte: 0 => nicht deaktiviert , 1 => deaktiviert<br>
|
||||
Standardwert ist 0 (nicht deaktiviert)<br><br>
|
||||
</li>
|
||||
|
||||
<li><a href="#verbose">verbose</a><br>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user