Merge pull request #6092 from eric-urban/eur/ai-speech-translation-qs

Get started with speech translation using TypeScript

Author: v-dirichards

articles/ai-services/speech-service/get-started-speech-translation.md

@@ -7,9 +7,9 @@ manager: nitinme
 ms.service: azure-ai-speech
 ms.custom: devx-track-extended-java, devx-track-go, devx-track-js, devx-track-python
 ms.topic: quickstart
-ms.date: 3/10/2025
+ms.date: 7/17/2025
 ms.author: eur
-zone_pivot_groups: programming-languages-speech-services
+zone_pivot_groups: programming-languages-speech-translation
 keywords: speech translation
 ---
 
@@ -47,12 +47,12 @@ keywords: speech translation
 [!INCLUDE [Python include](./includes/quickstarts/speech-translation-basics/python.md)]
 ::: zone-end
 
-::: zone pivot="programming-language-rest"
-[!INCLUDE [REST include](includes/quickstarts/speech-translation-basics/rest.md)]
+::: zone pivot="programming-language-typescript"
+[!INCLUDE [TypeScript include](includes/quickstarts/speech-translation-basics/typescript.md)]
 ::: zone-end
 
-::: zone pivot="programming-language-cli"
-[!INCLUDE [CLI include](includes/quickstarts/speech-translation-basics/cli.md)]
+::: zone pivot="programming-language-rest"
+[!INCLUDE [REST include](includes/quickstarts/speech-translation-basics/rest.md)]
 ::: zone-end
 
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/cli.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/cpp.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/csharp.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/go.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/intro.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/java.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 
@@ -14,55 +14,60 @@ ms.author: eur
 
 [!INCLUDE [Prerequisites](../../common/azure-prerequisites.md)]
 
-## Set up the environment
+## Set up
 
-Before you can do anything, you need to install the Speech SDK for JavaScript. If you just want the package name to install, run `npm install microsoft-cognitiveservices-speech-sdk`. For guided installation instructions, see the [SDK installation guide](../../../quickstarts/setup-platform.md?pivots=programming-language-javascript).
+1. Create a new folder `translation-quickstart` and go to the quickstart folder with the following command:
 
-### Set environment variables
-
-[!INCLUDE [Environment variables](../../common/environment-variables.md)]
+    ```shell
+    mkdir translation-quickstart && cd translation-quickstart
+    ```
+    
+1. Create the `package.json` with the following command:
 
-## Translate speech from a file 
+    ```shell
+    npm init -y
+    ```
 
-Follow these steps to create a Node.js console application for speech recognition.
+1. Install the Speech SDK for JavaScript with:
 
-1. Open a command prompt where you want the new project, and create a new file named `SpeechTranslation.js`.
-1. Install the Speech SDK for JavaScript:
     ```console
     npm install microsoft-cognitiveservices-speech-sdk
     ```
-1. Copy the following code into `SpeechTranslation.js`:
 
-    ```javascript
-    const fs = require("fs");
-    const sdk = require("microsoft-cognitiveservices-speech-sdk");
+### Retrieve resource information
 
+[!INCLUDE [Environment variables](../../common/environment-variables.md)]
+
+## Translate speech from a file 
+
+To translate speech from a file:
+
+1. Create a new file named *translation.js* with the following content:
+
+    ```javascript
+    import { readFileSync } from "fs";
+    import { SpeechTranslationConfig, AudioConfig, TranslationRecognizer, ResultReason, CancellationDetails, CancellationReason } from "microsoft-cognitiveservices-speech-sdk";
     // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechTranslationConfig = sdk.SpeechTranslationConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
+    const speechTranslationConfig = SpeechTranslationConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
     speechTranslationConfig.speechRecognitionLanguage = "en-US";
-    
-    var language = "it";
+    const language = "it";
     speechTranslationConfig.addTargetLanguage(language);
