Merge pull request #8 from valindrae/media-streaming-edits

Media streaming edits

Author: valindrae

articles/communication-services/concepts/voice-video-calling/media-streaming.md

@@ -15,7 +15,10 @@ ms.custom: private_preview
 > Functionality described on this document is currently in private preview. Private preview includes access to SDKs and documentation for testing purposes that are not yet available publicly.
 > Apply to become an early adopter by filling out the form for [preview access to Azure Communication Services](https://aka.ms/ACS-EarlyAdopter).
 
-Media Streaming API allows developers to get real-time access to media streams to capture, analyze and process audio content during active calls as we see in todays world consumption of live audio and video is very prevalent, this content could be in the forms of online meetings, online conferences, online schooling, customer support, etc. This consumption has only been exacerbated by the recent events of Covid-19, with many of the worlds work force working remotely from home. Developers can use audio from these media streams to enhance their applications and embed their own AI solutions into these calls in real-time for a more improved recommendations to their contact center agents.
+Azure Communication Services provides developers with Media Streaming API to get real-time access to media streams to capture, analyze and process audio content during active calls. 
+
+In today's world consumption of live audio and video is prevalent, this content could be in the forms of online meetings, online conferences, online schooling, customer support, etc. This consumption has only been exacerbated by the recent events of Covid-19, with many of the worlds work force working remotely from home. With media streaming access, developers can now build server applications to capture and analyze audio streams for each of the participants on the call in real-time. Developers can also combine media streaming with other call automation actions or use their own AI models to analyze audio streams for use cases such as NLP for conversation analysis or provide real-time insights and suggestions to their agents while they are in an active interaction with their end users.
+
 
 ## Common use cases
 Audio streams can be used in many ways, below are some examples of how developers may wish to use the audio streams in their applications.
@@ -45,10 +48,10 @@ Contains audio per participant per channel, up to four channels.
 ## Additional information
 The table below describes information that will help developers convert the media packets into audible content that can be used by their applications.
 - Framerate: 50 frames per second
-- Packet stream rate: 20ms rate
-- Data packet: 64Kbytes
-- Audio metric: 16-bit PCM mono at 16000hz
-- Public string data is a base64 string that should be converted into a byte array to create raw pcm file. You can then use the following configuration in Audacity to run the file.
+- Packet stream rate: 20 ms rate
+- Data packet: 64 Kbytes
+- Audio metric: 16-bit PCM mono at 16000 hz
+- Public string data is a base64 string that should be converted into a byte array to create raw PCM file. You can then use the following configuration in Audacity to run the file.
 
 
 

articles/communication-services/quickstarts/voice-video-calling/includes/call-automation-media/media-streaming-quickstart-csharp.md

@@ -19,15 +19,15 @@ ms.author: kpunjabi
 - [Apache Maven](https://maven.apache.org/download.cgi).
 - A websocket server that can receive media streams.
 
-## Setup a websocket server
-Azure Communication Services requires your server application to setup a WebSocket server to stream audio in real-time. WebSocket is a standardized protocol that provides a full-duplex communication channel over a single TCP connection. 
-You can optionally leverage Azure services Azure WebApps that allows you to create an application to receive audio streams over a websocket connection. Follow this [quickstart](https://azure.microsoft.com/blog/introduction-to-websockets-on-windows-azure-web-sites/).
+## Set up a websocket server
+Azure Communication Services requires your server application to set up a WebSocket server to stream audio in real-time. WebSocket is a standardized protocol that provides a full-duplex communication channel over a single TCP connection. 
+You can optionally use Azure services Azure WebApps that allows you to create an application to receive audio streams over a websocket connection. Follow this [quickstart](https://azure.microsoft.com/blog/introduction-to-websockets-on-windows-azure-web-sites/).
 
 ## Establish a call
-In this quickstart we assume that you are already familiar with starting calls, if you need to learn more about starting and establishing calls, you can follow our [quickstart](.../../Callflows-for-customer-interactions.md). For the purposes of this quickstart we will be going through the process of starting media streaming for both incoming calls and outbound calls. 
+In this quickstart we assume that you're already familiar with starting calls. If you need to learn more about starting and establishing calls, you can follow our [quickstart](../../callflows-for-customer-interactions.md). For the purposes of this quickstart, we'll be going through the process of starting media streaming for both incoming calls and outbound calls. 
 
 ## Start media streaming - Incoming call 
-You application will start streaming media when it answers an incoming call. This can be done by providing ACS with your websocket information at the time of answering the call. 
+Your application will start receiving media streams once you answer the call and provide ACS with the WebSocket information. 
 
 ``` csharp
 var mediaStreamingOptions = new MediaStreamingOptions(
@@ -43,7 +43,7 @@ var mediaStreamingOptions = new MediaStreamingOptions(
 ```
 
 ## Start media streaming - Outbound call
-Media streaming can also be initiated when your application creates an outbound call. This can be done by providing ACS the websocket information at the time of the call creation. 
+Your application will start receiving media streams once you create the call and provide ACS with the WebSocket information. 
 
 ``` csharp
 var mediaStreamingOptions = new MediaStreamingOptions(

articles/communication-services/quickstarts/voice-video-calling/includes/call-automation-media/media-streaming-quickstart-java.md

@@ -19,15 +19,15 @@ ms.author: kpunjabi
 - [Java Development Kit](/java/azure/jdk/?preserve-view=true&view=azure-java-stable) version 8 or above.
 - [Apache Maven](https://maven.apache.org/download.cgi).
 
-## Setup a websocket server
-Azure Communication Services requires your server application to setup a WebSocket server to stream audio in real-time. WebSocket is a standardized protocol that provides a full-duplex communication channel over a single TCP connection. 
-You can optionally leverage Azure services Azure WebApps that allows you to create an application to receive audio streams over a websocket connection. Follow this [quickstart](https://azure.microsoft.com/blog/introduction-to-websockets-on-windows-azure-web-sites/).
+## Set up a websocket server
+Azure Communication Services requires your server application to set up a WebSocket server to stream audio in real-time. WebSocket is a standardized protocol that provides a full-duplex communication channel over a single TCP connection. 
+You can optionally use Azure services Azure WebApps that allows you to create an application to receive audio streams over a websocket connection. Follow this [quickstart](https://azure.microsoft.com/blog/introduction-to-websockets-on-windows-azure-web-sites/).
 
 ## Establish a call
-In this quickstart we assume that you are already familiar with starting calls, if you need to learn more about starting and establishing calls, you can follow our [quickstart](.../../Callflows-for-customer-interactions.md). For the purposes of this quickstart we will be going through the process of starting media streaming for both incoming calls and outbound calls.
+In this quickstart we assume that you're already familiar with starting calls. If you need to learn more about starting and establishing calls, you can follow our [quickstart](../../callflows-for-customer-interactions.md). For the purposes of this quickstart, we'll be going through the process of starting media streaming for both incoming calls and outbound calls.
 
 ## Start media streaming - Incoming call 
-You application will start streaming media when it answers an incoming call. This can be done by providing ACS with your websocket information at the time of answering the call. 
+Your application will start receiving media streams once you answer the call and provide ACS with the WebSocket information.
 
 ``` java
 var mediaStreamingOptions = new MediaStreamingOptions(
@@ -42,7 +42,7 @@ var answerCallResponse = callAutomationAsyncClient.answerCallWithResponse(answer
 ```
 
 ## Start media streaming - Outbound call
-Media streaming can also be initiated when your application creates an outbound call. This can be done by providing ACS the websocket information at the time of the call creation. 
+Your application will start receiving media streams once you create the call and provide ACS with the WebSocket information.
 
 ``` java
 var mediaStreamingOptions = new MediaStreamingOptions(

articles/communication-services/quickstarts/voice-video-calling/media-streaming.md

@@ -18,7 +18,7 @@ zone_pivot_groups: acs-csharp-java
 > Functionality described on this document is currently in private preview. Private preview includes access to SDKs and documentation for testing purposes that are not yet available publicly.
 > Apply to become an early adopter by filling out the form for [preview access to Azure Communication Services](https://aka.ms/ACS-EarlyAdopter).
 
-Get started with using audio streams through Azure Communication Services Media Streaming API. This quickstart assumes you are already familiar with Call Automation APIs to build an automated call routing solution. 
+Get started with using audio streams through Azure Communication Services Media Streaming API. This quickstart assumes you're already familiar with Call Automation APIs to build an automated call routing solution. 
 
 ::: zone pivot="programming-language-csharp"
 [!INCLUDE [Media Streaming with .NET](./includes/call-automation-media/media-streaming-quickstart-csharp.md)]
@@ -30,7 +30,7 @@ Get started with using audio streams through Azure Communication Services Media
 
 
 ## Message schema
-When ACS has received the URL for your WebSocket server, it will create a connection to it. Once ACS has successfully connected to your WebSocket server it will send through the first data packet which contains metadata regarding the incoming media packets.
+When ACS has received the URL for your WebSocket server, it will create a connection to it. Once ACS has successfully connected to your WebSocket server, it will send through the first data packet which contains metadata regarding the incoming media packets.
 
 ``` code
 /**
@@ -86,4 +86,13 @@ Example of audio data being streamed
 ```
 
 ## Stop audio streaming
-Audio streaming will automatically stop when the call ends or is cancelled. 
+Audio streaming will automatically stop when the call ends or is canceled. 
+
+## Clean up resources
+
+If you want to clean up and remove a Communication Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it. Learn more about [cleaning up resources](../create-communication-resource.md#clean-up-resources).
+
+## Next steps
+- Learn more about [Call Automation](../../concepts/voice-video-calling/call-automation.md) and its features. 
+- Learn more about [Play action](../../concepts/voice-video-calling/play-action.md).
+- Learn more about [Recognize action](../../concepts/voice-video-calling/recognize-action.md).