Merge pull request #186758 from paulth1/codec-compressed-audio-input-streams

edit pass: codec-compressed-audio-input-streams

Author: ShawnJackson

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

@@ -21,21 +21,21 @@ The Speech SDK and Speech CLI use GStreamer to support different kinds of input
 
 [!INCLUDE [supported-audio-formats](includes/supported-audio-formats.md)]
 
-## Installing GStreamer
+## Install GStreamer
 
-Choose a platform for installation instructions. 
+Choose a platform for installation instructions.
 
 Platform | Languages | Supported GStreamer version
 | :--- | ---: | :---:
-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/)
+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](#tab/android)
 
-See [GStreamer configuration by programming language](#gstreamer-configuration) for the details about building libgstreamer_android.so.
+For more information about building libgstreamer_android.so, see [GStreamer configuration by programming language](#gstreamer-configuration).
 
-For more information, see [Android installation instructions](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c). 
+For more information, see [Android installation instructions](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c).
 
 ### [Linux](#tab/linux)
 
@@ -50,32 +50,32 @@ gstreamer1.0-plugins-ugly
 ```
 ### [Windows](#tab/windows)
 
-Make sure that packages of the same platform (x64 or x86) are installed. For example, if you installed the x64 package for Python, then you need to install the x64 GStreamer package. The instructions below are for the x64 packages. 
+Make sure that packages of the same platform (x64 or x86) are installed. For example, if you installed the x64 package for Python, you need to install the x64 GStreamer package. The following instructions are for the x64 packages.
 
-1. Create a folder c:\gstreamer
-1. Download [installer](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) 
-1. Copy the installer to c:\gstreamer
+1. Create the folder c:\gstreamer.
+1. Download the [installer](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi).
+1. Copy the installer to c:\gstreamer.
 1. Open PowerShell as an administrator.
-1. Run the following command in the PowerShell:
+1. Run the following command in PowerShell:
 
     ```powershell
     cd c:\gstreamer
     msiexec /passive INSTALLLEVEL=1000 INSTALLDIR=C:\gstreamer /i gstreamer-1.0-msvc-x86_64-1.18.3.msi
     ```
 
-1. Add the system variables GST_PLUGIN_PATH with value C:\gstreamer\1.0\msvc_x86_64\lib\gstreamer-1.0
-1. Add the system variables GSTREAMER_ROOT_X86_64 with value C:\gstreamer\1.0\msvc_x86_64
-1. Add another entry in the path variable as C:\gstreamer\1.0\msvc_x86_64\bin
-1. Reboot the machine
+1. Add the system variables GST_PLUGIN_PATH with the value C:\gstreamer\1.0\msvc_x86_64\lib\gstreamer-1.0.
+1. Add the system variables GSTREAMER_ROOT_X86_64 with the value C:\gstreamer\1.0\msvc_x86_64.
+1. Add another entry in the path variable as C:\gstreamer\1.0\msvc_x86_64\bin.
+1. Reboot the machine.
 
-For more information about GStreamer, see [Windows installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c). 
+For more information about GStreamer, see [Windows installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c).
 
 ***
 
 ## GStreamer configuration
 
 > [!NOTE]
-> GStreamer configuration requirements vary by programming language. For details, choose your programming language at the top of this page. The contents of this section will be updated. 
+> GStreamer configuration requirements vary by programming language. For more information, choose your programming language at the top of this page. The contents of this section will be updated.
 
 ::: zone pivot="programming-language-csharp"
 [!INCLUDE [prerequisites](includes/how-to/compressed-audio-input/csharp/prerequisites.md)]

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

@@ -6,9 +6,9 @@ ms.date: 03/09/2020
 ms.author: eur
 ---
 
-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 in [Speech SDK samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/cpp/windows/console/samples/speaker_recognition_samples.cpp).
+To configure the Speech SDK to accept compressed audio input, create `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class that specifies the compression format of the stream. Find related sample code in [Speech SDK samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/cpp/windows/console/samples/speaker_recognition_samples.cpp).
 
-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 `pushStream` and are using OPUS/OGG. Your code might look like this:
 
 ```cpp
 using namespace Microsoft::CognitiveServices::Speech;

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

@@ -6,7 +6,7 @@ ms.date: 03/09/2020
 ms.author: eur
 ---
 
-Handling compressed audio is implemented using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Developers need to install several dependencies and plugins.
+Handling compressed audio is implemented by using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons, GStreamer binaries aren't compiled and linked with the Speech SDK. You need to install several dependencies and plug-ins.
 
 # [Ubuntu/Debian](#tab/debian)
 
@@ -29,7 +29,7 @@ gstreamer1-plugins-ugly-free
 ```
 
 > [!NOTE]
-> - On RHEL/CentOS 7 and RHEL/CentOS 8, in case of using "ANY" compressed format, more GStreamer plugins needs to be installed if stream media format plugin is not in the above installed plugins. 
+> On RHEL/CentOS 7 and RHEL/CentOS 8, in case of using "ANY" compressed format, more GStreamer plug-ins need to be installed if the stream media format plug-in isn't in the preceding installed plug-ins. 
 
 
 ---

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

@@ -7,9 +7,9 @@ ms.author: eur
 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).
+To configure the Speech SDK to accept compressed audio input, create `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class that specifies 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 `pullStream` 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 might look like this:
 
 ```csharp
 using Microsoft.CognitiveServices.Speech;

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

@@ -6,5 +6,7 @@ ms.date: 03/09/2020
 ms.author: eur
 ---
 
-Handling compressed audio is implemented using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Developers need to install several dependencies and plugins, see [Installing on Windows](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c) or [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c). GStreamer binaries need to be in the system path, so that the Speech SDK can load the binaries during runtime. For example, on Windows, if the Speech SDK is able to find `libgstreamer-1.0-0.dll` or `gstreamer-1.0-0.dll` (for latest GStreamer) during runtime, it means the GStreamer binaries are in the system path.
+Handling compressed audio is implemented by using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons, GStreamer binaries aren't compiled and linked with the Speech SDK. You need to install several dependencies and plug-ins. For more information, see [Installing on Windows](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c) or [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c).
+
+GStreamer binaries need to be in the system path so that the Speech SDK can load the binaries during runtime. For example, on Windows, if the Speech SDK finds `libgstreamer-1.0-0.dll` or `gstreamer-1.0-0.dll` (for the latest GStreamer) during runtime, it means the GStreamer binaries are in the system path.
 

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

@@ -6,9 +6,9 @@ ms.date: 09/17/2021
 ms.author: amishu
 ---
 
-To configure the Speech SDK to accept compressed audio input, create a `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class, specifying the compression format of the stream.
+To configure the Speech SDK to accept compressed audio input, create a `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class that specifies the compression format of the stream.
 
-In the following example let's assume that your use case is to use `PushStream` for a compressed file. 
+In the following example, let's assume that your use case is to use `PushStream` for a compressed file.
 
 ```go
 

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

@@ -6,5 +6,5 @@ ms.date: 09/17/2021
 ms.author: amishu
 ---
 
-Speech SDK can use [GStreamer](https://gstreamer.freedesktop.org) to handle compressed audio. However, for licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Developers need to install several dependencies and plugins, see [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c). Go language is only supported in Speech SDK on the Linux platform. See [Speech SDK for Go](../../../../quickstarts/setup-platform.md?pivots=programming-language-go&tabs=dotnet%252cwindows%252cjre%252cbrowser) to get started with Microsoft Speech SDK in Go. 
+Speech SDK can use [GStreamer](https://gstreamer.freedesktop.org) to handle compressed audio. For licensing reasons, GStreamer binaries aren't compiled and linked with the Speech SDK. You need to install several dependencies and plug-ins. For more information, see [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c). Go language is only supported in the Speech SDK on the Linux platform. To get started with the Microsoft Speech SDK in Go, see [Speech SDK for Go](../../../../quickstarts/setup-platform.md?pivots=programming-language-go&tabs=dotnet%252cwindows%252cjre%252cbrowser).
 

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

@@ -6,9 +6,9 @@ ms.date: 03/09/2020
 ms.author: eur
 ---
 
-To configure Speech SDK to accept compressed audio input, create a `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 in [Speech SDK samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/WavStream.java).
+To configure the Speech SDK to accept compressed audio input, create a `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class that specifies the compression format of the stream. Find related sample code in [Speech SDK samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/java/jre/console/src/com/microsoft/cognitiveservices/speech/samples/console/WavStream.java).
 
-Let's assume that you have an input stream class called `pullStream` 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 might look like this:
 
 ```java
 import com.microsoft.cognitiveservices.speech.audio.AudioConfig;

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

@@ -6,17 +6,17 @@ ms.date: 03/09/2020
 ms.author: eur
 ---
 
-Handling compressed audio is implemented using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Instead, you'll need to use the prebuilt binaries for Android. To download the prebuilt libraries, see [installing for Android development](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c).
+Handling compressed audio is implemented by using [GStreamer](https://gstreamer.freedesktop.org). For licensing reasons, GStreamer binaries aren't compiled and linked with the Speech SDK. Instead, you need to use the prebuilt binaries for Android. To download the prebuilt libraries, see [Installing for Android development](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c).
 
-`libgstreamer_android.so` is required. Make sure that all the GStreamer plugins (from Android.mk file below) are linked in `libgstreamer_android.so`. When using the Speech SDK with GStreamer version 1.18.3, `libc++_shared.so` is also required to be present from android ndk.
+The `libgstreamer_android.so` object is required. Make sure that all the GStreamer plug-ins (from the Android.mk file that follows) are linked in `libgstreamer_android.so`. When you use the Speech SDK with GStreamer version 1.18.3, `libc++_shared.so` is also required to be present from android ndk.
 
 ```makefile
 GSTREAMER_PLUGINS := coreelements app audioconvert mpg123 \
     audioresample audioparsers ogg opusparse \
     opus wavparse alaw mulaw flac
 ```
 
-An example `Android.mk` and `Application.mk` file are provided below. Follow these steps to create the `gstreamer` shared object:`libgstreamer_android.so`.
+An example `Android.mk` and `Application.mk` file are provided here. Follow these steps to create the `gstreamer` shared object:`libgstreamer_android.so`.
 
 ```makefile
 # Android.mk
@@ -72,10 +72,10 @@ APP_PLATFORM = android-21
 APP_BUILD_SCRIPT = Android.mk
 ```
 
-You can build `libgstreamer_android.so` using the following command on Ubuntu 18.04 or 20.04. The following command lines have been tested for [GStreamer Android version 1.14.4](https://gstreamer.freedesktop.org/data/pkg/android/1.14.4/gstreamer-1.0-android-universal-1.14.4.tar.bz2) with [Android NDK b16b.](https://dl.google.com/android/repository/android-ndk-r16b-linux-x86_64.zip)
+You can build `libgstreamer_android.so` by using the following command on Ubuntu 18.04 or 20.04. The following command lines have been tested for [GStreamer Android version 1.14.4](https://gstreamer.freedesktop.org/data/pkg/android/1.14.4/gstreamer-1.0-android-universal-1.14.4.tar.bz2) with [Android NDK b16b.](https://dl.google.com/android/repository/android-ndk-r16b-linux-x86_64.zip)
 
 ```sh
-# Assuming wget and unzip already installed on the system
+# Assuming wget and unzip are already installed on the system
 mkdir buildLibGstreamer
 cd buildLibGstreamer
 wget https://dl.google.com/android/repository/android-ndk-r16b-linux-x86_64.zip
@@ -104,4 +104,4 @@ ndk-build -C $(pwd)/gstreamer "NDK_APPLICATION_MK=Application.mk" APP_ABI=armeab
 #ndk-build -C $(pwd)/gstreamer "NDK_APPLICATION_MK=Application.mk" APP_ABI=x86 NDK_LIBS_OUT=$(pwd)
 ```
 
-Once the shared object (`libgstreamer_android.so`) is built application developer needs to place the shared object in the Android app, so that it can be loaded by speech SDK.
+After the shared object (`libgstreamer_android.so`) is built, place the shared object in the Android app so that the Speech SDK can load it.

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

@@ -6,9 +6,9 @@ ms.date: 03/09/2020
 ms.author: amishu
 ---
 
-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.
+To configure the Speech SDK to accept compressed audio input, create `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class that specifies the compression format of the stream.
 
-Let's assume that your use case is to use `PullStream` for an `MP3` file. Your code may look like this:
+Let's assume that your use case is to use `PullStream` for an `MP3` file. Your code might look like this:
 
 ```python