# <prosody>

Description

Specifies prosodic information for the enclosed text.

Syntax

    <prosody
        pitch="high" | "medium" | "low" | "default" | "pitch" | "relative change"
        contour="(X1%,pitch1)(X2%,pitch2)...(Xn%,pitchn)"
        range="high" | "medium" | "low" | "default" | "pitch range" | "relative change"
        rate="fast" | "medium" | "slow" | "default" | "rate" | "relative change"
        duration="time_interval"
        volume="silent" | "soft" | "medium" | "loud" | "default" | "volume" | "relative change">
      child elements
    </prosody>

Attributes

Attribute | Description
pitch | Specifies the pitch. Pitch is measured in Hz, but units do not need to be specified.
contour | Specifies the pitch contour for the text, by defining the pitch at n points in the speech output. The algorithm for interpolating between the points is platform-specific. Each point n is Xn% of the way through the total length of the contained text. Each pitchn is any value allowed for the `pitch` attribute. If X<0 or X>100, the point will be ignored. If (0%,pitch1) and (100%,pitchn) are not specified, the pitches of the nearest defined points will be copied.
range | Specifies the pitch range. Pitch range is measured in Hz, but units do not need to be specified.
rate | Specifies the speaking rate. Rate is measured in wpm (words per minute), but units do not need to be specified.
duration | Specifies the duration in seconds or milliseconds for the time to read the text.
volume | Specifies the output volume. Volume is a number between 0.0 and 100.0

Note: Relative changes increase/decrease the current value by either the specified amount or percentage: "+/-X[%]",
where X is a floating-point value (ex. "+10", "-5.5", "+15.2%", "-8.0%"). For the pitch and range attributes, relative
changes in semitones are also permitted: "+/-Xst", where X is an integer (ex. "+5st", "-2st").

Parents

<audio>, <choice>, <emphasis>, <enumerate>, <foreach>, <paragraph>, <p>, <prompt>, <prosody>, <sentence>, <s>, <speak>, <voice>

Children

<audio>, <break>, <emphasis>, <mark>, <paragraph>, <p>, <phoneme>, <prosody>, <say-as>, <sentence>, <s>, <sub>, <voice>, <value>, #PCDATA

Limitations/Restrictions

- Currently, `<enumerate>` and `<mark>` are not supported within `<prosody>`.
- `<prosody>` is only supported as a child of `<foreach>` when `<foreach>` is used within `<prompt>`.
- Refer to your vendor documentation for support details.

Example

To include speech markup tags, insert the SSML tags inside one of the `<prompt>`, `<audio>`, `<choice>`, `<enumerate>`, or `<foreach>` (within `<prompt>`) elements.

    <prompt>
       <prosody rate="fast">Hello, world!</prosody>
    </prompt>