PowerShell/Docs/speak-test.md
2023-09-20 17:05:11 +02:00

87 lines
2.1 KiB
Markdown

*speak-test.ps1*
================
speak-test.ps1
Parameters
----------
```powershell
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Script Content
--------------
```powershell
<#
.SYNOPSIS
Performs a text-to-speech test
.DESCRIPTION
This PowerShell script performs a text-to-speech (TTS) test.
.EXAMPLE
PS> ./speak-test.ps1
📣 Let's begin with the default speed rate of 0 at the default volume of 100%.
...
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
function Speak([string]$Text) {
Write-Output "📣 $Text"
[void]$Voice.speak("$Text")
}
try {
$Voice = New-Object -ComObject SAPI.SPVoice
$DefaultVolume = $Voice.volume
$DefaultRate = $Voice.rate
Speak("Let's begin with the default speed rate of $DefaultRate at the default volume of $($DefaultVolume)%.")
$Voice.rate = -10
Speak("I'm speaking very, very slow at speed rate -10.")
$Voice.rate = -5
Speak("I'm speaking very slow at speed rate -5.")
$Voice.rate = -3
Speak("I'm speaking slow at rate -3.")
$Voice.rate = 0
Speak("I'm speaking quite normal at speed rate 0.")
$Voice.rate = 2
Speak("I'm speaking fast at speed rate 2.")
$Voice.rate = 5
Speak("I'm speaking very fast at speed rate 5.")
$Voice.rate = 10
Speak("I'm speaking very, very fast at speed rate 10.")
$Voice.rate = $DefaultRate
$Voice.volume = 100
Speak("Let's try 100% volume.")
$Voice.volume = 75
Speak("Let's try 75% volume.")
$Voice.volume = 50
Speak("Let's try 50% volume.")
$Voice.volume = 25
Speak("Let's try 25% volume.")
$Voice.volume = $DefaultVolume
$Voices = $Voice.GetVoices()
foreach ($OtherVoice in $Voices) {
$Voice.Voice = $OtherVoice
$Description = $OtherVoice.GetDescription()
Speak("Hi, I'm the voice called $Description.")
}
Speak("Thanks for your attention.")
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of speak-test.ps1 as of 09/20/2023 17:04:44)*