jTTS与华为UAP3300挂接指导书

《jTTS与华为UAP3300挂接指导书》由会员分享，可在线阅读，更多相关《jTTS与华为UAP3300挂接指导书（12页珍藏版）》请在装配图网上搜索。

1、jTTS 与华为 UAP3300挂接指导书（hwtts 接口）北京捷通华声语音技术有限公司1/12版本说明与修改记录日期版本作者更新说明20105141。0黄凯创建2/12目录1简介简介.22编写目的编写目的.33HWTTS 接口总述接口总述.34HWTTS 接口说明接口说明.35HWTTS 接口函数说明接口函数说明.45.1Synth2File.45.2CleanFiles.56HWTTS 接口文件列表接口文件列表.57HWTTS 接口安装部署接口安装部署.57。1文件部署文件部署.57.2修改配置文件修改配置文件.67.2.1hwtts。ini.67。2.2 jtts。ini.87。3添加

2、添加 IVR 流程流程.117。4执行执行 IVR 流程流程.118故障检查故障检查.118.1hwtts.log（TTS 客户端日志）客户端日志）.118.2jtts.log(TTS 服务器日志）服务器日志）.118。3UAP3300 平台平台.111 简介简介TTS接口以动态链接库的方式提供。IVR 系统调用 TTS 合成接口进行语音合成,语音文件生成后，IVR 系统进行3/12语音文件播放;播放完毕后，IVR 系统调用 TTS 清理接口,对本次 TTS 放音产生的临时语音文件进行清理。2 编写目的编写目的使用 hwtts 接口的系统集成时，提供该接口说明及使用方法。3 hwtts 接口总

3、述接口总述hwtts 为 jTTS 与华为呼叫中心系统接口组件，用于开发基于 jTTS 语音应用程序,hwtts 接收来自 jTTS 客户端（IVR)的文本，并将此文本发送至 jTTS 语音合成服务器;语音合成服务器接收来自 hwtts 的合成请求,并将合成的语音数据返送给 hwtts，hwtts 将接收到的语音数据根据用户指定的信息合成相对应的一个或多个语音文件.hwtts、jTTS语音合成服务器及 IVR 工作示意图如下：语音合成服务器语音合成服务器语音合成服务器hwttsIVR Server4 hwtts 接口说明接口说明hwtts 以动态链接库的方式提供给开发人员使用，进行语音应用程序

4、开发。IVR 系统直接调用 hwtts 组件的语音合成接口进行语音合成,语音合成采用分段异步实现方式,Synth2File 合成完第一个语音文件后即返回，后续的语音文件在新的线程中后台合成，并将其信息写入临时文件中。合成的语音文件存放在本地目录（hwtts.ini 中的 LocalTTSDir),如果需要，4/12则可以将其以 FTP 方式传输至 FTP 服务器（hwtts。ini 中的）。语音文件生成之后，IVR 系统获取此语音文件并进行播放，而返回给调用程序的语音文件全路径名为 hwtts。ini 中的 RemoteTTSDir文件名；当 IVR 系统播放完毕之后，再调用 hwtts 清理

5、接口对本次 hwtts产生的临时文件进行清理操作。5 hwtts 接口函数说明接口函数说明5.1Synth2File功能描述TTS 语音合成接口,IVR 进行 TTS 放音前，调用该接口启动语音合成，该接口将合成好的第一个语音文件全路径作为输出参数 strDestFile 返回，然后启动线程进行后续语音的合成，后续语音文件全路径记录在一个 INI 文件中，该 INI 文件全路径作为输出参数 strTempIni 返回。原型extern”C_declspec(dllexport)intSynth2File(intnSubCCNO,intnVDNNO,int nSSPFlag,int bStrin

6、g,int nUAPMid，const char*strSynth，char strDestFile，char*strTempIni);输入参数int nSubCCNO 呼叫中心编号int nVDNNO 虚拟呼叫中心编号int nSSPFlag IVR 中的呼叫标志int bString 1:合成字符串，2：合成文本文件int nUAPMid UAP 模块号const char strSynth 待合成文本字符串或文本文件全路径名VOICE eVoice 语音合成使用的音库输出参数char strDestFile 合成的第一个语音文件全路径名,如：d:1_1_8934_536939128_20

