PowerShell/docs/speak-test.md

Script: *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 05/19/2024 10:25:26)*