AmanyIVR使用手册.doc

AmanyIvr 使用手册使用手册 版本：1.0 上海声通信息科技有限公司 2006-6-5 上海声通信息科技有限公司 AmanyIVR 使用手册 第 1 页 共 25 页 目目 录录 1系统简介系统简介2 2基本配置基本配置2 2.1.系统配置.2 2.2.软件安装总览.3 3语音板卡的安装与配置语音板卡的安装与配置3 3.1.语音卡的安装.3 3.1.1 Dialogic 语音传真板卡的安装与配置3 3.1.2东进语音传真板卡的安装与配置.4 3.2.语音卡驱动程序及应用程序4 3.2.1.Dialogic 语音传真板卡程序安装.4 3.2.2.东进语音传真板卡程序安装.8 4修改配置修改配置10 5TTS 引擎的安装与配置引擎的安装与配置14 6IVR 的安装与配置的安装与配置14 6.1安装后的文件组织结构.14 6.2授权给 AMANYIVR程序18 6.3安装 VOICE WEB SERVER.21 6.4 IVR 运行配置脚本24 6.5 VXML 语音脚本文件的编写与启动.30 6.6数据库安装及初始化.30 上海声通信息科技有限公司 AmanyIVR 使用手册 第 2 页 共 25 页 1系统简介系统简介 AmanyIvr 系统采用业界最新的 voiceXML 技术实现，使得用户可以像建立 HTML 的 Web 应用一样轻松地建立语音应用系统，以满足日新月异的新业务需求。 如下图所示，语音浏览器通过解析 VoiceXML ，采用提示音、按键等方式进行人机交互完 成业务流程。特别地，AmanyIvr 系统采用可插拔结构支持语音识别(Automatic Speech Recognition)和语音合成(Text To Speech)技术，从而实现完全通过语音进行人机交互的梦想。 图图 1AmanyIvr 系统概图系统概图 采用 AmanyIvr 系统实现的新业务可以采用任何 Web 技术方便地和原有数据系统结合。用 户可以根据业务需求编写静态 voiceXML 脚本，或采用 ASP/JSP/PHP 等动态生成 voiceXML 脚 本；与后台数据系统间可以采用数据库访问，或采用 XMLHTTP 或其他协议访问。 2基本配置基本配置 . 系统配置系统配置 CPU奔腾 III 800 以上 内存256 兆以上 硬盘200MB 机箱工控机/台式机，需要能插入语音板卡（大板） 电话机 D I A L O G I C 硬件 适配层 VoiceXML 语音 浏览器 Web 服务器 Server Script 业务 访问 层 后台 数据 Amany IVR 系统 上海声通信息科技有限公司 AmanyIVR 使用手册 第 3 页 共 25 页 操作系统Windows 2000 Server SP4 需要的组件IIS 5.0 . 软件安装总览软件安装总览 要想正确使用 IVR，必须依次完成以下软件的安装和配置 1、语音卡驱动程序及应用程序； 2、TTS 引擎； 3、VXML 的编写及启动； 4、IVR 的安装与配置。 3语音板卡的安装与配置语音板卡的安装与配置 . 语音卡的安装语音卡的安装 3.1.1 Dialogic 语音传真板卡的安装与配置语音传真板卡的安装与配置 本系统可使用 Dialogic 语音传真板卡 型号：Dialogic 系列 尺寸：全长卡； 安装步骤，把 Dialogic 板卡插入到计算机内相应的 PCI 或 ISA 插槽上，用螺丝 固定好，无需其他特殊的步骤，等 Dialogic 系统软件安装完成后，才可使用。 注：这期间 Win2000 server 并不认此板卡。即：在 Win2000 Server 的硬件管理 中无法找到此设备。 上海声通信息科技有限公司 AmanyIVR 使用手册 第 4 页 共 25 页 3.1.2 东进语音传真板卡的安装与配置东进语音传真板卡的安装与配置 安装方法和 Dialogic 卡相同。 . 语音卡驱动程序及应用程序语音卡驱动程序及应用程序 3.2.1.Dialogic 语音传真板卡程序安装语音传真板卡程序安装 Dialogic 卡的安装，共需要 3 个软件，分别为： DialogicDialogic SR5.11SR5.11（Dialogic System Release 5.1.1 for Windows） ； DialogicDialogic SR5.11SP1SR5.11SP1，上个文件的 Service Pack 1; DialogicDialogic GlobalGlobal CallCall 3 3(Intel Dialogic Global Call Protocols Package 3.0)。 以上三个程序的安装顺序为： 先安装“SR511”目录下的“setup.exe”文件； 再安装“SR511SP1”目录下的“setup.exe”文件； 安装“Global Call 30WINDOWSI386”目录下的“setup.exe”文件。 1.1. 安装安装 SR5.11SR5.11 插入 VoiceServer 光盘，单击 SR 511 目录下的 Setup.exe 程序，开始安装,如下 图： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 5 页 共 25 页 然后单击“Next” ，输入用户名和公司名称，默认都是主机名；单击“Next” ；出 现如下图画面： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 6 页 共 25 页 选择“Custom”安装方式，然后选择需要安装的组件，建议选择“select all” 项，如下图所示： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 7 页 共 25 页 选择“Install Documentation Locally20MB ；单击“Next” ，继续安装； 然后选择默认安装路径 C:Program filesDialogic，单击“Next” ； 选择默认安装组文件夹，单击“Next” ； 完成安装设置，单击“Next” ，开始安装,如下图： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 8 页 共 25 页 安装完毕，安装程序要求重启机器，选择“NO” ，过一会再重新启动机器； 2.2. 安装安装 SR5.11SP1SR5.11SP1 安装“SR511SP1”目录下的“setup.exe”文件; 文件更新结束，安装程序要求重启机器，选择“Yes” ，重新启动机器。 3.3. 安装安装 GlobalGlobal CallCall 3 3 安装“Global Call 30WINDOWSI386”目录下的“setup.exe”文件； 文件更新结束，安装程序要求重启机器，选择“Yes” ，重新启动机器。 3.2.2.东进语音传真板卡程序安装东进语音传真板卡程序安装 1.1. 安装东进安装东进 DNDN 系列板卡开发软件包系列板卡开发软件包 SDKSDK 点击安装目录下的 SDKSetup.exe 文件。安装程序启动，选择语言种类为“中文” ： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 9 页 共 25 页 依次往下，直至程序拷贝界面，如图： 安装完成后，选择“不，稍候再重新启动电脑” ，等待下一步补丁升级包安装完 成之后再重新启动电脑。 上海声通信息科技有限公司 AmanyIVR 使用手册 第 10 页 共 25 页 2.2. 安装东进安装东进 DNDN 系列板卡补丁包系列板卡补丁包(DJNADK(DJNADK V1.6.3_SP1)V1.6.3_SP1) 安装“东进 DN 系列板卡补丁包(DJNADK V1.6.3_SP1).exe”文件，进入后的界面 如下： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 11 页 共 25 页 依次点击向下，完成程序安装，直至如图所示界面，重新启动电脑。 4修改配置修改配置 1. 振铃声次数的修改 在 C:program filesdialogicCFG目录下，打开 na_an_io.cdp（用 Notepad 或者 Word）文件，按照下图修改； 上海声通信息科技有限公司 AmanyIVR 使用手册 第 12 页 共 25 页 关闭并保存文件； 2. 挂机信号的修改 打开 Dialogic configuration manager 管理程序，具体位置：start- programs-Dialogic system software-Dialogic configuration manager； 如下修改参数 Disconnect tone 的值为 Yes 和 country 的值为 china； 上海声通信息科技有限公司 AmanyIVR 使用手册 第 13 页 共 25 页 上海声通信息科技有限公司 AmanyIVR 使用手册 第 14 页 共 25 页 3. 设置 Dialogic 服务自动启动 在 Dialogic configuration manager 窗口，选择“ServiceStart modeAutomatic” ，如下图所示： 4. 启动 Dialogic 服务 如下图所示： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 15 页 共 25 页 5TTS 引擎的安装与配置引擎的安装与配置 现有的 TTS 引擎总容量大约 340MB，使用时无须做任何配置，具体调用方法如下： 1、拷贝 TTS 目录下所有的文件到需要安装的位置，例如 C:TTS； 2、启动 Server 目录下的 run.bat 文件，启动 TTS 引擎； 3、弹出 DOS 窗口在确定程序已运行后，可以关闭； 4、关于 TTS 的调用配置，可在 IVR 的 config 目录下的 “AmanyIvrConfig.xml”文件中配置； 5、需要了解更多内容，请访问 doc 目录下的“Users Guide.pdf”文件。 6IVR 的安装与配置的安装与配置 6.16.1 安装后的文件组织结构安装后的文件组织结构 VoiceServer 所有的程序文件，都存放在用户指定的安装目录当中。 上海声通信息科技有限公司 AmanyIVR 使用手册 第 16 页 共 25 页 假设用户的安装目录是 AmanyIVR，那么目录的结构如下图所示： -bin 目录用于存放可执行文件，动态链接库 -cdr 目录存放 call detail record 文件 -config 目录存放配置文件 -database 目录存放数据库文件 -font 目录存放字体文件 -outbound 目录存放的是呼出任务文件,finished、expired 和 failed 子目录分别存 放完成、超时和失败的呼出任务 -plugin 存放的是插件 DLL 文件 -sys_log 存放的是系统日志文件（安装完成后一定要确保此目录存在） -ttsout 目录存放的是 text to speech 临时文件 -vxmlDoc 是缺省的存放 VXML 脚本文件的目录 6.2 安装 IVR 安装 IVR 一般通过两种方式安装：利用 SETUP 安装；直接拷贝安装。 利用 SETUP 安装：通常使用的方式，因为这样可以最大可能的避免文件的遗漏和 目录的缺失，同时，一份良好的安装文件也能保证其中所包含程序的成熟安全及 版本一致。安装的方式非常简单，直接运行安装目录下的“SETUP.EXE”文件， 然后按照提示依次向下即可完成安装。 直接拷贝安装：特殊情况下使用的方式。有时针对特定客户的需要，某些程序可 能会作特定调整，这时的程序已经不再是具有共性的软件版本；或者在紧急情况 下，新修正的程序来不及做安装包。以上这些情况，决定了只能直接拷贝安装。 在进行程序安装时，无论采用哪种方式，都必须注意备份，避免因为错误操作可 能导致的损失。 安装步骤： 1. 点击 IVR 的 SETUP.EXE 文件； 2. 出现如图的画面 3. 点击向下，直到出现程序复制界面 上海声通信息科技有限公司 AmanyIVR 使用手册 第 17 页 共 25 页 4. 安装完成后，在桌面上会生成“AmanyIvr”的图标，同时在开始程序中生 成启动图标，位于 start - programs - VoiceComm - AmanyIvr 处。 5. 启动 AmanyIvr 后，系统会打开如图窗口，这就是 IVR 的主控窗口 6.26.2 授权给授权给 AmanyIvrAmanyIvr 程序程序 6.36.3 安装安装 VoiceVoice WebWeb ServerServer Voice Web Server 由 IIS5.0 实现；具体配置步骤如下： -打开 Internet services manager，具体位置：“StartProgramsAdministrator toolsInternet services manager”； -新建一个 Web site，步骤如下： -在 Internet services manager 窗口，按下图打开创建 Web site 向导； -在打开的向导对话框中，单击“Next” ，在下面的对话框中输入 Web site 的名字， 这里为：AMANYIVR；如下图： -单击“Next” ，在下面的 IP 地址和 Port 口设置页面，选择默认选项；如下图： -单击“Next” ，在下面指定 Web Site 根目录页面里，用右边的 Browse 按钮设置 Web Site 的根目录为：D:AmanyIvrdocument server，如下图： -单击“Next” ，在下面设置 Web site 访问权限页面，选择默认值（read、run scripts） ，如图： -单击“Next” ，在完成设置页面，单击“finish”完成设置； -启动 AMANYIVR Web Site，选中 AMANYIVR，单击 Start item 按钮。如下图： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 18 页 共 25 页 6.46.4 IVRIVR 运行配置脚本运行配置脚本 IVR 系统的配置文件采用 XML 文件格式，文件名是 AmanyIvrConfig.xml，该文件 存在于安装目录的 config 子目录中。文件中相关项目的设置很多，其中最主要 有： 1. 设定 VoiceComm Web Server 中语音菜单的 URL 地址 一般而言，IVR 服务器和 WEB 服务器都是同一台机器，因此本段程序中 “initailUrl”引用的也是本地主机 Localhost，如果是其他的机器，使用 IP 地 址和机器名皆可，形如 /main.vxml 或http:/Other/main.vxml 2. 设定语音板卡所使用的通道数量及其方向。 程序中表示共有 8 个通道，其中 1、2 是呼出通道，38 是呼入通道。实际设置 上海声通信息科技有限公司 AmanyIVR 使用手册 第 19 页 共 25 页 按照确定的通道方向设定。 3. IVR 功能的开启。 isSupportFax：表示是否开放传真功能，默认为 False； isSupportLog：表示记录日志文件，默认为 True； isSupportTts：表示是否启用 TTS（语音合成） ，默认为 True； isSupportAsr：表示是否启用语音识别，默认为 False； isSupportCTC：表示是否启用 CTI 服务器，默认为 True； isSupportSNMP：表示 isSupportCdr：表示 以上各项的选项值可选择：False、True。 4. 语音板卡的选择。IVR 系统现在能支持 Intel 的 Dialogic 系列语音卡和东进 的 DN 系列语音卡，使用不同的语音卡，需要对于动态库的调用上作出修改， 如图： 需要使用 Dialogic 卡，则将各文件名称中的 Dj（东进）改为 Dialogic（Intel） ， 即将 DjQueue.dll 改为 DialogicQueue.dll，其他各处修改方法相同。反过来的 修改也一样。 上海声通信息科技有限公司 AmanyIVR 使用手册 第 20 页 共 25 页 5. CTI 服务器的配置 CtiServerAddr：表示 CTI 所在的服务器名称； CtiTrunkCount：表示需要监测的通道的数量； CtiTrunk1N：表示被监测的通道的分机号码，按照实际设置的分机号码填写。 6. 数据库的连接 VoiceComm sa Amany 此处的数据库指的是 IVR 和 Management、Agent 共享的数据库。IVR 将每个电话 的相关信息，例如开始时间等，写入数据库，供给 Management 来查询统计。 DbServer：表示 SQL Server 数据库所在的服务器，可以用服务器名，也可以用 IP 地址。当使用本地数据库时，可以使用本地数据服务器名，也可 以使用 localhost。 DbUser： 表示连接数据库所使用的用户名。 DbPassword：表示连接数据库所使用的密码。 DbName： 表示需要连接的数据表名称。 7. 配置文件中，所有的可配置项的具体含义和选项，如下表所示： 上海声通信息科技有限公司 AmanyIVR 使用手册 第 21 页 共 25 页 项目项目说明说明缺省值缺省值 InitailUriVoiceXML 文件首页 IsSupportTts 定义是否支持 TTS 功能，如果支持，下面的 一项配置有效。 false TtsEngDll 如果平台支持 TTS，指明功能的插件文件名字。 IsSupportAsr 定义是否支持 ASR 功能，如果支持，下面的 一项配置有效。 False AsrEngDll 如果平台支持 ASR，指明功能的插件文件名字。 CdrDirName定义保存 CDR 文件的目录。一般不需要更改Cdr IsSupportFax定义是否支持 FAX 功能。False IsSupportLog定义是否支持 LOG 功能。True isSupportCTC 定义是否支持 CTC 功能，具体的说，就是设 定 IVR 是否和 PBX 协同工作。 接下来的几个项目于这一个项目有关。 True CTCEngDll 如果平台支持 CTC，指明功能的插件文件名字。 CtiServerAddrCTI 服务器的机器名字。 CtiNetwork 与 CTI Server 的连接方式。一般不需要更改。 ncacn_ip_t cp CtiLogicalId CTI Server 定义的连接逻辑号。一般不需要 更改。 1111 CtiTrunkCount和 PBX 连接的 trunk 数目。 CtiTrunk1n依次填写每个 trunk 的电话号码 ttsEngineTTS 引擎支持的语言种类。1 recordDTMFTerm是否录音结束以用户按键为标准。 recordMaxTime录音的最大时长。60000 recordFinalSilence静音多长为录音结束标志。5000 numOfDispatcher消息分发线程数1 isSupportSNMP定义是否支持及时信息通知到 AMANYIVR 上海声通信息科技有限公司 AmanyIVR 使用手册 第 22 页 共 25 页 Observer。 snmpPortSNMP 的 UDP 端口号4700 snmpReportLevel需要向监控程序报告的级别3 ttsServerTTS 服务引擎名。LH ttsOutputDir 临时存放中间 TTS 文件的目录，一般情况下 不用修改。 TtsOut numOfTtsThreadTTS 工作的线程数目。 asrServerASR 的引擎名字。一般不用修改。 numOfAsrThreadASR 工作的线程数目。1 numOfAsrResourceASR 的资源数目。1 promptEncoding定义预录语音文件的格式。2 recordEncoding定义录音的文件格式。4 ttsEncoding定义 TTS 生成的语音格式。4 asrEncoding定义 ASR 的语音格式。4 asrSampleInterval定义间隔。2000 asrSampleSilence定义静音的时长。1500 promptMaxNumber定义最大同时播放语音的数目。128 recordMaxLength录音的最大时长。100000 numOfOutboundThread定义呼出的线程数目。0 outboundTaskDir呼出任务存放的路径。 outboundSleepInteval呼出任务间停顿的时长。1000 logFileName日志文件名前缀AmanyIvr traceLevel 需要日志的级别，1: 调试 2:告警 3: 错误 4: 严重错误 3 traceSession是否日志会话信息False traceDispatcher是否日志消息信息False traceCallControl是否日志呼叫信令信息False traceVoiceService是否日志语音服务信息False traceFaxService是否日志传真服务信息False traceAsrServcie是否日志 ASR 服务信息false traceTtsService是否日志 TTS 服务信息False 上海声通信息科技有限公司 AmanyIVR 使用手册 第 23 页 共 25 页 traceFetchService是否日志取文件信息False traceConvertService是否日志文件转换信息False traceUtility日志日志公用模块信息False monitorMemoryUsage是否监控内存使用量信息False enableConsole是否允许日志信息的屏幕输出False PluginDll定义插件的文件列表。 isSupportCdr定义是否支持 CDR 输出。False CdrDirCDR 的目录，一般不用修改。Cdr CdrFileCDR 文件名字。AmanyIvr CdrMaxFileSize一个 CDR 文件的最大尺寸。1048576 CdrRolloverPeriodCDR 文件的更新时长。21600000 ChannelProtocol模拟信令的协议na_an_io DigitalProtocol数字信令的协议cn_r2_io EventQueueDll 事件队列插件 DLL，可以设置为 D