Merge pull request #200630 from BrianMouncer/BrianMouncer-pr/1.22.0_updates

Brian mouncer pr/1.22.0 updates

Author: 19BMG00

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-java.md

@@ -27,7 +27,7 @@ To consume the package from your Android Studio project, make the following chan
 
 1. In the module-level *build.gradle* file, add the following to the `dependencies` section:
       ```gradle
-      implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.21.0'
+      implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.22.0'
       ```
 
 #### Additional resources

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-linux.md

@@ -8,7 +8,7 @@ ms.author: eur
 
 :::row:::
     :::column span="3":::
-        The Speech SDK only supports **Ubuntu 18.04/20.04**, **Debian 9/10**, **Red Hat Enterprise Linux (RHEL) 7/8**, and **CentOS 7/8** on the following target architectures when used with Linux:
+        The Speech SDK only supports **Ubuntu 18.04/20.04/22.04**, **Debian 9/10/11**, **Red Hat Enterprise Linux (RHEL) 7/8**, and **CentOS 7/8** on the following target architectures when used with Linux:
     :::column-end:::
     :::column:::
         <br>
@@ -18,32 +18,41 @@ ms.author: eur
     :::column-end:::
 :::row-end:::
 
-- x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for C++ development
-- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for Java
-- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for .NET Core
-- x64 for Python
-
-> [!IMPORTANT]
-> For C# on Linux ARM64, the .NET Core 3.x (dotnet-sdk-3.x package) is required.
+- x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for **C++** development
+- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for **Java**
+- x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) for **.NET Core**
+- x64 (not RHEL/CentOS 7) for **Python**
 
 To use the Speech SDK in Alpine Linux, create a Debian chroot environment as documented in the Alpine Linux Wiki on [running glibc programs](https://wiki.alpinelinux.org/wiki/Running_glibc_programs). Then follow the Debian instructions here.
 
 ### System requirements
 
+> [!IMPORTANT]
+> Use the latest point release of the Linux distribution. For example, CentOS 7.9.2009 (or newer if available) for CentOS 7; Ubuntu 18.04.6 (or newer if available) for Ubuntu 18.04 LTS.
+
 For a native application, the Speech SDK relies on `libMicrosoft.CognitiveServices.Speech.core.so`. Make sure the target architecture (x86, x64) matches the application. Depending on the Linux version, more dependencies might be required:
 
 - The shared libraries of the GNU C library, including the POSIX Threads Programming library, `libpthreads`
-- The OpenSSL library (`libssl`)
+- The OpenSSL library (`libssl`) version 1.x
 - The shared library for ALSA applications (`libasound`)
 
-# [Ubuntu 18.04/20.04](#tab/ubuntu)
+# [Ubuntu 18.04/20.04/22.04](#tab/ubuntu)
 
 ```Bash
 sudo apt-get update
 sudo apt-get install build-essential libssl-dev libasound2 wget
 ```
 
-# [Debian 9/10](#tab/debian)
+> [!IMPORTANT]
+> On Ubuntu 22.04, install `libssl1.1` either as a binary package from http://security.ubuntu.com/ubuntu/pool/main/o/openssl/ (e.g. `libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb` or newer for x64) or by compiling it from sources. The Speech SDK does not support OpenSSL 3.0 (the default in Ubuntu 22.04) at the moment.
+
+Example of installing `libssl1.1` on Ubuntu 22.04:
+```Bash
+wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb
+sudo dpkg -i libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb
+```
+
+# [Debian 9/10/11](#tab/debian)
 
 ```Bash
 sudo apt-get update

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-macos.md

@@ -36,7 +36,7 @@ platform :osx, 10.14
 use_frameworks!
 
 target 'MyApp' do
-  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.21.0'
+  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.22.0'
 end
 ```
 

articles/cognitive-services/Speech-Service/includes/quickstarts/captioning/java.md

@@ -53,7 +53,7 @@ Before you can do anything, you need to install the Speech SDK. The sample in th
             <dependency>
             <groupId>com.microsoft.cognitiveservices.speech</groupId>
             <artifactId>client-sdk</artifactId>
-            <version>1.21.0</version>
+            <version>1.22.0</version>
             </dependency>
         </dependencies>
     </project>

articles/cognitive-services/Speech-Service/includes/quickstarts/platform/java-jre.md

@@ -49,7 +49,7 @@ repositories {
 }
 
 dependencies {
-    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.21.0", ext: "jar"
+    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.22.0", ext: "jar"
 }
 ```
 

articles/cognitive-services/Speech-Service/includes/spx-setup.md

@@ -75,6 +75,7 @@ Follow these steps to install the Speech CLI in a Docker container:
    ```console   
    docker pull msftspeech/spx
    ```
+
 Enter this command to display help information for the Speech CLI:
 
 ```console 
@@ -132,6 +133,15 @@ For more extended interaction with the command-line tool, you can start a contai
 docker run -it --entrypoint=/bin/bash -v c:\spx-data:/data --rm msftspeech/spx
 ```
 
+You can combine that with AZ Login and have SPX Init guide you through creating the speech keys and selecting a matching data region without having to use the Azure web portal.  The keys will automatically be stored for later use.
+
+   ```
+   docker run -it --rm --entrypoint /bin/bash -v c:\spx-data:/data msftspeech/spx
+
+   az login
+   spx init
+   ```
+
 <!-- Need to troubleshoot issues with docker pull image
 
 ### Optional: Create a command-line shortcut