7、090325_1237965800_1.wavchar strTempIni 记录所有已合成语音文件名的 INI 文件全路径名，该INI 文件格式如下：VOICEFILE:1_1_8934_536939128_20090325_1237965800_1。wav:1_1_8934_536939128_20090325_1237965800_2.wav:1_1_8934_536939128_20090325_1237965800_3.wav:1_1_8934_536939128_20090325_1237965800_4。wav：1_1_8934_536939128_20090325_123796

8、5800_5.wav其中后缀“#”表示该文件合成未完成（每个文件最后上传至文件服务器成功才算完成），“”表示为最后一个文件。返回值0-成功1-接口参数错误或加载 hwtt。ini 失败2连接 TTS 服务器失败3合成过程异常4连接 TTS 服务器失败其他说明1、语音文件名命名规则：SUBCCNO_VDNNO_PROGID_SSP_DATE_UTCSECONDS_.wavSUBCCNO输入参数 nSubCCNOVDNNO输入参数 nVDNNOPROGID进程号5/12SSP输入参数 nSSPFlagUTCSECONDStime()函数返回值语音文件序号，从 1开始如：1_1_8934_53693

9、9128_20090325_1237965800_2.wav2、记录已合成语音文件的INI文件名的命名规则：SUBCCNO_VDNNO_PROGID_SSP_DATE_UTCSECONDS.ini如：1_1_8934_536939128_20090325_1237965800。ini3、路径获取方法Hwtts。ini 中，LocalTTSDir、RemoteTTSDir、三个配置段中选用哪个路径，由输入参数 nUAPMid决定.5.2CleanFiles功能描述启动线程,删除合成过程中产生的临时语音文件（IVR 服务器和 FTP 服务器上的临时语音文件）和 INI 文件。原型extern”C

10、_declspec(dllexport）int CleanFiles（const char strTempIni）；输入参数char*strTempIni 记录所有已合成语音文件名的 INI 文件全路径名，对应于 Synth2File 的输出参数 strTempIni输出参数无返回值0-成功1失败其他说明如果 strTempIni 路径对应的 INI 文件不存在,返回成功；成功或失败只代表启动线程的结果。6 hwtts 接口文件列表接口文件列表文件名称文件名称功能描述功能描述hwtts.dll动态链接库二进制文件hwtts。iniHwtts 配置文件jtts。inijTTS 参数配置文件jTT

11、S 与华为 UAP3300 挂接指导书配置开发手册7 hwtts 接口安装部署接口安装部署7.1文件部署文件部署hwtts。dllhwtts.inijtts.ini拷贝到 IVR 服务器，IVR 的安装路径下，默认路径为:/huawei/ivr/目录6/127.2修改配置文件修改配置文件根据系统环境（IP 地址、ftp 等)修改配置文件 hwtts.ini和 jtts。ini.7.2.1hwtts.ini根据实际需求，检查配置文件各项是否与实际环境(需求）一致。COMMON；是否写日志；是否写日志.0否；否；1是。建议开启日志是。建议开启日志LogFlag=1;1TTS 引擎是科大的引擎是科大

12、的 InterPhonic，2TTS 引擎是捷通华声的引擎是捷通华声的 jTTSTTSProvider=2;TTS Server 序列号序列号,通过通过 TTS 服务器安装的系统检查工具查看（可参考下图服务器安装的系统检查工具查看（可参考下图)TTSSerialNumber=49B11632B590A0E6;TTS Server 是否在是否在 Client 本机本机,1是是,0否否TTSServerIsLocal=0;TTS Server 的的 IP 地址地址TTSServerIP=192。168.198。198；是否需要将语音文件；是否需要将语音文件 FTP 至文件服务器，至文件服务器，0否

