Merge pull request #207635 from eric-urban/eur/java-qs

Court72 · web-flow · commit bf5fc272ca79 · 2022-08-11T08:39:07.000-06:00
consistent java setup and get started
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/cpp.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/cpp.md
@@ -42,14 +42,14 @@ Follow these steps to create a new console application and install the Speech SD
     - On a 32-bit Windows installation, set **Active solution platform** to `x86`.
 1. Open **Project** > **Properties** > **Debugging**. Enter your preferred command line arguments at **Command Arguments**. See [usage and arguments](#usage-and-arguments) for the available options. Here is an example:
     ```
-    --key YourSubscriptionKey --region YourServiceRegion --input c:\caption\caption.this.mp4 --format any --output c:\caption\caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
+    --key YourSubscriptionKey --region YourServiceRegion --input caption.this.mp4 --format any --output caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
     ```
     Replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource [region](~/articles/cognitive-services/speech-service/regions.md), such as `westus` or `northeurope`. Make sure that the paths specified by `--input` and `--output` are valid. Otherwise you must change the paths.
 
     > [!IMPORTANT]
     > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). See the Cognitive Services [security](../../../../cognitive-services-security.md) article for more information.
 
-1. [Build and run](/cpp/build/vscpp-step-2-build) the console application. The output file with complete captions is written to `c:\caption\caption.output.txt`. Intermediate results are shown in the console:
+1. [Build and run](/cpp/build/vscpp-step-2-build) the console application. The output file with complete captions is written to `caption.output.txt`. Intermediate results are shown in the console:
     ```console
     00:00:00,180 --> 00:00:01,600
     Welcome to
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/csharp.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/csharp.md
@@ -44,14 +44,14 @@ Follow these steps to create a new console application and install the Speech SD
     ```
 1. Run the application with your preferred command line arguments. See [usage and arguments](#usage-and-arguments) for the available options. Here is an example:
     ```dotnetcli
-    dotnet run --key YourSubscriptionKey --region YourServiceRegion --input c:\caption\caption.this.mp4 --format any --output c:\caption\caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
+    dotnet run --key YourSubscriptionKey --region YourServiceRegion --input caption.this.mp4 --format any --output caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
     ```
     Replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource [region](~/articles/cognitive-services/speech-service/regions.md), such as `westus` or `northeurope`. Make sure that the paths specified by `--input` and `--output` are valid. Otherwise you must change the paths.
 
     > [!IMPORTANT]
     > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). See the Cognitive Services [security](../../../../cognitive-services-security.md) article for more information.
 
-    The output file with complete captions is written to `c:\caption\caption.output.txt`. Intermediate results are shown in the console:
+    The output file with complete captions is written to `caption.output.txt`. Intermediate results are shown in the console:
     ```console
     00:00:00,180 --> 00:00:01,600
     Welcome to
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/java.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/java.md
@@ -78,14 +78,14 @@ Follow these steps to create a new console application and install the Speech SD
     ```
 1. Run the application with your preferred command line arguments. See [usage and arguments](#usage-and-arguments) for the available options. Here is an example:
     ```console
-    java -cp ".;target\dependency\*" Captioning --key YourSubscriptionKey --region YourServiceRegion --input c:\caption\caption.this.mp4 --format any --output c:\caption\caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
+    java -cp ".;target\dependency\*" Captioning --key YourSubscriptionKey --region YourServiceRegion --input caption.this.mp4 --format any --output caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
     ```
     Replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource [region](~/articles/cognitive-services/speech-service/regions.md), such as `westus` or `northeurope`. Make sure that the paths specified by `--input` and `--output` are valid. Otherwise you must change the paths.
 
     > [!IMPORTANT]
     > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). See the Cognitive Services [security](../../../../cognitive-services-security.md) article for more information.
 
