Merge pull request #212175 from eric-urban/eur/tts-how-to

TTS how to

Author: jborsecnik

articles/cognitive-services/Speech-Service/how-to-migrate-to-custom-neural-voice.md

@@ -74,7 +74,6 @@ If you've created a custom voice font, use the endpoint that you've created. You
 | Brazil South | `https://brazilsouth.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |
 | Canada Central | `https://canadacentral.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |
 | Central US | `https://centralus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |
-| China East 2 | `https://chinaeast2.voice.speech.azure.cn/cognitiveservices/v1?deploymentId={deploymentId}` |
 | East Asia | `https://eastasia.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |
 | East US | `https://eastus.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |
 | East US 2 | `https://eastus2.voice.speech.microsoft.com/cognitiveservices/v1?deploymentId={deploymentId}` |

articles/cognitive-services/Speech-Service/how-to-speech-synthesis.md

@@ -58,28 +58,6 @@ keywords: text to speech
 [!INCLUDE [CLI include](includes/how-to/speech-synthesis/cli.md)]
 ::: zone-end
 
-## Get facial pose events
-
-Speech can be a good way to drive the animation of facial expressions.
-[Visemes](how-to-speech-synthesis-viseme.md) are often used to represent the key poses in observed speech. Key poses include the position of the lips, jaw, and tongue in producing a particular phoneme.
-
-You can subscribe to viseme events in the Speech SDK. Then, you can apply viseme events to animate the face of a character as speech audio plays.
-Learn [how to get viseme events](how-to-speech-synthesis-viseme.md#get-viseme-events-with-the-speech-sdk).
-
-## Get position information
-
-Your project might need to know when a word is spoken by text-to-speech so that it can take specific action based on that timing. For example, if you want to highlight words as they're spoken, you need to know what to highlight, when to highlight it, and for how long to highlight it.
-
-You can accomplish this by using the `WordBoundary` event within `SpeechSynthesizer`. This event is raised at the beginning of each new spoken word. It provides a time offset within the spoken stream and a text offset within the input prompt:
-
-* `AudioOffset` reports the output audio's elapsed time between the beginning of synthesis and the start of the next word. This is measured in hundred-nanosecond units (HNS), with 10,000 HNS equivalent to 1 millisecond.
-* `WordOffset` reports the character position in the input string (original text or [SSML](speech-synthesis-markup.md)) immediately before the word that's about to be spoken.
-
-> [!NOTE]
-> `WordBoundary` events are raised as the output audio data becomes available, which will be faster than playback to an output device. The caller must appropriately synchronize streaming and real time.
-
-You can find examples of using `WordBoundary` in the [text-to-speech samples](https://aka.ms/csspeech/samples) on GitHub.
-
 ## Next steps
 
 * [Get started with Custom Neural Voice](how-to-custom-voice.md)

articles/cognitive-services/Speech-Service/includes/cognitive-services-speech-service-endpoints-text-to-speech.md

@@ -16,8 +16,6 @@ Use this table to determine *availability of neural voices* by region or endpoin
 | Brazil South | `https://brazilsouth.tts.speech.microsoft.com/cognitiveservices/v1` |
 | Canada Central | `https://canadacentral.tts.speech.microsoft.com/cognitiveservices/v1` |
 | Central US | `https://centralus.tts.speech.microsoft.com/cognitiveservices/v1` |
-| China East 2 | `https://chinaeast2.tts.speech.azure.cn/cognitiveservices/v1` |
-| China North 2 | `https://chinanorth2.tts.speech.azure.cn/cognitiveservices/v1` |
 | East Asia | `https://eastasia.tts.speech.microsoft.com/cognitiveservices/v1` |
 | East US | `https://eastus.tts.speech.microsoft.com/cognitiveservices/v1` |
 | East US 2 | `https://eastus2.tts.speech.microsoft.com/cognitiveservices/v1` |

articles/cognitive-services/Speech-Service/includes/cognitive-services-speech-service-rest-auth.md

@@ -6,8 +6,6 @@ ms.date: 07/01/2021
 ms.author: erhopf
 ---
 
-## Authentication
-
 Each request requires an authorization header. This table illustrates which headers are supported for each feature:
 
 | Supported authorization header | Speech-to-text | Text-to-speech |

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cpp.md

@@ -20,7 +20,7 @@ Create a `SpeechConfig` instance by using your key and region. Create a Speech r
 using namespace std;
 using namespace Microsoft::CognitiveServices::Speech;
 
-auto config = SpeechConfig::FromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+auto config = SpeechConfig::FromSubscription("YourSpeechKey", "YourSpeechRegion");
 ```
 
 You can initialize `SpeechConfig` in a few other ways:

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/csharp.md

@@ -28,7 +28,7 @@ class Program
 {
     async static Task Main(string[] args)
     {
-        var speechConfig = SpeechConfig.FromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+        var speechConfig = SpeechConfig.FromSubscription("YourSpeechKey", "YourSpeechRegion");
     }
 }
 ```
@@ -67,7 +67,7 @@ class Program
 
     async static Task Main(string[] args)
     {
-        var speechConfig = SpeechConfig.FromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+        var speechConfig = SpeechConfig.FromSubscription("YourSpeechKey", "YourSpeechRegion");
         await FromMic(speechConfig);
     }
 }
@@ -99,7 +99,7 @@ class Program
 
     async static Task Main(string[] args)
     {
-        var speechConfig = SpeechConfig.FromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+        var speechConfig = SpeechConfig.FromSubscription("YourSpeechKey", "YourSpeechRegion");
         await FromFile(speechConfig);
     }
 }
