Add table for voice order of priority

solarrezaei11 · solarrezaei11 · commit 056050d1b9c0 · 2024-08-14T10:53:35.000-07:00
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/cpp.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/cpp.md
@@ -40,6 +40,14 @@ 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. |
+
 ## 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:
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/csharp.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/csharp.md
@@ -41,6 +41,14 @@ 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. |
+
 ## 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:
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/go.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/go.md
@@ -309,6 +309,14 @@ The voice that speaks is determined in order of priority as follows:
 - If you only set `SpeechSynthesisLanguage`, the default voice for the specified locale speaks.
 - 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. |
 
 ## Use SSML to customize speech characteristics
 
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/java.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/java.md
@@ -41,6 +41,14 @@ 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.
 
+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. |
+
 ## 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:
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/javascript.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/javascript.md
@@ -42,6 +42,14 @@ 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. |
+
 ## Synthesize text to speech
 
 # [browserjs](#tab/browserjs)
diff --git a/articles/ai-services/speech-service/includes/how-to/speech-synthesis/python.md b/articles/ai-services/speech-service/includes/how-to/speech-synthesis/python.md
@@ -37,7 +37,6 @@ The voice that speaks is determined in order of priority as follows:
 - 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 |
