Merge pull request #175855 from BrianMouncer/BrianMouncer-pr/1.19.0_updates

[Cog Svcs] Brian mouncer pr/1.19.0 updates

Author: hmacgregor1

articles/cognitive-services/Speech-Service/how-to-configure-openssl-linux.md

@@ -16,7 +16,7 @@ ROBOTS: NOINDEX
 
 # Configure OpenSSL for Linux
 
-When using any Speech SDK version before 1.9.0, [OpenSSL](https://www.openssl.org) is dynamically configured to the host-system version. In later versions of the Speech SDK OpenSSL is statically linked to the core library of the Speech SDK. In Speech SDK versions 1.9.0 to 1.16.0 [OpenSSL version 1.1.1b](https://mta.openssl.org/pipermail/openssl-announce/2019-February/000147.html) is used. In Speech SDK version 1.17.0 onward [Open SSL version 1.1.1k](https://mta.openssl.org/pipermail/openssl-announce/2021-March/000197.html) is used.
+With the Speech SDK version 1.19.0 and higher, [OpenSSL](https://www.openssl.org) is dynamically configured to the host-system version. In previous versions, OpenSSL is statically linked to the core library of the SDK.
 
 To ensure connectivity, verify that OpenSSL certificates have been installed in your system. Run a command:
 ```bash
@@ -48,7 +48,7 @@ Set environment variable `SSL_CERT_FILE` to point at that file before running a
 export SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.crt
 ```
 
-## Certificate Revocation Checks
+## Certificate revocation checks
 When connecting to the Speech Service, the Speech SDK will verify that the TLS certificate used by the Speech Service has not been revoked. To conduct this check, the Speech SDK will need access to the CRL distribution points for Certificate Authorities used by Azure. A list of possible CRL download locations can be found in [this document](../../security/fundamentals/tls-certificate-changes.md). If a certificate has been revoked or the CRL cannot be downloaded the Speech SDK will abort the connection and raise the Canceled event.
 
 In the event the network where the Speech SDK is being used from is configured in a manner that does not permit access to the CRL download locations, the CRL check can either be disabled or set to not fail if the CRL cannot be retrieved. This configuration is done through the configuration object used to create a Recognizer object.

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

@@ -14,60 +14,7 @@ ms.author: pankopon
 
 # Configure RHEL/CentOS 7 for Speech SDK
 
-Red Hat Enterprise Linux (RHEL) 8 x64 and CentOS 8 x64 are officially supported by the Speech SDK version 1.10.0 and later. It is also possible to use the Speech SDK on RHEL/CentOS 7 x64, but this requires updating the C++ compiler (for C++ development) and the shared C++ runtime library on your system.
-
-To check the C++ compiler version, run:
-
-```bash
-g++ --version
-```
-
-If the compiler is installed, the output should look like this:
-
-```bash
-g++ (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39)
-```
-
-This message lets you know that GCC major version 4 is installed. This version doesn't have full support for the C++ 11 standard, which the Speech SDK uses. Trying to compile a C++ program with this GCC version and the Speech SDK headers will result in compilation errors.
-
-It's also important to check the version of the shared C++ runtime library (libstdc++). Most of the Speech SDK is implemented as native C++ libraries, meaning it depends on libstdc++ regardless of the language you use to develop applications.
-
-To find the location of libstdc++ on your system, run:
-
-```bash
-ldconfig -p | grep libstdc++
-```
-
-The output on vanilla RHEL/CentOS 7 (x64) is:
-
-```bash
-libstdc++.so.6 (libc6,x86-64) => /lib64/libstdc++.so.6
-```
-
-Based on this message, you'll want to check the version definitions with this command:
-
-```bash
-strings /lib64/libstdc++.so.6 | egrep "GLIBCXX_|CXXABI_"
-```
-
-The output should be:
-
-```bash
-...
-GLIBCXX_3.4.19
-...
-CXXABI_1.3.7
-...
-```
-
-The Speech SDK requires **CXXABI_1.3.9** and **GLIBCXX_3.4.21**. You can find this information by running `ldd libMicrosoft.CognitiveServices.Speech.core.so` on  the Speech SDK libraries from the Linux package.
-
-> [!NOTE]
-> It is recommended that the version of GCC installed on the system is at least **5.4.0**, with matching runtime libraries.
-
-## Example
-
-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:
+To use the Speech SDK for C++ development on Red Hat Enterprise Linux (RHEL) 8 x64 and CentOS 8 x64, update the C++ compiler and the shared C++ runtime library on your system.
 
 ### 1. General setup
 
@@ -79,7 +26,7 @@ sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-pr
 # Install development tools and libraries
 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 alsa-lib dotnet-sdk-2.1 java-1.8.0-openjdk-devel openssl
 sudo yum install -y gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly-free
 ```
 
@@ -91,32 +38,14 @@ Install the prerequisite packages with this command:
 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
+# Build GCC 7.5.0 and runtimes and install them under /usr/local
+curl https://ftp.gnu.org/gnu/gcc/gcc-7.5.0/gcc-7.5.0.tar.bz2 -O
+tar jxf gcc-7.5.0.tar.bz2
+mkdir gcc-7.5.0-build && cd gcc-7.5.0-build
+../gcc-7.5.0/configure --enable-languages=c,c++ --disable-bootstrap --disable-multilib --prefix=/usr/local
 make -j$(nproc)
 sudo make install-strip
 ```
@@ -128,10 +57,6 @@ If the updated compiler and libraries need to be deployed on several machines, y
 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
-
 # Add updated C/C++ runtimes to the library path
 # (this is required for any development/testing with Speech SDK)
 export LD_LIBRARY_PATH=/usr/local/lib64:$LD_LIBRARY_PATH
@@ -143,10 +68,8 @@ export LD_LIBRARY_PATH=/usr/local/lib64:$LD_LIBRARY_PATH
 #   (note, use the actual path to extracted files!)
 export PATH=/usr/local/bin:$PATH
 hash -r # reset cached paths in the current shell session just in case
-export LD_LIBRARY_PATH=/path/to/extracted/SpeechSDK-Linux-1.10.0/lib/x64:$LD_LIBRARY_PATH
+export LD_LIBRARY_PATH=/path/to/extracted/SpeechSDK-Linux-<version>/lib/x64:$LD_LIBRARY_PATH
 
-# For Python: install the Speech SDK module
-python3 -m pip install azure-cognitiveservices-speech --user
 ```
 
 ## Next steps

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

@@ -11,7 +11,7 @@ ms.topic: conceptual
 ms.date: 03/30/2020
 ms.author: amishu
 ms.custom: devx-track-csharp
-zone_pivot_groups: programming-languages-set-twenty-two
+zone_pivot_groups: programming-languages-set-twenty-eight
 ---
 
 # Use codec compressed audio input
@@ -20,14 +20,49 @@ The Speech SDK and Speech CLI can accept compressed audio formats using GStreame
 
 Platform | Languages | Supported GStreamer version
 | :--- | ---: | :---:
-Windows (excluding UWP)  | C++, C#, Java, Python | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/)
-Linux  | C++, C#, Java, Python | [supported Linux distributions and target architectures](~/articles/cognitive-services/speech-service/speech-sdk.md)
-Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.18.3/)
+Linux  | C++, C#, Java, Python, Go | [Supported Linux distributions and target architectures](~/articles/cognitive-services/speech-service/speech-sdk.md) 
+Windows (excluding UWP) | C++, C#, Java, Python | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) 
+Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.18.3/) 
+
+## Installing GStreamer on Linux
+
+For more information, see [Linux installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c).  
+
+```sh
+sudo apt install libgstreamer1.0-0 \
+gstreamer1.0-plugins-base \
+gstreamer1.0-plugins-good \
+gstreamer1.0-plugins-bad \
+gstreamer1.0-plugins-ugly
+```
+## Installing GStreamer on Windows
+
+For more information, see [Windows installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c). 
+
+* Create a folder c:\gstreamer
+* Download [installer](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) 
+* Copy the installer to c:\gstreamer
+* Open PowerShell as an administrator.
+* Run the following command in the PowerShell:
+
+```powershell
+cd c:\gstreamer
+msiexec /passive INSTALLLEVEL=1000 INSTALLDIR=C:\gstreamer /i gstreamer-1.0-msvc-x86_64-1.18.3.msi
+```
+* Add the system variables GST_PLUGIN_PATH with value C:\gstreamer\1.0\msvc_x86_64\lib\gstreamer-1.0
+* Add the system variables GSTREAMER_ROOT_X86_64 with value C:\gstreamer\1.0\msvc_x86_64
+* Add another entry in the path variable as C:\gstreamer\1.0\msvc_x86_64\bin
+* Reboot the machine
+
+## Using GStreamer in Android
+Look at the Java tab above for the details about building libgstreamer_android.so 
+
+For more information see [Android installation instructions](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c). 
 
 ## Speech SDK version required for compressed audio input
 * 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.
-* Speech SDK version 1.16.0 or later for latest GStreamer on Windows and Android.
+* Speech SDK version 1.11.0 or later is required for Windows.
+* Speech SDK version 1.16.0 or later for the latest GStreamer on Windows and Android.
 
 [!INCLUDE [supported-audio-formats](includes/supported-audio-formats.md)]
 
@@ -49,6 +84,10 @@ Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.
 [!INCLUDE [prerequisites](includes/how-to/compressed-audio-input/python/prerequisites.md)]
 ::: zone-end
 
+::: zone pivot="programming-language-go"
+[!INCLUDE [prerequisites](includes/how-to/compressed-audio-input/go/prerequisites.md)]
+::: zone-end
+
 ## Example code using codec compressed audio input
 
 ::: zone pivot="programming-language-csharp"
@@ -67,6 +106,10 @@ Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.
 [!INCLUDE [prerequisites](includes/how-to/compressed-audio-input/python/examples.md)]
 ::: zone-end
 
+::: zone pivot="programming-language-go"
+[!INCLUDE [prerequisites](includes/how-to/compressed-audio-input/go/examples.md)]
+::: zone-end
+
 ## Next steps
 
 > [!div class="nextstepaction"]

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

@@ -8,7 +8,8 @@ ms.author: eur
 
 :::row:::
     :::column span="3":::
-        The C++ Speech SDK is available on Windows, Linux, and macOS. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech </a>.
+        The C++ Speech SDK is available as a NuGet package on Windows, Linux, and macOS. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech</a>.
+        The C++ Speech SDK is also available as tar package from https://aka.ms/csspeech/linuxbinary.
     :::column-end:::
     :::column:::
         <br>

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

@@ -8,7 +8,7 @@ ms.author: eur
 
 :::row:::
     :::column span="3":::
-        When developing for iOS, there are two Speech SDKs available. The Objective-C Speech SDK is available natively as an iOS CocoaPod package. Alternatively, the .NET Speech SDK could be used with Xamarin.iOS as it implements .NET Standard 2.0.
+        When developing for iOS, the following Speech SDKs are available. The Objective-C/Swift Speech SDK is available natively as an iOS CocoaPod package. Alternatively, the .NET Speech SDK could be used with Xamarin.iOS and Unity application frameworks.
     :::column-end:::
     :::column:::
         <br>
@@ -53,7 +53,7 @@ end
 
 :::row:::
     :::column span="3":::
-        Xamarin.iOS exposes the complete iOS SDK for .NET developers. Build fully native iOS apps using C# or F# in Visual Studio. For more information, see <a href="/xamarin/ios/" target="_blank">Xamarin.iOS </a>.
+        Xamarin.iOS exposes the complete iOS SDK for .NET developers. Build fully native iOS apps using C# in Visual Studio. For more information, see <a href="/xamarin/ios/" target="_blank">Xamarin.iOS </a>.
     :::column-end:::
     :::column:::
         <br>

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

@@ -8,12 +8,12 @@ ms.author: eur
 
 :::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) </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.17.0`. (Make sure 1.17.0 is the latest version by [searching our GitHub repo](https://github.com/Azure-Samples/cognitive-services-speech-sdk/search?q=com.microsoft.cognitiveservices.speech%3Aclient-sdk).)
+        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) </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.19.0`. (Make sure 1.19.0 is the latest version by [searching our GitHub repo](https://github.com/Azure-Samples/cognitive-services-speech-sdk/search?q=com.microsoft.cognitiveservices.speech%3Aclient-sdk).)
     :::column-end:::
     :::column:::
         <br>
         <div class="icon is-large">
-            <img alt="Java" src="/media/logos/logo_java.svg" width="60px">
+            <img alt="Java" src="https://docs.microsoft.com/media/logos/logo_java.svg" width="60px">
         </div>
     :::column-end:::
 :::row-end:::
@@ -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.17.0'
+  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.19.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

@@ -8,12 +8,12 @@ ms.author: eur
 
 :::row:::
     :::column span="3":::
-        The Speech SDK only supports **Ubuntu 16.04** (until September), **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 16.04** (until September 2021), **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:
     :::column-end:::
     :::column:::
         <br>
         <div class="icon is-large">
-            <img alt="Linux" src="/media/logos/logo_linux-color.svg" width="60px">
+            <img alt="Linux" src="https://docs.microsoft.com/media/logos/logo_linux.svg" width="60px">
         </div>
     :::column-end:::
 :::row-end:::
@@ -34,29 +34,23 @@ ms.author: eur
 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, additional dependencies may be required.
 
 - The shared libraries of the GNU C library (including the POSIX Threads Programming library, `libpthreads`)
-- The OpenSSL library (`libssl.so.1.0.0` or `libssl.so.1.0.2`)
-- The shared library for ALSA applications (`libasound.so.2`)
+- The OpenSSL library (`libssl`)
+- The shared library for ALSA applications (`libasound`)
 
-# [Ubuntu 16.04/18.04/20.04](#tab/ubuntu)
+# [Ubuntu 18.04/20.04](#tab/ubuntu)
 
 ```Bash
 sudo apt-get update
-sudo apt-get install build-essential libssl1.0.0 libasound2 wget
+sudo apt-get install build-essential libssl-dev libasound2 wget
 ```
 
-> [!NOTE]
-> If libssl1.0.x is not available, install libssl1.1 instead.
-
 # [Debian 9/10](#tab/debian)
 
 ```Bash
 sudo apt-get update
-sudo apt-get install build-essential libssl1.0.2 libasound2 wget
+sudo apt-get install build-essential libssl-dev libasound2 wget
 ```
 
-> [!NOTE]
-> If libssl1.0.x is not available, install libssl1.1 instead.
-
 # [RHEL 7/8 and CentOS 7/8](#tab/rhel-centos)
 
 ```Bash

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

@@ -6,18 +6,16 @@ ms.date: 03/27/2020
 ms.author: eur
 ---
 
-When developing for macOS, there are three Speech SDKs available.
+When developing for macOS, the following Speech SDKs are available.
 
-- The Objective-C Speech SDK is available natively as a CocoaPod package
-- The .NET Speech SDK could be used with **Xamarin.Mac** as it implements .NET Standard 2.0
-- The Python Speech SDK is available as a PyPI module
-
-> [!TIP]
-> For details using the Objective-C Speech SDK with Swift, see <a href="https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_objective-c_into_swift" target="_blank">Importing Objective-C into Swift </a>.
+- The Objective-C/Swift Speech SDK is available natively as a CocoaPod package for Mac x64 and ARM based silicons. For details about using the Objective-C Speech SDK with Swift, see <a href="https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_objective-c_into_swift" target="_blank">Importing Objective-C into Swift </a>.
+- The .NET Speech SDK is available via NuGet package and could be used with **Xamarin.Mac** and **Unity** application frameworks.
+- The Python Speech SDK is available as a PyPI module for Python versions 3.7 and higher.
+- The Java Speech SDK is available via the Maven repository as a JAR package.
 
 ### System requirements
 
-- A macOS version 10.13 or later
+- A macOS version 10.14 or later
 
 # [Xcode](#tab/mac-xcode)
 
@@ -34,7 +32,7 @@ When developing for macOS, there are three Speech SDKs available.
 :::row-end:::
 
 ```
-platform :ios, '9.3'
+platform :osx, 10.14
 use_frameworks!
 
 target 'MyApp' do

articles/cognitive-services/Speech-Service/includes/how-to/compressed-audio-input/csharp/examples.md

@@ -9,7 +9,7 @@ ms.custom: devx-track-csharp
 
 To configure Speech SDK to accept compressed audio input, create `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class, specifying the compression format of the stream. Find related sample code snippets in [About the Speech SDK audio input stream API](../../../../how-to-use-audio-input-streams.md).
 
-Let's assume that you have an input stream class called `pushStream` and are using OPUS/OGG. Your code may look like this:
+Let's assume that you have an input stream class called `pullStream` and are using OPUS/OGG. Your code may look like this:
 
 ```csharp
 using Microsoft.CognitiveServices.Speech;
@@ -29,7 +29,7 @@ var audioFormat =
         AudioStreamContainerFormat.OGG_OPUS);
 var audioConfig =
     AudioConfig.FromStreamInput(
-        pushStream,
+        pullStream,
         audioFormat);
 
 using var recognizer = new SpeechRecognizer(speechConfig, audioConfig);