Skip to content

Commit 948d547

Browse files
Update speech-synthesis-markup-structure.md
1 parent dc59a6c commit 948d547

File tree

1 file changed

+0
-28
lines changed

1 file changed

+0
-28
lines changed

articles/cognitive-services/Speech-Service/speech-synthesis-markup-structure.md

Lines changed: 0 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -180,34 +180,6 @@ A good place to start is by trying out the slew of educational apps that are hel
180180
</speak>
181181
```
182182

183-
## Control audio duration
184-
185-
Use the `mstts:audioduration` element to set the length of the output audio. The audio duration setting is applied to all input text within its enclosing `voice` element. To reset or change the duration setting again, you must use a new `voice` element with either the same voice or a different voice.
186-
187-
The expected audio length should be within 0.5 to 2 times the original audio. If the expected length exceeds the limit, the `mstts:audioduration` element will not control the length of the output audio as you expect. So before using this element, we recommend that you first estimate the length of the original audio based on your script text. To do this, you can refer to the [voice list](rest-text-to-speech.md#get-a-list-of-voices) and check the "WordsPerMinute" attribute of the voice being used. If the estimated length of the original audio exceeds the limit, it's best to adjust your script text to meet the limit before using this element. For example, if the estimated length of your original audio is around 10s and your expected length is 30s, you should first adjust your script to ensure that your original audio is no less than 15s and no more than 60s.
188-
189-
Usage of the `mstts:audioduration` element's attributes are described in the following table.
190-
191-
| Attribute | Description | Required or optional |
192-
| ---------- | ---------- | ---------- |
193-
| `value` | The duration of the output audio in seconds (such as `2s`) or milliseconds (such as `500ms`). Audio duration can be applied at the voice level. The value should be within 0.5 to 2 times the original audio.| Required |
194-
195-
### mstts audio duration examples
196-
197-
The supported values for attributes of the `mstts:audioduration` element were [described previously](#control-audio-duration).
198-
199-
In this example, the original audio is around 15s. The `mstts:audioduration` element is used to set the audio duration to 20s.
200-
201-
```xml
202-
<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xmlns:mstts="http://www.w3.org/2001/mstts" xml:lang="en-US">
203-
<voice name="en-US-JennyNeural">
204-
<mstts:audioduration value="20s"/>
205-
If we're home schooling, the best we can do is roll with what each day brings and try to have fun along the way.
206-
A good place to start is by trying out the slew of educational apps that are helping children stay happy and smash their schooling at the same time.
207-
</voice>
208-
</speak>
209-
```
210-
211183
## Specify paragraphs and sentences
212184

213185
The `p` and `s` elements are used to denote paragraphs and sentences, respectively. In the absence of these elements, the Speech service automatically determines the structure of the SSML document.

0 commit comments

Comments
 (0)