PowerShell/Docs/speak-test.md
2023-07-29 10:04:38 +02:00

84 lines
2.0 KiB
Markdown

PS> *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
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
function Speak { param([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")
}
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 07/29/2023 10:04:10)*