Minor fixes

Author: IEvangelist

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

@@ -67,7 +67,7 @@ There are a few ways that you can initialize a [`SpeechConfig`](https://docs.mic
 Let's take a look at how a [`SpeechConfig`](https://docs.microsoft.com/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig?view=azure-node-latest) is created using a key and region. See the [region support](https://docs.microsoft.com/azure/cognitive-services/speech-service/regions#speech-sdk) page to find your region identifier.
 
 ```javascript
-const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
+const speechConfig = SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
 ```
 
 ## Initialize a recognizer
@@ -128,19 +128,19 @@ You'll need to write some code to handle the result. This sample evaluates the [
 ```javascript
 switch (result.reason) {
     case sdk.ResultReason.RecognizedSpeech:
-        console.log(`RECOGNIZED: Text=${result.Text}`);
+        console.log(`RECOGNIZED: Text=${result.text}`);
         console.log("    Intent not recognized.");
         break;
     case sdk.ResultReason.NoMatch:
         console.log("NOMATCH: Speech could not be recognized.");
         break;
     case sdk.ResultReason.Canceled:
         const cancellation = sdk.CancellationDetails.fromResult(result);
-        console.log(`CANCELED: Reason=${cancellation.Reason}`);
+        console.log(`CANCELED: Reason=${cancellation.reason}`);
 
-        if (cancellation.Reason == sdk.CancellationReason.Error) {
+        if (cancellation.reason == sdk.CancellationReason.Error) {
             console.log(`CANCELED: ErrorCode=${cancellation.ErrorCode}`);
-            console.log(`CANCELED: ErrorDetails=${cancellation.ErrorDetails}`);
+            console.log(`CANCELED: ErrorDetails=${cancellation.errorDetails}`);
             console.log("CANCELED: Did you update the subscription info?");
         }
         break;
@@ -167,23 +167,23 @@ We'll subscribe to the events sent from the [`SpeechRecognizer`](https://docs.mi
 
 ```javascript
 recognizer.Recognizing = (s, e) => {
-    console.log(`RECOGNIZING: Text=${e.Result.Text}`);
+    console.log(`RECOGNIZING: Text=${e.Result.text}`);
 };
 
 recognizer.recognized = (s, e) => {
-    if (e.Result.Reason == sdk.ResultReason.RecognizedSpeech) {
+    if (e.Result.reason == sdk.ResultReason.RecognizedSpeech) {
         console.log(`RECOGNIZED: Text=${e.Result.Text}`);
     }
-    else if (e.Result.Reason == sdk.ResultReason.NoMatch) {
+    else if (e.Result.reason == sdk.ResultReason.NoMatch) {
         console.log("NOMATCH: Speech could not be recognized.");
     }
 };
 
 recognizer.Canceled = (s, e) => {
-    console.log(`CANCELED: Reason=${e.Reason}`);
+    console.log(`CANCELED: Reason=${e.reason}`);
 
-    if (e.Reason == sdk.CancellationReason.Error) {
-        console.log(`"CANCELED: ErrorCode=${e.ErrorCode}`);
+    if (e.reason == sdk.CancellationReason.Error) {
+        console.log(`"CANCELED: ErrorCode=${e.errorCode}`);
         console.log(`"CANCELED: ErrorDetails=${e.ErrorDetails}`);
         console.log("CANCELED: Did you update the subscription info?");
     }

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

@@ -22,7 +22,11 @@ Additionally, depending on the target environment use one of the following:
 # [import](#tab/import)
 
 ```javascript
-import * as sdk from "microsoft-cognitiveservices-speech-sdk";
+import {
+    AudioConfig,
+    SpeechConfig,
+    SpeechSynthesizer
+} from "microsoft-cognitiveservices-speech-sdk";
 ```
 
 For more information on `import`, see <a href="https://javascript.info/import-export" target="_blank">export and import <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
@@ -35,6 +39,18 @@ const sdk = require("microsoft-cognitiveservices-speech-sdk");
 
 For more information on `require`, see <a href="https://nodejs.org/en/knowledge/getting-started/what-is-require/" target="_blank">what is require? <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
 
+
+# [script](#tab/script)
+
+Download and extract the <a href="https://aka.ms/csspeech/jsbrowserpackage" target="_blank">JavaScript Speech SDK <span class="docon docon-navigate-external x-hidden-focus"></span></a> *microsoft.cognitiveservices.speech.sdk.bundle.js* file, and place it in a folder accessible to your HTML file.
+
+```html
+<script src="microsoft.cognitiveservices.speech.sdk.bundle.js"></script>;
+```
+
+> [!TIP]
+> If you're targeting a web browser, and using the `<script>` tag; the `sdk` prefix is not needed. The `sdk` prefix is an alias we use to name our `import` or `require` module.
+
 ---
 
 ## Create a speech configuration
@@ -55,21 +71,22 @@ In this example, you create a [`SpeechConfig`](https://docs.microsoft.com/javasc
 
 ```javascript
 function synthesizeSpeech() {
-    const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
-    const synthesizer = new sdk.SpeechSynthesizer(speechConfig);
+    const speechConfig = SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
+    const synthesizer = new SpeechSynthesizer(speechConfig);
 }
 ```
 
-## Synthesize speech to a file
+## Synthesize speech from a file
 
 Next, you create a [`SpeechSynthesizer`](https://docs.microsoft.com/javascript/api/microsoft-cognitiveservices-speech-sdk/speechsynthesizer?view=azure-node-latest) object, which executes text-to-speech conversions and outputs to speakers, files, or other output streams. The [`SpeechSynthesizer`](https://docs.microsoft.com/javascript/api/microsoft-cognitiveservices-speech-sdk/speechsynthesizer?view=azure-node-latest) accepts as params the [`SpeechConfig`](https://docs.microsoft.com/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig?view=azure-node-latest) object created in the previous step, and an [`AudioConfig`](https://docs.microsoft.com/javascript/api/microsoft-cognitiveservices-speech-sdk/audioconfig?view=azure-node-latest) object that specifies how output results should be handled.
 
-To start, create an `AudioConfig` to automatically write the output to a `.wav` file using the `fromWavFileOutput()` static function.
+To start, create an `AudioConfig` to automatically write the output to a `.wav` file using the `fromAudioFileOutput()` static function.
 
 ```javascript
 function synthesizeSpeech() {
-    const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
-    const audioConfig = sdk.AudioConfig.fromWavFileOutput("path/to/write/file.wav");
+    const speechConfig = SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
+    const audioConfig = AudioConfig.fromAudioFileOutput("path/to/file.wav");
+    const synthesizer = new SpeechSynthesizer(speechConfig, audioConfig);
 }
 ```
 
@@ -78,10 +95,10 @@ Next, instantiate a `SpeechSynthesizer` passing your `speechConfig` object and t
 ```javascript
 function synthesizeSpeech() {
     const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
-    AudioConfig audioConfig = AudioConfig.fromWavFileOutput("path/to/write/file.wav");
+    const audioConfig = AudioConfig.fromAudioFileOutput("path/to/file.wav");
 
-    SpeechSynthesizer synthesizer = new SpeechSynthesizer(speechConfig, audioConfig);
-    synthesizer.SpeakText("A simple test to write to a file.");
+    const synthesizer = new SpeechSynthesizer(speechConfig, audioConfig);
+    synthesizer.speakTextAsync("A simple test to write to a file.");
 }
 ```
 
@@ -94,10 +111,10 @@ In some cases, you may want to directly output synthesized speech directly to a
 ```javascript
 function synthesizeSpeech() {
     const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
-    AudioConfig audioConfig = AudioConfig.fromDefaultSpeakerOutput();
+    const audioConfig = AudioConfig.fromDefaultSpeakerOutput();
 
-    SpeechSynthesizer synthesizer = new SpeechSynthesizer(speechConfig, audioConfig);
-    synthesizer.SpeakText("Synthesizing directly to speaker output.");
+    const synthesizer = new SpeechSynthesizer(speechConfig, audioConfig);
+    synthesizer.speakTextAsync("Synthesizing directly to speaker output.");
 }
 ```
 
@@ -126,6 +143,7 @@ function synthesizeSpeech() {
         result => {
             // Interact with the audio ArrayBuffer data
             const audioData = result.audioData;
+            console.log(`Audio data byte size: ${audioData.byteLength}.`)
         },
         error => console.log(error));
 }
@@ -145,14 +163,14 @@ To change the audio format, you use the `setSpeechSynthesisOutputFormat()` funct
 
 There are various options for different file types depending on your requirements. Note that by definition, raw formats like `Raw24Khz16BitMonoPcm` do not include audio headers. Use raw formats only when you know your downstream implementation can decode a raw bitstream, or if you plan on manually building headers based on bit-depth, sample-rate, number of channels, etc.
 
-In this example, you specify a high-fidelity RIFF format `Riff24Khz16BitMonoPcm` by setting the `SpeechSynthesisOutputFormat` on the `SpeechConfig` object. Similar to the example in the previous section, get the audio `ArrayBuffer` data and interact with it.
+In this example, you specify a high-fidelity RIFF format `Riff24Khz16BitMonoPcm` by setting the `speechSynthesisOutputFormat` on the `SpeechConfig` object. Similar to the example in the previous section, get the audio `ArrayBuffer` data and interact with it.
 
 ```javascript
 function synthesizeSpeech() {
-    const speechConfig = sdk.SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
+    const speechConfig = SpeechConfig.fromSubscription("YourSubscriptionKey", "YourServiceRegion");
 
     // Set the output format
-    speechConfig.setSpeechSynthesisOutputFormat(sdk.SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm);
+    speechConfig.speechSynthesisOutputFormat = SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm;
 
     const synthesizer = new sdk.SpeechSynthesizer(speechConfig, null);
     synthesizer.speakTextAsync(
@@ -184,30 +202,13 @@ First, create a new XML file for the SSML config in your root project directory,
 
 Next, you need to change the speech synthesis request to reference your XML file. The request is mostly the same, but instead of using the `speakTextAsync()` function, you use `speakSsmlAsync()`. This function expects an XML string, so first you create a function to load an XML file and return it as a string.
 
-# [import](#tab/import)
-
 ```javascript
-import { readFileSync } from "fs";
-
 function xmlToString(filePath) {
     const xml = readFileSync(filePath, "utf8");
     return xml;
 }
 ```
 
-# [require](#tab/require)
-
-```javascript
-const fs = require("fs");
-
-function xmlToString(filePath) {
-    const xml = fs.readFileSync(filePath, "utf8");
-    return xml;
-}
-```
-
----
-
 From here, the result object is exactly the same as previous examples.
 
 ```javascript