13、否,1是是7/12IfNeedFTP=1;JTTS 在进行远程合成时，会设置一个默认音库，而服务端可能未安装此音库，造成合成在进行远程合成时，会设置一个默认音库，而服务端可能未安装此音库，造成合成失败，但是在失败，但是在 Synth2File 接口中的最后一个参数设置了使用的音库，在设置的音库不支持接口中的最后一个参数设置了使用的音库，在设置的音库不支持的情况下会通过读取配置文件获取音库的情况下会通过读取配置文件获取音库 ID。如果在此处配置的音库无效，则自动启动服务。如果在此处配置的音库无效，则自动启动服务器上的第一个音库作为合成使用音库。器上的第一个音库作为合成使用音库。VoiceID=8

14、4316E85-143E-4410B00B9DF681684C6C；TTS 语音文件合成后本地存放目录，每个语音文件合成后本地存放目录，每个 UAP 的模块号对应一个目录的模块号对应一个目录；如果是无效的模块号（；如果是无效的模块号（=0|LocalDirNum）,使用使用 LocalTTSDir 作为默认路径作为默认路径LocalTTSDirLocalTTSDir=/home/icd/hwtts/testLocalTTSDirNum=01=/home/icd/hwtts/test2=/home/icd/hwtts/test；TTS 语音文件合成后远端上播放目录（语音文件合成后远端上播放目录（

15、CTI 下发给下发给 UAP 的放音消息中所带目录），的放音消息中所带目录），;这个目录是这个目录是 BMRS 板最终播放语音的查找路径，物理上和指代的是同一个目录。板最终播放语音的查找路径，物理上和指代的是同一个目录。;每个每个 UAP 的模块号对应一个目录的模块号对应一个目录;如果是无效的模块号（如果是无效的模块号（=0|RemoteTTSDirNum)，使用，使用 RemoteTTSDir 作为默认路径作为默认路径RemoteTTSDirRemoteTTSDir=d:RemoteTTSDirNum=01=d：8/122=d：;TTS 语音文件通过该语音文件通过该 URL 传送至，形如传送

