Merge pull request #284665 from solarrezaei11/solarworkingbranch

Add table for voice order of priority

Author: denrea

articles/ai-services/speech-service/includes/how-to/speech-synthesis/cpp.md

@@ -40,6 +40,8 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
+
 ## Synthesize speech to a file
 
 Create a [SpeechSynthesizer](/cpp/cognitive-services/speech/speechsynthesizer) object. This object shown in the following snippets runs text to speech conversions and outputs to speakers, files, or other output streams. `SpeechSynthesizer` accepts as parameters:

articles/ai-services/speech-service/includes/how-to/speech-synthesis/csharp.md

@@ -41,6 +41,8 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
+
 ## Synthesize speech to a file
 
 Create a [SpeechSynthesizer](/dotnet/api/microsoft.cognitiveservices.speech.speechsynthesizer) object. This object shown in the following snippets runs text to speech conversions and outputs to speakers, files, or other output streams. `SpeechSynthesizer` accepts as parameters:

articles/ai-services/speech-service/includes/how-to/speech-synthesis/go.md

@@ -310,6 +310,8 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
+
 ## Use SSML to customize speech characteristics
 
 You can use Speech Synthesis Markup Language (SSML) to fine-tune the pitch, pronunciation, speaking rate, volume, and more in the text to speech output by submitting your requests from an XML schema. This section shows an example of changing the voice. For more information, see [Speech Synthesis Markup Language overview](../../../speech-synthesis-markup.md).

articles/ai-services/speech-service/includes/how-to/speech-synthesis/java.md

@@ -41,6 +41,8 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specified by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
+
 ## Synthesize speech to a file
 
 Create a [`SpeechSynthesizer`](/java/api/com.microsoft.cognitiveservices.speech.speechsynthesizer) object. This object runs text to speech conversions and outputs to speakers, files, or other output streams. `SpeechSynthesizer` accepts as parameters:

articles/ai-services/speech-service/includes/how-to/speech-synthesis/javascript.md

@@ -42,6 +42,8 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
+
 ## Synthesize text to speech
 
 # [browserjs](#tab/browserjs)

articles/ai-services/speech-service/includes/how-to/speech-synthesis/python.md

@@ -36,14 +36,7 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
-In summary, the order of priority can be described as:
-
-| `SpeechSynthesisVoiceName` | `SpeechSynthesisLanguage` | SSML | Outcome |
-|:----------------------------:|:----------------------------:|:--------:|---------------------------------------------------------|
-| ✗ | ✗ | ✗ | Default voice for `en-US` speaks |
-| ✗ | ✔ | ✗ | Default voice for specified locale speaks. |
-| ✔ | ✔ | ✗ | The voice that you specify by using `SpeechSynthesisVoiceName` speaks. |
-| ✔| ✔ | ✔ | The voice that you specify by using SSML speaks. |
+[!INCLUDE [Voice Priority Summary](voice-priority.md)]
 
 ## Synthesize speech to a file
 

articles/ai-services/speech-service/includes/how-to/speech-synthesis/voice-priority.md

@@ -0,0 +1,8 @@
+In summary, the order of priority can be described as:
+
+| `SpeechSynthesisVoiceName` | `SpeechSynthesisLanguage` | SSML | Outcome |
+|:----------------------------:|:----------------------------:|:--------:|---------------------------------------------------------|
+| ✗ | ✗ | ✗ | Default voice for `en-US` speaks |
+| ✗ | ✔ | ✗ | Default voice for specified locale speaks. |
+| ✔ | ✔ | ✗ | The voice that you specify by using `SpeechSynthesisVoiceName` speaks. |
+| ✔| ✔ | ✔ | The voice that you specify by using SSML speaks. |