-    The output file with complete captions is written to `c:\caption\caption.output.txt`. Intermediate results are shown in the console:
+    The output file with complete captions is written to `caption.output.txt`. Intermediate results are shown in the console:
     ```console
     00:00:00,180 --> 00:00:01,600
     Welcome to
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/javascript.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/javascript.md
@@ -36,7 +36,7 @@ Follow these steps to create a Node.js console application and install the Speec
     ```
 1. Run the application with your preferred command line arguments. See [usage and arguments](#usage-and-arguments) for the available options. Here is an example:
     ```console
-    node captioning.js --key YourSubscriptionKey --region YourServiceRegion --input c:\caption\caption.this.wav --output c:\caption\caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
+    node captioning.js --key YourSubscriptionKey --region YourServiceRegion --input caption.this.wav --output caption.output.txt - --srt --recognizing --threshold 5 --profanity mask --phrases "Contoso;Jessie;Rehaan"
     ```
     Replace `YourSubscriptionKey` with your Speech resource key, and replace `YourServiceRegion` with your Speech resource [region](~/articles/cognitive-services/speech-service/regions.md), such as `westus` or `northeurope`. Make sure that the paths specified by `--input` and `--output` are valid. Otherwise you must change the paths.
 
@@ -46,7 +46,7 @@ Follow these steps to create a Node.js console application and install the Speec
     > [!IMPORTANT]
     > Remember to remove the key from your code when you're done, and never post it publicly. For production, use a secure way of storing and accessing your credentials like [Azure Key Vault](../../../../../key-vault/general/overview.md). See the Cognitive Services [security](../../../../cognitive-services-security.md) article for more information.
 
-    The output file with complete captions is written to `c:\caption\caption.output.txt`. Intermediate results are shown in the console:
+    The output file with complete captions is written to `caption.output.txt`. Intermediate results are shown in the console:
     ```console
     00:00:00,180 --> 00:00:01,600
     Welcome to
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/speech-to-text-basics/java.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/speech-to-text-basics/java.md
@@ -18,11 +18,53 @@ ms.author: eur
 
 Before you can do anything, you need to install the Speech SDK. The sample in this quickstart works with the [Java Runtime](~/articles/cognitive-services/speech-service/quickstarts/setup-platform.md?pivots=programming-language-java&tabs=jre).
 
+1. Install [Apache Maven](https://maven.apache.org/install.html)
+1. Create a new `pom.xml` file in the root of your project, and copy the following into it:
+    ```xml
+    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+        <modelVersion>4.0.0</modelVersion>
+        <groupId>com.microsoft.cognitiveservices.speech.samples</groupId>
+        <artifactId>quickstart-eclipse</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <build>
+            <sourceDirectory>src</sourceDirectory>
+            <plugins>
+            <plugin>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.7.0</version>
+                <configuration>
+                <source>1.8</source>
+                <target>1.8</target>
+                </configuration>
+            </plugin>
+            </plugins>
+        </build>
+        <repositories>
+            <repository>
+            <id>maven-cognitiveservices-speech</id>
+            <name>Microsoft Cognitive Services Speech Maven Repository</name>
+            <url>https://azureai.azureedge.net/maven/</url>
+            </repository>
+        </repositories>
+        <dependencies>
+            <dependency>
+            <groupId>com.microsoft.cognitiveservices.speech</groupId>
+            <artifactId>client-sdk</artifactId>
+            <version>1.23.0</version>
+            </dependency>
+        </dependencies>
+    </project>
+    ```
+1. Install the Speech SDK and dependencies.
+    ```console
+    mvn clean dependency:copy-dependencies
+    ```
+
 ## Recognize speech from a microphone
 
 Follow these steps to create a new console application for speech recognition.
 
-1. Open a command prompt where you want the new project, and create a new file named `SpeechRecognition.java`.
+1. Create a new file named `SpeechRecognition.java` in the same project root directory.
 1. Copy the following code into `SpeechRecognition.java`:
 
     ```java
@@ -82,7 +124,8 @@ Follow these steps to create a new console application for speech recognition.
 Run your new console application to start speech recognition from a microphone:
 
 ```console
-java SpeechRecognition
+javac SpeechRecognition.java -cp ".;target\dependency\*"
+java -cp ".;target\dependency\*" SpeechRecognition
 ```
 
 Speak into your microphone when prompted. What you speak should be output as text: 
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/speech-translation-basics/java.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/speech-translation-basics/java.md
@@ -17,21 +17,13 @@ ms.author: eur
 > [!div class="nextstepaction"]
 > <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Speech&Product=Speech-translation&Page=quickstart&Section=Prerequisites" target="_target">I ran into an issue</a>
 
+
 ## Set up the environment
 
 Before you can do anything, you need to install the Speech SDK. The sample in this quickstart works with the [Java Runtime](~/articles/cognitive-services/speech-service/quickstarts/setup-platform.md?pivots=programming-language-java&tabs=jre).
 
-To complete the steps in this quickstart, you must also install [Apache Maven](https://maven.apache.org/install.html).
-
-> [!div class="nextstepaction"]
-> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Speech&Product=Speech-translation&Page=quickstart&Section=Set-up-the-environment" target="_target">I ran into an issue</a>
-
-## Translate speech from a microphone
-To complete the steps in this quickstart, you must also install [Apache Maven](https://maven.apache.org/install.html).
-Follow these steps to create a new console application for speech recognition.
-
-1. Open a command prompt where you want the new project, and create a new `pom.xml` file. 
-1. Copy the following XML content into `pom.xml`:
+1. Install [Apache Maven](https://maven.apache.org/install.html)
+1. Create a new `pom.xml` file in the root of your project, and copy the following into it:
     ```xml
     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
         <modelVersion>4.0.0</modelVersion>
@@ -67,10 +59,18 @@ Follow these steps to create a new console application for speech recognition.
         </dependencies>
     </project>
     ```
-1. Run the following Maven command to install the Speech SDK and dependencies.
+1. Install the Speech SDK and dependencies.
     ```console
     mvn clean dependency:copy-dependencies
     ```
+
+> [!div class="nextstepaction"]
+> <a href="https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=JAVA&Pillar=Speech&Product=Speech-translation&Page=quickstart&Section=Set-up-the-environment" target="_target">I ran into an issue</a>
+
+## Translate speech from a microphone
+
+Follow these steps to create a new console application for speech recognition.
+
 1. Create a new file named `SpeechTranslation.java` in the same project root directory.
 1. Copy the following code into `SpeechTranslation.java`:
 
diff --git a/articles/cognitive-services/Speech-Service/includes/quickstarts/text-to-speech-basics/java.md b/articles/cognitive-services/Speech-Service/includes/quickstarts/text-to-speech-basics/java.md
@@ -14,16 +14,59 @@ ms.author: eur
 
 [!INCLUDE [Prerequisites](../../common/azure-prerequisites.md)]
 
+
 ## Set up the environment
 
 Before you can do anything, you need to install the Speech SDK. The sample in this quickstart works with the [Java Runtime](~/articles/cognitive-services/speech-service/quickstarts/setup-platform.md?pivots=programming-language-java&tabs=jre).
 
+1. Install [Apache Maven](https://maven.apache.org/install.html)
+1. Create a new `pom.xml` file in the root of your project, and copy the following into it:
+    ```xml
+    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+        <modelVersion>4.0.0</modelVersion>
+        <groupId>com.microsoft.cognitiveservices.speech.samples</groupId>
+        <artifactId>quickstart-eclipse</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <build>
+            <sourceDirectory>src</sourceDirectory>
+            <plugins>
+            <plugin>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.7.0</version>
+                <configuration>
+                <source>1.8</source>
+                <target>1.8</target>
+                </configuration>
+            </plugin>
+            </plugins>
+        </build>
+        <repositories>
+            <repository>
+            <id>maven-cognitiveservices-speech</id>
+            <name>Microsoft Cognitive Services Speech Maven Repository</name>
+            <url>https://azureai.azureedge.net/maven/</url>
+            </repository>
+        </repositories>
+        <dependencies>
+            <dependency>
+            <groupId>com.microsoft.cognitiveservices.speech</groupId>
+            <artifactId>client-sdk</artifactId>
+            <version>1.23.0</version>
+            </dependency>
+        </dependencies>
+    </project>
+    ```
+1. Install the Speech SDK and dependencies.
+    ```console
+    mvn clean dependency:copy-dependencies
+    ```
+
 ## Synthesize to speaker output
 
 Follow these steps to create a new console application for speech recognition.
 
-1. Open a command prompt where you want the new project, and create a new file named `SpeechSynthesis.java`.
-1. Copy the following code into `SpeechSynthesis.java`: 
+1. Create a new file named `SpeechSynthesis.java` in the same project root directory.
+1. Copy the following code into `SpeechSynthesis.java`:
 
     ```java
     import com.microsoft.cognitiveservices.speech.*;
@@ -81,7 +124,8 @@ Follow these steps to create a new console application for speech recognition.
 Run your new console application to start speech synthesis to the default speaker.
 
 ```console
-java SpeechSynthesis
+javac SpeechSynthesis.java -cp ".;target\dependency\*"
+java -cp ".;target\dependency\*" SpeechSynthesis
 ```
 
 Enter some text that you want to speak. For example, type "I'm excited to try text to speech." Press the Enter key to hear the synthesized speech. 