16、至，形如“；每个；每个 UAP 的模块号对应一个目录的模块号对应一个目录；如果是无效的模块号；如果是无效的模块号(=0|）,使用作为默认路径使用作为默认路径1=2=7.2.2jtts.ini根据实际需求，检查配置文件各项是否与实际环境(需求）一致。JTTS_CONFIG#0/PCM Native(和音库一致,目前为 16KHz，16Bit)1/OKI ADPCM,6KHz,4bit（Dialogic Vox)2/OKI ADPCM,8KHz，4bit（Dialogic Vox）#3/A 律，8KHz,8Bit 4/u 律，8KHz,8Bit#5/PCM,8KHz，8Bit#6/PCM,8KHz

17、,16Bit 7/PCM,16KHz,8Bit#8/PCM,16KHz,16Bit 9/PCM，11。025KHz，8Bit#10/PCM,11.025KHz，16BitnAudioFormat=5#所设置的代码集代号，系统内部缺省为 936.可能的取值如下：936 包括 GB2312，GBK,GB18030#950 Big5 代码集#932 Shift-JIS 代码集，用于日文合成#949 KCS 代码集，用于韩文合成#1252 ISO 8859-1 代码集，用于英文合成 1200 Unicode 代码集#1201 Unicode Big Endian 代码集 65001 UTF-8 代码集

18、wCodePage=936 领域设置，缺省为 DOMAIN_COMMON 可能的取值如下:0 通用领域，新闻、社会、政治等 1 金融证券 2 天气预报 3 体育赛事 4 公交信息#5 旅游餐饮 6 汽运#7 排队叫号9/12 8 名家金曲 9 保险#10 航空 11 税务 12 电力 30 一般定制领域nDomain=0#合成语音的基频，按照 09 分为 10 级，缺省值为 5。数字越大基频越高。nPitch=5#合成语音的音量,按照 09 分为 10 级,缺省值为 9。数字越大音量越大。nVolume=5#合成语音的语速,按照 09 分为 10 级，缺省值为 5。数字越大语速越快.nSpee

19、d=5#标点和回车的设置，系统内部缺省为 0。可能的取值如下：#0 不阅读标点符号，自动判断回车换行是否分隔符 1 阅读标点符号,自动判断回车换行是否分隔符#2 不读符号,强制将回车换行作为分隔符#3 读符号,强制将回车换行作为分隔符nPuncMode=0#数字串的阅读方式，缺省 0 可能的取值如下:#0 自动方式,即根据上下文自动选择电报方式或数目方式阅读,如果无法判断,则使用数目方式。#1 电报方式,即一个数字一个数字阅读。例如：1997 读成“一九九七”。#2 数目方式，即连续的数字阅读。例如：1997 读成“一千九百九十七”。#3 自动方式，即根据上下文自动选择电报方式或数目方式阅读,

20、如果无法判断，则使用电报方式。0 等同于 DIGIT_AUTO_NUMBER，为 1.0 兼容而保留。nDigitMode=0英文串的阅读方式：缺省为 0 可能的取值如下:#0 自动判断，可能按字母、自录音词汇或者 SAPI 阅读。1 由于 4。0 版本中已经内嵌了同一音色的英文引擎,不再使用 SAPI，因此在此版本中ENG_SAPI无效，等同于 ENG_AUTO。#2 强制所有英文按照单字母方式阅读。3 强制所有英文用用字母或自录音词汇阅读,不使用内嵌的英文引擎阅读。nEngMode=0 标注的处理方式，缺省为 0 可能的取值如下：#0 自动判断 TAG,也即同时查询 JTTS Tag 和

21、SSMLTag#1 仅处理含有 jTTS 3。0 支持的 TAG，例如read=a1 2 仅处理 SSML TAG，例如 voice gender=female”/#3 文本中无任何 TAG，上述 TAG将会被读出nTagMode=0#在连接服务器时的重试次数。有效值为 1100.缺省为 10.nTryTimes=10#朗读风格，缺省为 1.10/12 0 抑扬顿挫 1 平稳庄重nVoiceStyle=1 BACKAUDIO_NONE：无背景音乐，取值为 0；#BACKAUDIO_MIN（1）BACKAUDIO_MAX(10000):背景音乐序号，在资源管理中心录音管理器”中定义.nBackA

22、udio=0 背景音乐的音量，从小到大为 0100，默认值为 50.nBackAudioVolume=50 背景音乐是否循环播放，默认值为不循环播放:#0 x01 循环播放 0 x00 不循环播放wBackAudioFlag=0 数据的输出缓冲区大小，以 K 为单位。范围是 168192，也即从 16K8M，默认值为128(K)。用户在获取数据时，每段的长度不会超过此缓冲区大小。nVoiceBufSize=128插入信息的输出缓冲区大小，表示多少条插入信息。范围是 11000,默认值为 100。用户在获取数据时，插入信息的数目不会超过此缓冲区大小，即使数据缓冲区仍有空间，如果插入信息已经达到此

23、缓冲区的最大值,仍然不会再填数据。nInsertInfoSize=100 套接字的超时时间,0 表示没有超时时间nIdleTime=20 使用负载均衡服务器.可以为 1 或 0。缺省值为 0。bLoadBalance=0 Load Balance Server IPszLBServerIP1=10。0.0。82szLBServerIP2=10.0。0.69 Load balance Server portnLBServerPort=2222 TTS ServernTTSServerPort=1000LOG#Log：hwtts.log Limit number of Log file#The m

24、ax size of log file#Level#0,Debug 1,Detail#2，Info#3，Notice 4,Error#5，NoLogLevel=411/127.3添加添加 IVR 流程流程在 IVR 流程的“外挂动态库功能”组件中，添加调用 hwtts.dll的接口。在该“外挂动态库功能”属性中，为各个参数赋值。7.4执行执行 IVR 流程流程按照绘制的 IVR 编译，并部署到 IVR 系统中执行。如果在指定路径下正常生成语音文件表示正常.8 故障检查故障检查8.1hwtts。log(TTS 客户端日志客户端日志)在配置文件jtts。ini中配置,默认路径为 D:hwtts。log，通过日志可以查看 TTS客户端的运行情况以及错误信息。8.2jtts.log（TTS 服务器日志）服务器日志）TTS服务器“jTTS 系统检查工具”的日志中配置。默认路径为 C：jtts.log.通过日志可以查看 TTS服务器的运行情况以及错误信息。8.3UAP3300 平台平台hwtts 接口是通过 IVR 流程直接调用 TTS，与 UAP 平台状态无关.文中如有不足，请您指教！