Using SSML for Text-to-Speech

Hello Matthew, 

Happy to help!

Some of the tags in your script can only be used with Neural voices such as the "<amazon:domain name="news"/>" newscaster tag. I also saw some tags in your script that weren't in the correct format. After removing the unsupported tags, and correcting the ones with incorrect format, I found that this version of your script will now work using standard voices:

 <speak>

Hello! <break time="500ms"/> This is an example of an SSML-enhanced text. <p>Paragraphs are separated by a natural pause in speech.</p> For phonetic pronunciation, use <phoneme alphabet="ipa" ph="tɛkst">text</phoneme>. This sentence is followed by a natural pause in speech. This is an **important** point. <prosody volume="+3dB">Highlight this part.</prosody> This is the 1st <say-as interpret-as="ordinal">first</say-as> example of using say-as. The <sub alias="World Wide Web Consortium">W3C</sub> is how you pronounce the abbreviation. <mark name="example_tag"/> <amazon:effect name="drc">This section has dynamic range compression for easier listening. </amazon:effect>This is a secret. <prosody volume="-5dB">Shh! It's a secret.</prosody>

</speak>

Note that the script above has the newscaster tag removed since it wasn't compatible when using standard voices.

You can check out this article for a full list of standard and neural voices, and here's a list of supported SSML tags as well as how to properly use them for your reference.

Hope this helps!

More examples like this in your documentation of supported tags would be really helpful.

From what I read on your pages I was not really able to tell which tags might be open tags and which might be closed. I was also not really aware, at first, that many tags needed attributes. And, to be clear, I am well verse in HTML, but didn't pick up on these things based on how little was provided. Going to Amazon's documentation helped with proper/complete tags, but then it's possible that the tags are not supported... all of this resulted in many error messages, because the tags were just not formed correctly, even though they were in the list.

And, since there was some messaging about not all tags being supported for all voices (standard vs neural, etc), it left me feeling a bit... underwhelmed, and dubious of the implementation, even though I was very much excited when I first saw that it was now available.

So, I am happy to see this example, and while this post probably seems negative, I really am just wanting to suggest that more examples get put into the documentation pages, so it's easier to try things out and get good results while playing with the various tags/attributes/options :)

Hi. Completely agree that some more examples would be really useful. 
I'm struggling quite a bit. Not well-versed in html. 

I am trying to put together some basic literacy lessons and want letter sounds pronounced phonetically. I can't get the tag right. I tried copying the above example. Storyline accepts the markup, but just leaves silence where the ssss sound is supposed to be. Where have I gone wrong?
<phoneme alphabet="ipa" ph="s">sss</phoneme>

Hi Jessica!

Sorry to hear you've run into trouble while working with SSML tags in Storyline!

Testing the tag you shared on my end (64-bit Storyline 360 version 3.85.31840.0 via Windows Parallels on a Mac M1) I did observe the "S" being pronounced. Here's a quick screen recording sharing my results.

To clarify, does your code contain the necessary open and close speak tags used to identify SSML-enhanced text?

If you're comfortable sharing a copy of your .story file, it would be helpful to have a closer look at what you've built out so far. Feel free to share it here in the discussion or privately through a support case.

We'll delete it from our system as soon as troubleshooting is complete!

Hi Steven 

Thanks for your reply and the example.

I opened the file to check where the tag was used, and voila, it was working. (murphy!) Perhaps I wasn't listening closely enough before. The 's' sound is there, though seems to follow directly from the word before. 

Could you advise how best to include a pause before the 's' sound and whether it is possible to lengthen the sound? So instead of a short s, a longer ssss sound (not separate s s s).

I've attached the file. It is a very rough draft of a literacy assessment concept. See slide 1.3.

Thanks!

Hi Jessica,

Happy to chime in!

You can use the <break> tag to add a pause in your paragraph. Here's how. As for making the s longer, try this text which uses both the <break> and <prosody> tags to emphasize the letter S:

<speak>
Which letter makes the <break time="0.3s"/><prosody rate="x-slow">s</prosody> sound? Click on the letter.
</speak>

Hope this helps!