No edit summary |
No edit summary |
||
| (9 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
== Description == | == Description == | ||
The Speak function | The Speak function reads the ''text'' and out loud. It uses the default browser ''voice'', unless a different voice is specified. | ||
The sound of a voice can be modified by setting the following global variables: | The sound of a voice can be modified by setting the following global variables: | ||
| Line 11: | Line 11: | ||
| NSB.speech.lang || The language code. Examples are en-US, de-DE, ar-SA. | | NSB.speech.lang || The language code. Examples are en-US, de-DE, ar-SA. | ||
|- | |- | ||
| NSB.speech.pitch || The pitch of the voice. A value between 0 and 2. Default is 1. | | NSB.speech.pitch || The pitch of the voice. A value between 0 and 2. Default is 1. Fractions are allowed. | ||
|- | |- | ||
| NSB.speech.rate || The speed of the voice. A value from 0 to 10. Default is 1. | | NSB.speech.rate || The speed of the voice. A value from 0 to 10. Default is 1. Fractions are allowed. | ||
|- | |- | ||
| NSB.speech.volume || The loudness of the voice. A value from 0 to 1. Default is 1. | | NSB.speech.volume || The loudness of the voice. A value from 0 to 1. Default is 1. Fractions are allowed. | ||
|} | |} | ||
Not all combinations of pitch, rate and volume are available for all voices. | Not all combinations of pitch, rate and volume are available for all voices. | ||
To see the list of voices for a particular device, use the | To see the list of voices for a particular device, use the SpeedSynthesisAPI sample. You can also check the NSB.voices global variable. | ||
There are differences in implementation between different browsers and operating systems. In particular, each OS has a different list of voices. | There are differences in implementation between different browsers and operating systems. In particular, each OS has a different list of voices. | ||
=== Safari/iOS === | === Safari/iOS === | ||
| Line 36: | Line 36: | ||
Not supported, but it is under consideration. | Not supported, but it is under consideration. | ||
== Example | == Example == | ||
< | <tabber> | ||
JavaScript= | |||
<syntaxhighlight lang="JavaScript"> | |||
// Speak Example | |||
Speak("Hello World!"); | |||
// Set volume to quiet: | |||
NSB.speech.volume = .2; | |||
Speak("Hello World"); | |||
NSB.speech.volume = 1; | |||
// Read in German: | |||
NSB.speech.lang = "de-DE"; | |||
Speak(Button3.text, "Google Deutsch"); | |||
NSB.speech.lang = navigator.language; | |||
// Use a different voice: | |||
var voice; | |||
if (InStr(navigator.vendor, "Apple")) { | |||
voice = "Alex"; | |||
} | |||
if (InStr(navigator.vendor, "Google")) { | |||
voice = "Google UK English Male"; | |||
} | |||
Speak("Hello World", voice);</syntaxhighlight> | |||
|-| | |||
BASIC= | |||
<syntaxhighlight lang="vb.net"> | |||
Rem Speak Example | Rem Speak Example | ||
Speak("Hello World!") | |||
Set volume to quiet: | ' Set volume to quiet: | ||
NSB.speech.volume = .2 | |||
Speak("Hello World") | |||
NSB.speech.volume = 1 | |||
' Read in German: | |||
Read in German: | NSB.speech.lang = "de-DE" | ||
Speak(Button3.text, "Google Deutsch") | |||
NSB.speech.lang = navigator.language | |||
== | ' Use a different voice: | ||
Dim voice | |||
If InStr(navigator.vendor,"Apple") Then voice = "Alex" | |||
If InStr(navigator.vendor,"Google") Then voice = "Google UK English Male" | |||
Speak("Hello World", voice) | |||
< | </syntaxhighlight> | ||
</tabber> | |||
</ | |||
== Output == | == Output == | ||
Speak(text[,voice)
The Speak function reads the text and out loud. It uses the default browser voice, unless a different voice is specified.
The sound of a voice can be modified by setting the following global variables:
| NSB.speech.lang | The language code. Examples are en-US, de-DE, ar-SA. |
| NSB.speech.pitch | The pitch of the voice. A value between 0 and 2. Default is 1. Fractions are allowed. |
| NSB.speech.rate | The speed of the voice. A value from 0 to 10. Default is 1. Fractions are allowed. |
| NSB.speech.volume | The loudness of the voice. A value from 0 to 1. Default is 1. Fractions are allowed. |
Not all combinations of pitch, rate and volume are available for all voices.
To see the list of voices for a particular device, use the SpeedSynthesisAPI sample. You can also check the NSB.voices global variable.
There are differences in implementation between different browsers and operating systems. In particular, each OS has a different list of voices.
Support is excellent. Mac OS and iOS have about 83 different voices. Most languages are supported, including Arabic.
Support is good. There are about 20 voices. Note that the names of the voices are not the same as in Safari, so different voice names are needed. No Arabic support.
Not supported, but it is under consideration.
// Speak Example
Speak("Hello World!");
// Set volume to quiet:
NSB.speech.volume = .2;
Speak("Hello World");
NSB.speech.volume = 1;
// Read in German:
NSB.speech.lang = "de-DE";
Speak(Button3.text, "Google Deutsch");
NSB.speech.lang = navigator.language;
// Use a different voice:
var voice;
if (InStr(navigator.vendor, "Apple")) {
voice = "Alex";
}
if (InStr(navigator.vendor, "Google")) {
voice = "Google UK English Male";
}
Speak("Hello World", voice);
Rem Speak Example
Speak("Hello World!")
' Set volume to quiet:
NSB.speech.volume = .2
Speak("Hello World")
NSB.speech.volume = 1
' Read in German:
NSB.speech.lang = "de-DE"
Speak(Button3.text, "Google Deutsch")
NSB.speech.lang = navigator.language
' Use a different voice:
Dim voice
If InStr(navigator.vendor,"Apple") Then voice = "Alex"
If InStr(navigator.vendor,"Google") Then voice = "Google UK English Male"
Speak("Hello World", voice)
(no output - plays through device speaker)