-    
     function fromFile() {
-        let audioConfig = sdk.AudioConfig.fromWavFileInput(fs.readFileSync("YourAudioFile.wav"));
-        let translationRecognizer = new sdk.TranslationRecognizer(speechTranslationConfig, audioConfig);
-    
-        translationRecognizer.recognizeOnceAsync(result => {
+        const audioConfig = AudioConfig.fromWavFileInput(readFileSync("YourAudioFile.wav"));
+        const translationRecognizer = new TranslationRecognizer(speechTranslationConfig, audioConfig);
+        translationRecognizer.recognizeOnceAsync((result) => {
             switch (result.reason) {
-                case sdk.ResultReason.TranslatedSpeech:
+                case ResultReason.TranslatedSpeech:
                     console.log(`RECOGNIZED: Text=${result.text}`);
                     console.log("Translated into [" + language + "]: " + result.translations.get(language));
-    
                     break;
-                case sdk.ResultReason.NoMatch:
+                case ResultReason.NoMatch:
                     console.log("NOMATCH: Speech could not be recognized.");
                     break;
-                case sdk.ResultReason.Canceled:
-                    const cancellation = sdk.CancellationDetails.fromResult(result);
+                case ResultReason.Canceled:
+                    const cancellation = CancellationDetails.fromResult(result);
                     console.log(`CANCELED: Reason=${cancellation.reason}`);
-    
-                    if (cancellation.reason == sdk.CancellationReason.Error) {
+                    if (cancellation.reason === CancellationReason.Error) {
                         console.log(`CANCELED: ErrorCode=${cancellation.ErrorCode}`);
                         console.log(`CANCELED: ErrorDetails=${cancellation.errorDetails}`);
                         console.log("CANCELED: Did you set the speech resource key and region values?");
@@ -75,15 +80,19 @@ Follow these steps to create a Node.js console application for speech recognitio
     fromFile();
     ```
 
-1. In `SpeechTranslation.js`, replace `YourAudioFile.wav` with your own WAV file. This example only recognizes speech from a WAV file. For information about other audio formats, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md). This example supports up to 30 seconds audio.
-1. To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=stt#supported-languages). Specify the full locale with a dash (`-`) separator. For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md).
-1. To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
+    - In `translation.js`, replace `YourAudioFile.wav` with your own WAV file. This example only recognizes speech from a WAV file. For information about other audio formats, see [How to use compressed input audio](~/articles/ai-services/speech-service/how-to-use-codec-compressed-audio-input-streams.md). This example supports up to 30 seconds audio.
 
-Run your new console application to start speech recognition from a file:
+    - To change the speech recognition language, replace `en-US` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=stt#supported-languages). Specify the full locale with a dash (`-`) separator. For example, `es-ES` for Spanish (Spain). The default language is `en-US` if you don't specify a language. For details about how to identify one of multiple languages that might be spoken, see [language identification](~/articles/ai-services/speech-service/language-identification.md).
 
-```console
-node.exe SpeechTranslation.js
-```
+    - To change the translation target language, replace `it` with another [supported language](~/articles/ai-services/speech-service/language-support.md?tabs=speech-translation#supported-languages). With few exceptions you only specify the language code that precedes the locale dash (`-`) separator. For example, use `es` for Spanish (Spain) instead of `es-ES`. The default language is `en` if you don't specify a language.
+
+1. Run your new console application to start speech recognition from a file:
+
+    ```console
+    node translation.js
+    ```
+
+## Output 
 
 The speech from the audio file should be output as translated text in the target language:
 
@@ -93,6 +102,7 @@ Translated into [it]: Sono entusiasta di provare la traduzione vocale.
 ```
 
 ## Remarks
+
 Now that you've completed the quickstart, here are some additional considerations:
 
 This example uses the `recognizeOnceAsync` operation to transcribe utterances of up to 30 seconds, or until silence is detected. For information about continuous recognition for longer audio, including multi-lingual conversations, see [How to translate speech](~/articles/ai-services/speech-service/how-to-translate-speech.md).

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/javascript.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---
 

articles/ai-services/speech-service/includes/quickstarts/speech-translation-basics/objectivec.md

@@ -2,7 +2,7 @@
 author: eric-urban
 ms.service: azure-ai-speech
 ms.topic: include
-ms.date: 06/08/2022
+ms.date: 7/17/2025
 ms.author: eur
 ---