Merge pull request #6926 from xitzhang/xitzhang/1.46.0

Release: Speech SDK 1.46.0

Author: prmerger-automator[bot]

articles/ai-services/speech-service/includes/common/environment-variables-clu.md

@@ -15,6 +15,7 @@ To set the environment variables, open a console window, and follow the instruct
 - To set the `LANGUAGE_ENDPOINT` environment variable, replace `your-language-endpoint` with one of the regions for your resource.
 - To set the `SPEECH_KEY` environment variable, replace `your-speech-key` with one of the keys for your resource.
 - To set the `SPEECH_REGION` environment variable, replace `your-speech-region` with one of the regions for your resource.
+- To set the `ENDPOINT` environment variable, replace `your-speech-endpoint` with the actual endpoint of your Speech resource.
 
 #### [Windows](#tab/windows)
 
@@ -23,6 +24,7 @@ setx LANGUAGE_KEY your-language-key
 setx LANGUAGE_ENDPOINT your-language-endpoint
 setx SPEECH_KEY your-speech-key
 setx SPEECH_REGION your-speech-region
+setx ENDPOINT your-speech-endpoint
 ```
 
 > [!NOTE]
@@ -37,6 +39,7 @@ export LANGUAGE_KEY=your-language-key
 export LANGUAGE_ENDPOINT=your-language-endpoint
 export SPEECH_KEY=your-speech-key
 export SPEECH_REGION=your-speech-region
+export ENDPOINT=your-speech-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bashrc` from your console window to make the changes effective.
@@ -52,6 +55,7 @@ export LANGUAGE_KEY=your-language-key
 export LANGUAGE_ENDPOINT=your-language-endpoint
 export SPEECH_KEY=your-speech-key
 export SPEECH_REGION=your-speech-region
+export ENDPOINT=your-speech-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bash_profile` from your console window to make the changes effective.

articles/ai-services/speech-service/includes/common/environment-variables.md

@@ -14,12 +14,14 @@ To set the environment variables for your Speech resource key and region, open a
 
 - To set the `SPEECH_KEY` environment variable, replace *your-key* with one of the keys for your resource.
 - To set the `SPEECH_REGION` environment variable, replace *your-region* with one of the regions for your resource.
+- To set the `ENDPOINT` environment variable, replace `your-endpoint` with the actual endpoint of your Speech resource.
 
 #### [Windows](#tab/windows)
 
 ```console
 setx SPEECH_KEY your-key
 setx SPEECH_REGION your-region
+setx ENDPOINT your-endpoint
 ```
 
 > [!NOTE]
@@ -36,6 +38,7 @@ Edit your *.bashrc* file, and add the environment variables:
 ```bash
 export SPEECH_KEY=your-key
 export SPEECH_REGION=your-region
+export ENDPOINT=your-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bashrc` from your console window to make the changes effective.
@@ -49,6 +52,7 @@ Edit your *.bash_profile* file, and add the environment variables:
 ```bash
 export SPEECH_KEY=your-key
 export SPEECH_REGION=your-region
+export ENDPOINT=your-endpoint
 ```
 
 After you add the environment variables, run `source ~/.bash_profile` from your console window to make the changes effective.
@@ -62,7 +66,7 @@ For iOS and macOS development, you set the environment variables in Xcode. For e
 1. Under **Environment Variables** select the plus (+) sign to add a new environment variable.
 1. Enter `SPEECH_KEY` for the **Name** and enter your Speech resource key for the **Value**.
 
-To set the environment variable for your Speech resource region, follow the same steps. Set `SPEECH_REGION` to the region of your resource. For example, `westus`.
+To set the environment variable for your Speech resource region, follow the same steps. Set `SPEECH_REGION` to the region of your resource. For example, `westus`. Set `ENDPOINT` to the endpoint of your resource
 
 For more configuration options, see [the Xcode documentation](https://help.apple.com/xcode/#/dev745c5c974).
 

articles/ai-services/speech-service/includes/how-to/recognize-speech/java.md

@@ -26,7 +26,7 @@ import java.util.concurrent.Future;
 
 public class Program {
     public static void main(String[] args) throws InterruptedException, ExecutionException {
-        SpeechConfig speechConfig = SpeechConfig.fromSubscription("<paste-your-speech-key>", "<paste-your-region>");
+        SpeechConfig speechConfig = SpeechConfig.fromEndpoint("<paste-your-speech-endpoint>", "<paste-your-speech-key>");
     }
 }
 ```
