Merge pull request #114577 from BrianMouncer/BrianMouncer-pr/1.12.0_updates

[CogSvcs] Azure docs updates for the v1.12.0 Speech SDK release.

Author: SyntaxC4

articles/cognitive-services/Speech-Service/how-to-configure-rhel-centos-7.md

@@ -40,7 +40,7 @@ ldconfig -p | grep libstdc++
 
 The output on vanilla RHEL/CentOS 7 (x64) is:
 
-```
+```bash
 libstdc++.so.6 (libc6,x86-64) => /lib64/libstdc++.so.6
 ```
 
@@ -52,7 +52,7 @@ strings /lib64/libstdc++.so.6 | egrep "GLIBCXX_|CXXABI_"
 
 The output should be:
 
-```
+```bash
 ...
 GLIBCXX_3.4.19
 ...
@@ -67,7 +67,11 @@ The Speech SDK requires **CXXABI_1.3.9** and **GLIBCXX_3.4.21**. You can find th
 
 ## Example
 
-This is a sample command that illustrates how to configure RHEL/CentOS 7 x64 for development (C++, C#, Java, Python) with the Speech SDK 1.10.0 or later:
+This is a sample command set that illustrates how to configure RHEL/CentOS 7 x64 for development (C++, C#, Java, Python) with the Speech SDK 1.10.0 or later:
+
+### 1. General setup
+
+First install all general dependencies:
 
 ```bash
 # Only run ONE of the following two commands
@@ -81,16 +85,53 @@ sudo yum update -y
 sudo yum groupinstall -y "Development tools"
 sudo yum install -y alsa-lib dotnet-sdk-2.1 java-1.8.0-openjdk-devel openssl python3
 sudo yum install -y gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly-free
+```
 
-# Build GCC 5.4.0 and runtimes and install them under /usr/local
+### 2. C/C++ compiler and runtime libraries
+
+Install the prerequisite packages with this command:
+
+```bash
 sudo yum install -y gmp-devel mpfr-devel libmpc-devel
+```
+
+> [!NOTE]
+> The libmpc-devel package has been deprecated in the RHEL 7.8 update. If the output of the previous command includes a message
+>
+> ```bash
+> No package libmpc-devel available.
+> ```
+>
+> then the necessary files need to be installed from original sources. Run the following commands:
+>
+> ```bash
+> curl https://ftp.gnu.org/gnu/mpc/mpc-1.1.0.tar.gz -O
+> tar zxf mpc-1.1.0.tar.gz
+> mkdir mpc-1.1.0-build && cd mpc-1.1.0-build
+> ../mpc-1.1.0/configure --prefix=/usr/local --libdir=/usr/local/lib64
+> make -j$(nproc)
+> sudo make install-strip
+> ```
+
+Next update the compiler and runtime libraries:
+
+```bash
+# Build GCC 5.4.0 and runtimes and install them under /usr/local
 curl https://ftp.gnu.org/gnu/gcc/gcc-5.4.0/gcc-5.4.0.tar.bz2 -O
 tar jxf gcc-5.4.0.tar.bz2
 mkdir gcc-5.4.0-build && cd gcc-5.4.0-build
 ../gcc-5.4.0/configure --enable-languages=c,c++ --disable-bootstrap --disable-multilib --prefix=/usr/local
 make -j$(nproc)
 sudo make install-strip
+```
+
+If the updated compiler and libraries need to be deployed on several machines, you can simply copy them from under `/usr/local` to other machines. If only the runtime libraries are needed then the files in `/usr/local/lib64` will be enough.
+
+### 3. Environment settings
 
+Run the following commands to complete the configuration:
+
+```bash
 # Set SSL cert file location
 # (this is required for any development/testing with Speech SDK)
 export SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.crt

articles/cognitive-services/Speech-Service/how-to-use-audio-input-streams.md

@@ -20,14 +20,14 @@ The following steps are required when using audio input streams:
 
 - Identify the format of the audio stream. The format must be supported by the Speech SDK and the Speech service. Currently, only the following configuration is supported:
 
-  Audio samples in PCM format, one channel, 16000 samples per second, 32000 bytes per second, two block align (16 bit including padding for a sample), 16 bits per sample.
+  Audio samples in PCM format, one channel, 16 bits per sample, 8000 or 16000 samples per second (16000 or 32000 bytes per second), two block align (16 bit including padding for a sample).
 
   The corresponding code in the SDK to create the audio format looks like this:
 
   ```csharp
   byte channels = 1;
   byte bitsPerSample = 16;
-  int samplesPerSecond = 16000;
+  int samplesPerSecond = 16000; // or 8000
   var audioFormat = AudioStreamFormat.GetWaveFormatPCM(samplesPerSecond, bitsPerSample, channels);
   ```
 

articles/cognitive-services/Speech-Service/how-to-use-codec-compressed-audio-input-streams.md

@@ -17,7 +17,7 @@ zone_pivot_groups: programming-languages-set-twelve
 
 The Speech service SDK **Compressed Audio Input Stream** API provides a way to stream compressed audio to the Speech service using either a `PullStream` or `PushStream`.
 
-Streaming compressed input audio is currently supported for C#, C++, Java on Windows (UWP applications aren't supported) and Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 8, CentOS 8). It is also supported for Java in Android and Objective-C in iOS platform.
+Streaming compressed input audio is currently supported for C#, C++, Java on Windows (UWP applications aren't supported) and Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8). It is also supported for Java in Android and Objective-C in iOS platform.
 * Speech SDK version 1.10.0 or later is required for RHEL 8 and CentOS 8
 * Speech SDK version 1.11.0 or later is required for for Windows.
 

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

@@ -8,7 +8,7 @@ ms.author: trbye
 
 :::row:::
     :::column span="3":::