@@ -142,7 +142,7 @@ class Program
 
     async static Task Main(string[] args)
     {
-        var speechConfig = SpeechConfig.FromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+        var speechConfig = SpeechConfig.FromSubscription("YourSpeechKey", "YourSpeechRegion");
         await FromStream(speechConfig);
     }
 }

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/go.md

@@ -53,8 +53,8 @@ func cancelledHandler(event speech.SpeechRecognitionCanceledEventArgs) {
 }
 
 func main() {
-    subscription :=  "<paste-your-speech-key-here>"
-    region := "<paste-your-speech-location/region-here>"
+    subscription :=  "YourSpeechKey"
+    region := "YourSpeechRegion"
 
 	audioConfig, err := audio.NewAudioConfigFromDefaultMicrophoneInput()
 	if err != nil {
@@ -117,8 +117,8 @@ import (
 )
 
 func main() {
-    subscription :=  "<paste-your-speech-key-here>"
-    region := "<paste-your-speech-location/region-here>"
+    subscription :=  "YourSpeechKey"
+    region := "YourSpeechRegion"
     file := "path/to/file.wav"
 
 	audioConfig, err := audio.NewAudioConfigFromWavFileInput(file)

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/javascript.md

@@ -18,7 +18,7 @@ To call the Speech service by using the Speech SDK, you need to create a [`Speec
 Create a `SpeechConfig` instance by using your key and location/region. Create a Speech resource on the [Azure portal](https://portal.azure.com). For more information, see [Create a new Azure Cognitive Services resource](~/articles/cognitive-services/cognitive-services-apis-create-account.md?tabs=speech#create-a-new-azure-cognitive-services-resource).
 
 ```javascript
-const speechConfig = sdk.SpeechConfig.fromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
 ```
 
 You can initialize `SpeechConfig` in a few other ways:
@@ -44,7 +44,7 @@ To recognize speech from an audio file, create an `AudioConfig` instance by usin
 ```javascript
 const fs = require('fs');
 const sdk = require("microsoft-cognitiveservices-speech-sdk");
-const speechConfig = sdk.SpeechConfig.fromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
 
 function fromFile() {
     let audioConfig = sdk.AudioConfig.fromWavFileInput(fs.readFileSync("YourAudioFile.wav"));
@@ -69,7 +69,7 @@ For many use cases, your audio data will likely come from blob storage. Or it wi
 ```javascript
 const fs = require('fs');
 const sdk = require("microsoft-cognitiveservices-speech-sdk");
-const speechConfig = sdk.SpeechConfig.fromSubscription("<paste-your-speech-key-here>", "<paste-your-speech-location/region-here>");
+const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
 
 function fromStream() {
     let pushStream = sdk.AudioInputStream.createPushStream();

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/python.md

@@ -17,7 +17,7 @@ To call the Speech service by using the Speech SDK, you need to create a [`Speec
 Create a `SpeechConfig` instance by using your speech key and location/region. Create a Speech resource on the [Azure portal](https://portal.azure.com). For more information, see [Create a new Azure Cognitive Services resource](~/articles/cognitive-services/cognitive-services-apis-create-account.md?tabs=speech#create-a-new-azure-cognitive-services-resource).
 
 ```Python
-speech_config = speechsdk.SpeechConfig(subscription="<paste-your-speech-key-here>", region="<paste-your-speech-location/region-here>")
+speech_config = speechsdk.SpeechConfig(subscription="YourSpeechKey", region="YourSpeechRegion")
 ```
 
 You can initialize [`SpeechConfig`](/python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.speechconfig) in a few other ways:
@@ -37,7 +37,7 @@ To recognize speech by using your device microphone, create a `SpeechRecognizer`
 import azure.cognitiveservices.speech as speechsdk
 
 def from_mic():
-    speech_config = speechsdk.SpeechConfig(subscription="<paste-your-speech-key-here>", region="<paste-your-speech-location/region-here>")
+    speech_config = speechsdk.SpeechConfig(subscription="YourSpeechKey", region="YourSpeechRegion")
     speech_recognizer = speechsdk.SpeechRecognizer(speech_config=speech_config)
 
     print("Speak into your microphone.")
@@ -57,7 +57,7 @@ If you want to recognize speech from an audio file instead of using a microphone
 import azure.cognitiveservices.speech as speechsdk
 
 def from_file():
-    speech_config = speechsdk.SpeechConfig(subscription="<paste-your-speech-key-here>", region="<paste-your-speech-location/region-here>")
+    speech_config = speechsdk.SpeechConfig(subscription="YourSpeechKey", region="YourSpeechRegion")
     audio_input = speechsdk.AudioConfig(filename="your_file_name.wav")
     speech_recognizer = speechsdk.SpeechRecognizer(speech_config=speech_config, audio_config=audio_input)
 

articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/cli.md

@@ -21,7 +21,7 @@ ms.author: eur
 Now you're ready to run the Speech CLI to synthesize speech from text. From the command line, change to the directory that contains the Speech CLI binary file. Then run the following command:
 
 ```bash
-spx synthesize --text "The speech synthesizer greets you!"
+spx synthesize --text "I'm excited to try text-to-speech"
 ```
 
 The Speech CLI will produce natural language in English through the computer speaker.
@@ -31,7 +31,7 @@ The Speech CLI will produce natural language in English through the computer spe
 Run the following command to change the output from your speaker to a .wav file:
 
 ```bash
-spx synthesize --text "The speech synthesizer greets you!" --audio output greetings.wav
+spx synthesize --text "I'm excited to try text-to-speech" --audio output greetings.wav
 ```
 
-The Speech CLI will produce natural language in English in the *greetings.wav* audio file. On Windows, you can play the audio file by entering `start greetings.wav`.
+The Speech CLI will produce natural language in English in the `greetings.wav` audio file.