SSML使用文档

语音合成标记语言（SSML：Speech Synthesis Markup Language），是提供语音合成的文本注释。

DuerOS会将技能返回的response消息里面的文本信息按照一定的规则转化成语音信息进行播放。转化后的语音有着相同特征，如语调、语速、停顿等都相同。但是在不同的场景下，可能需要不同的语音效果。例如在朗读儿童故事《白雪公主》时，公主说话的声音和小矮人说话的声音，在语调、语速、音色上都不同。这种情况下，开发者可以通过使用SSML标签得到不同的语音效果。

DuerOS支持基础标签和扩展标签两种。基础标签里的所有标签都是SSML标准标签，相当于SSML标签的子集。扩展标签指DuerOS使用标准SSML语言定制的标签。

基础标签

基础标签包含speak、audio、say-as、sub、silence等标签。

speak标签

是SSML的根标签，所有的标签（基础标签和扩展标签）和文本都要包含在<speak></speak>标签内。

audio标签

在合成语音中引入外部的音频，音频以服务器可以访问的地址给出，目前仅支持wav格式的音频文件，同时要求文件大小不能超过3M，播放时间不能超过90s。如果音频文件不符合要求，可能存在播放失败的情况。

属性描述

使用示例

<speak>
播放周杰伦的听妈妈的话。<audio src="http://tis-audio.bj.bcebos.com/tingmamadehua.wav?authorization=bce-auth-v1%2F96d3a871ef2a41ae92abc41ae6acf932%2F2018-03-05T02%3A31%3A13Z%2F-1%2Fhost%2F792bff900a458fd52c07893f27957263a3b2719ee38e1a79212bd980ddd80156"></audio> 播放完了，好听吗？
</speak>

say-as标签

设置合成语音中数字、符号的读法，属性是type 。

属性描述

使用示例

• 一百二十三。
  <say-as type="number:ordinal">123</say-as>
• 一二三。
  <say-as type="number:digits">123</say-as>
• 十二比一百二十三。
  <say-as type="number:score">12:123</say-as>
• 一百二十三分之十二。
  <say-as type="number:fraction">12/123</say-as>
• 幺幺零。
  <say-as type="telephone">110</say-as>
• 一百二十三。
  <say-as type="number">123</say-as>
• 负一百二十三。
  <say-as type="number">-123</say-as>
• 一百二十三点四五。
  <say-as type="number">123.45</say-as>
• 负一百二十三点四五。
  <say-as type="number">-123.45</say-as>
• 一百二十三比四十五。
  <say-as type="number">123:45</say-as>
• 负一百二十三比四十五。
  <say-as type="number">-123:45</say-as>
• 三乘以十的十一次幂。
  <say-as type="number">3e+11</say-as>
• 三乘以十的负十一次幂。
  <say-as type="number">3e-11</say-as>
• 一点二三乘以十的十一次幂。
  <say-as type="number">1.23e+11</say-as>
• 一点二三乘以十的负十一次幂。
  <say-as type="number">1.23e-11</say-as>
• 三乘以十的七次幂。
  <say-as type="number">3E+07</say-as>
• 三乘以十的负七次幂。
  <say-as type="number">3e-07</say-as>
• 一点二三乘以十的七次幂。
  <say-as type="number">1.23e+07</say-as>
• 一点二三乘以十的负七次幂。
  <say-as type="number">1.23e-07</say-as>

sub标签

替换合成语音中部分词语的发音。

属性描述

使用示例

用“胃溃疡”替换单词“GU”的发音，下面的语句读音是“报告单上显示你得了胃溃疡”。

<speak>
    报告单上显示你得了<sub alias="胃溃疡">Gu</sub>。
</speak> 

silence标签

设置静音，在文本播报的开头或结尾增加静音片段。

属性描述

使用示例

<speak>
走廊里传来脚步声，乱哄哄的教室突然安静下来。<silence time="5s"></silence>所有人都盯着教室门。
</speak>

扩展标签

background标签

设置合成语音的背景音。目前仅支持wav格式的音频文件，同时要求文件大小不能超过3M，播放时间不能超过90s。如果音频文件不符合要求，可能存在播放失败的情况。

属性描述

使用示例

<speak>    
<background src="http://tis-audio.bj.bcebos.com/lantern_festival.wav?authorization=bce-auth-v1%2F96d3a871ef2a41ae92abc41ae6acf932%2F2018-03-05T02%3A31%3A01Z%2F-1%2Fhost%2F40a27013eb5244b349301dc1775747ccf3254a1e65b29a6109f38a4479f4cc29" repeat="yes">欢迎使用百度语音合成服务</background>。   
</speak>     

say-as标签

设置合成语音中英文单词读音方式。

属性描述

使用示例

<speak>
美国宇航局简称读作<say-as  interpret-as="as-word">NASA</say-as>还是<say-as  interpret-as="as-character">NASA</say-as>。
</speak>

注意事项

该标签仅对英文有效。

使用限制

在使用SSML标签时，请注意以下限制条件。

• 标签audio不能包含background标签。
• 标签audio、background不支持自我嵌套。
• 标签sub、say-as不能包含其他任何标签，会引发解析错误。

相关参考

• SSML: https://www.w3.org/TR/speech-synthesis11/

SSML应用文件存储

一些SSML标签使用时需要链接文件、播放文件，如audio标签、background标签。目前SSML标签只支持对百度网址的文件访问，推荐使用百度云对象存储BOS存放文件。下面以audio标签为例，介绍如何在百度云BOS上存储文件及SSML标签如何引用文件。

1.登录百度云对象存储BOS。如果你没有百度账号，请先注册。

2.开通BOS服务。 具体操作步骤请参考开通BOS服务指南，BOS是付费项目，请根据需要选择付费类型。

3.点击新建Bucket。

4.填写新建的Bucket信息。

• 按要求填写Bucket名称。
• 选择所属区域。建议根据技能所在区就近存储。
• 根据技能需要选择合适的存储类型。目前支持标准存储、低频存储、冷存储三种类型，存储类型详细信息请参考存储类型的特点。
• 选择读写权限。SSML标签链接的文件不能选择私有权限，可以选择公共读或公共读写。

5.上传文件。选择需要上传的文件，点击上传。

6.获取文件链接地址。

7.在audio标签加入文件链接地址。

<speak>
播放清晨<audio src="http://ssml-example.bj.bcebos.com/qingchen.wav"></audio>，这是一首让你每次聆听都会有不同感动的音乐，早晨若少了纯真鸟语，这一天洒下的阳光都是寂寞的。 
</speak>

了解更多百度云BOS存储内容，请参考百度云对象存储BOS指南。

说明：

1. 开放平台提供了资源管理服务，该服务提供了1G的百度云BOS存储空间，供开发者存储技能中需要的资源。
2. 开放平台提供了SSML音频转码服务，可以方便快捷的将音频文件转成WAV格式文件。