-        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) <span class="docon docon-navigate-external x-hidden-focus"></span></a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.11.0`.
+        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) <span class="docon docon-navigate-external x-hidden-focus"></span></a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.12.0`.
     :::column-end:::
     :::column:::
         <br>
@@ -27,7 +27,7 @@ To consume the package from your Android Studio project, make the following chan
 
 2. In the module-level *build.gradle* file, add the following to the `dependencies` section:
   ```gradle
-  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.11.0'
+  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.12.0'
   ```
 
 The Java SDK is also part of the [Speech Devices SDK](../speech-devices-sdk.md).

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

@@ -9,7 +9,6 @@ ms.author: trbye
 :::row:::
     :::column span="3":::
         The Speech SDK only supports **Ubuntu 16.04/18.04**, **Debian 9**, **Red Hat Enterprise Linux (RHEL) 7/8**, and **CentOS 7/8** on the following target architectures when used with Linux:
-        - x64
     :::column-end:::
     :::column:::
         <br>
@@ -19,11 +18,13 @@ ms.author: trbye
     :::column-end:::
 :::row-end:::
 
-> [!IMPORTANT]
-> When targeting Linux ARM64, and using C# - the .NET Core 3.x (dotnet-sdk-3.x package) is required. If you're targeting ARM32 or ARM64, Python is not supported.
+- 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
 
-> [!NOTE]
-> The x86 architectures of Ubuntu 16.04, Ubuntu 18.04, and Debian 9 only support C++ development with the Speech SDK.
+> [!IMPORTANT]
+> For C# on Linux ARM64, the .NET Core 3.x (dotnet-sdk-3.x package) is required.
 
 ### System requirements
 
@@ -55,10 +56,8 @@ sudo yum install alsa-lib openssl
 ```
 
 > [!IMPORTANT]
-> Follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
-
-> [!TIP]
-> On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](../how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
 
 ---
 

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

@@ -38,7 +38,7 @@ platform :ios, '9.3'
 use_frameworks!
 
 target 'MyApp' do
-  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.11.0'
+  pod 'MicrosoftCognitiveServicesSpeech', '~> 1.12.0'
 end
 ```
 

articles/cognitive-services/Speech-Service/includes/how-to/compressed-audio-input/cpp/prerequisites.md

@@ -18,7 +18,7 @@ gstreamer1.0-plugins-bad \
 gstreamer1.0-plugins-ugly
 ```
 
-# [REHL / CentOS](#tab/centos)
+# [RHEL/CentOS 7/8](#tab/centos)
 
 ```sh
 sudo yum install gstreamer1 \
@@ -29,6 +29,10 @@ gstreamer1-plugins-ugly-free
 ```
 
 > [!NOTE]
-> On RHEL / CentOS, follow the instructions on [how to configure OpenSSL for Linux](../../../../how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
+
+> [!IMPORTANT]
+> The Opus audio coding format is not supported by the Speech SDK on RHEL/CentOS 7.
 
 ---

articles/cognitive-services/Speech-Service/includes/quickstarts/from-microphone/go/go.md

@@ -20,7 +20,7 @@ Before you get started:
 Update the go.mod file with the latest SDK version by adding this line
 ```sh
 require (
-    github.com/Microsoft/cognitive-services-speech-sdk-go v1.11.0-alpha1
+    github.com/Microsoft/cognitive-services-speech-sdk-go v1.12.0-alpha1
 )
 ```
 

articles/cognitive-services/Speech-Service/includes/quickstarts/platform/cpp-linux.md

@@ -19,7 +19,7 @@ This guide shows how to install the [Speech SDK](~/articles/cognitive-services/s
 
 ## System requirements
 
-Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 8, CentOS 8)
+Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8)
 
 ## Prerequisites
 
@@ -43,7 +43,7 @@ To complete this quickstart, you'll need:
      sudo apt-get install build-essential libssl1.0.2 libasound2 wget
      ```
 
-   * On RHEL/CentOS 8:
+   * On RHEL/CentOS:
 
      ```sh
      sudo yum update
@@ -52,7 +52,8 @@ To complete this quickstart, you'll need:
      ```
 
 > [!NOTE]
-> On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
 
 [!INCLUDE [linux-install-sdk](linux-install-sdk.md)]
 

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

@@ -24,7 +24,7 @@ This guide shows how to install the [Speech SDK](~/articles/cognitive-services/s
 - The Java Speech SDK package is available for these operating systems:
   - Windows: 64-bit only
   - Mac: macOS X version 10.13 or later
-  - Linux: 64-bit only on Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 8, CentOS 8
+  - Linux: 64-bit only on Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8
 
 ## Prerequisites
 
@@ -47,15 +47,16 @@ This guide shows how to install the [Speech SDK](~/articles/cognitive-services/s
         sudo apt-get install build-essential libssl1.0.2 libasound2
         ```
 
-  - On RHEL/CentOS 8, run the following commands to install the required packages:
+  - On RHEL/CentOS, run the following commands to install the required packages:
 
         ```sh
         sudo yum update
         sudo yum install alsa-lib java-1.8.0-openjdk-devel openssl
         ```
 
 > [!NOTE]
-> On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
+> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/cognitive-services/speech-service/how-to-configure-rhel-centos-7.md).
+> - On RHEL/CentOS 8, follow the instructions on [how to configure OpenSSL for Linux](~/articles/cognitive-services/speech-service/how-to-configure-openssl-linux.md).
 
 - On Windows, you need the [Microsoft Visual C++ Redistributable for Visual Studio 2019](https://support.microsoft.com/help/2977003/the-latest-supported-visual-c-downloads) for your platform. Note that installing this for the first time may require you to restart Windows before continuing with this guide.