@@ -52,7 +52,7 @@ import java.util.concurrent.Future;
 
 public class Program {
     public static void main(String[] args) throws InterruptedException, ExecutionException {
-        SpeechConfig speechConfig = SpeechConfig.fromSubscription("<paste-your-speech-key>", "<paste-your-region>");
+        SpeechConfig speechConfig = SpeechConfig.fromEndpoint("<paste-your-speech-endpoint>", "<paste-your-speech-key>");
         fromMic(speechConfig);
     }
 
@@ -82,7 +82,7 @@ import java.util.concurrent.Future;
 
 public class Program {
     public static void main(String[] args) throws InterruptedException, ExecutionException {
-        SpeechConfig speechConfig = SpeechConfig.fromSubscription("<paste-your-speech-key>", "<paste-your-region>");
+        SpeechConfig speechConfig = SpeechConfig.fromEndpoint("<paste-your-speech-endpoint>", "<paste-your-speech-key>");
         fromFile(speechConfig);
     }
 

articles/ai-services/speech-service/includes/how-to/recognize-speech/javascript.md

@@ -15,11 +15,11 @@ ms.custom: devx-track-js
 
 To call the Speech service by using the Speech SDK, you need to create a [`SpeechConfig`](/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig) instance. This class includes information about your Speech resource, like your key and associated region, endpoint, host, or authorization token.
 
-1. Create an AI Foundry resource for Speech in the [Azure portal](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry). Get the Speech resource key and region.
-1. Create a `SpeechConfig` instance by using the following code. Replace `YourSpeechKey` and `YourSpeechRegion` with your Speech resource key and region.
+1. Create an AI Foundry resource for Speech in the [Azure portal](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry). Get the Speech resource key and endpoint.
+1. Create a `SpeechConfig` instance by using the following code. Replace `YourSpeechEndpoint` and `YourSpeechKey` with your Speech resource endpoint and key.
 
 ```javascript
-const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
+const speechConfig = sdk.SpeechConfig.fromEndpoint(new URL("YourSpeechEndpoint"), "YourSpeechKey");
 ```
 
 You can initialize `SpeechConfig` in a few other ways:
@@ -45,7 +45,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("YourSpeechKey", "YourSpeechRegion");
+const speechConfig = sdk.SpeechConfig.fromEndpoint("YourSpeechEndpoint", "YourSpeechKey");
 
 function fromFile() {
     let audioConfig = sdk.AudioConfig.fromWavFileInput(fs.readFileSync("YourAudioFile.wav"));
@@ -70,7 +70,7 @@ For many use cases, your audio data likely comes from Azure Blob Storage. Or it'
 ```javascript
 const fs = require('fs');
 const sdk = require("microsoft-cognitiveservices-speech-sdk");
-const speechConfig = sdk.SpeechConfig.fromSubscription("YourSpeechKey", "YourSpeechRegion");
+const speechConfig = sdk.SpeechConfig.fromEndpoint("YourSpeechEndpoint", "YourSpeechKey");
 
 function fromStream() {
     let pushStream = sdk.AudioInputStream.createPushStream();
@@ -116,7 +116,7 @@ switch (result.reason) {
         if (cancellation.reason == sdk.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?");
+            console.log("CANCELED: Did you set the speech resource key and endpoint values?");
         }
         break;
     }
@@ -162,7 +162,7 @@ speechRecognizer.canceled = (s, e) => {
     if (e.reason == sdk.CancellationReason.Error) {
         console.log(`"CANCELED: ErrorCode=${e.errorCode}`);
         console.log(`"CANCELED: ErrorDetails=${e.errorDetails}`);
-        console.log("CANCELED: Did you set the speech resource key and region values?");
+        console.log("CANCELED: Did you set the speech resource key and endpoint values?");
     }
 
     speechRecognizer.stopContinuousRecognitionAsync();

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

@@ -49,8 +49,8 @@ To transcribe speech from a file:
     ```javascript
     import { readFileSync, createReadStream } from "fs";
     import { SpeechConfig, AudioConfig, ConversationTranscriber, AudioInputStream } from "microsoft-cognitiveservices-speech-sdk";
-    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechConfig = SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechConfig = SpeechConfig.fromEndpoint(new URL(process.env.ENDPOINT), process.env.SPEECH_KEY);
     function fromFile() {
         const filename = "katiesteve.wav";
         const audioConfig = AudioConfig.fromWavFileInput(readFileSync(filename));

articles/ai-services/speech-service/includes/quickstarts/speech-to-text-basics/typescript.md

@@ -69,8 +69,8 @@ To transcribe speech from a file:
         SpeechRecognitionResult 
     } from "microsoft-cognitiveservices-speech-sdk";
     
-    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechConfig: SpeechConfig = SpeechConfig.fromSubscription(process.env.SPEECH_KEY!, process.env.SPEECH_REGION!);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechConfig: SpeechConfig = SpeechConfig.fromEndpoint(new URL(process.env.ENDPOINT!), process.env.SPEECH_KEY!);
     speechConfig.speechRecognitionLanguage = "en-US";
     
     function fromFile(): void {

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

@@ -47,8 +47,8 @@ To translate speech from a file:
     ```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 = SpeechTranslationConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechTranslationConfig = SpeechTranslationConfig.fromEndpoint(new URL(process.env.ENDPOINT), process.env.SPEECH_KEY);
     speechTranslationConfig.speechRecognitionLanguage = "en-US";
     const language = "it";
     speechTranslationConfig.addTargetLanguage(language);

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

@@ -67,8 +67,8 @@ To translate speech from a file:
         TranslationRecognitionResult 
     } from "microsoft-cognitiveservices-speech-sdk";
     
-    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechTranslationConfig: SpeechTranslationConfig = SpeechTranslationConfig.fromSubscription(process.env.SPEECH_KEY!, process.env.SPEECH_REGION!);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechTranslationConfig: SpeechTranslationConfig = SpeechTranslationConfig.fromEndpoint(new URL(process.env.ENDPOINT!), process.env.SPEECH_KEY!);
     speechTranslationConfig.speechRecognitionLanguage = "en-US";
     
     const language = "it";

articles/ai-services/speech-service/includes/quickstarts/stt-diarization/javascript.md

@@ -48,8 +48,8 @@ Follow these steps to create a new console application for conversation transcri
     const fs = require("fs");
     const sdk = require("microsoft-cognitiveservices-speech-sdk");
     
-    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechConfig = sdk.SpeechConfig.fromSubscription(process.env.SPEECH_KEY, process.env.SPEECH_REGION);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechConfig = sdk.SpeechConfig.fromEndpoint(new URL(process.env.ENDPOINT), process.env.SPEECH_KEY);
     
     function fromFile() {
         const filename = "katiesteve.wav";

articles/ai-services/speech-service/includes/quickstarts/stt-diarization/typescript.md

@@ -64,8 +64,8 @@ Follow these steps to create a new console application for conversation transcri
         AudioInputStream 
     } from "microsoft-cognitiveservices-speech-sdk";
     
-    // This example requires environment variables named "SPEECH_KEY" and "SPEECH_REGION"
-    const speechConfig: SpeechConfig = SpeechConfig.fromSubscription(process.env.SPEECH_KEY!, process.env.SPEECH_REGION!);
+    // This example requires environment variables named "ENDPOINT" and "SPEECH_KEY"
+    const speechConfig: SpeechConfig = SpeechConfig.fromEndpoint(new URL(process.env.ENDPOINT!), process.env.SPEECH_KEY!);
     
     function fromFile(): void {
         const filename = "katiesteve.wav";