Voice Toolkit V4.2.2 for WebSphere(R) Studio
安装自述文件

2003 年 10 月

(C)Copyright IBM Corporation 2001, 2003. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

注意：在使用此信息和它支持的产品之前，请阅读本文档“声明”中的一般信息。

本安装自述文件包含下列各节：

1.0 简介
2.0 硬件需求
3.0 软件需求
4.0 安装
    4.1 先决条件
    4.2 安装 Voice Toolkit
    4.3 安装语音技术
    4.4 启用语音工具
5.0 入门
6.0 已知问题
7.0 卸载
    7.1 卸载 Voice Toolkit
    7.2 卸载语音技术
    7.3 卸载失败
8.0 声明
9.0 商标
10.0 第三方许可证

1.0 简介

请不要使用 WebSphere Studio 中的“更新管理器”来安装此 V4.2.2 工具箱更新。请使用安装向导。

该自述文件提供安装 Voice Toolkit for WebSphere Studio 的信息，Voice Toolkit for WebSphere Studio 包括以下功能部件：

  • VoiceXML 应用程序开发和调试 － 包括集成开发环境（IDE）、VoiceXML 编辑器和创建使用 SRGS（XML 或 ABNF）编写语法的编辑器。它还包括发音构建器、录音机和一组 VoiceXML 可再用对话框组件。

  • Voice Portlet 应用程序开发和调试 － 包括集成开发环境（IDE）、VoiceXML 编辑器和创建使用 SRGS（XML 或 ABNF）编写语法的编辑器。它还包括发音构建器、录音机、一组 VoiceXML 可再用对话框组件和构建可部署于语音门户网站服务器上的 portlet 所需的全部 Java 工具。

  • VisualAge for Java 转换信息 － 包括 WebSphere Voice Response Java 应用程序编程接口（API），它替换先前与 VisualAge for Java 一起使用的 JavaBeans 接口。它还包括音频段、文档和教程。

有关使用 Voice Toolkit 的信息，请参阅联机帮助。要查看帮助，在完成安装之后单击“帮助”菜单中的“帮助内容”。当出现“帮助”窗口时，单击“内容”列表中的“语音工具”。

要查看 Voice Portlet Tools 功能部件的帮助，单击“内容”列表中的 Voice Portlet Tools。

2.0 硬件需求
  • 适合运行 Microsoft(R) Windows(R) 2000 的系统。
  • 至少为 Intel(R) Pentium(R) 500 MHz 处理器或同等级别的处理器。
  • 768 MB RAM。
  • 175 MB 磁盘空间，以及附加空间以用于所选择的已安装选项。
  • 在您的用户 TMP 环境变量中指定的驱动器上具有 175 MB 的临时空间。
  • 显示适配器设置至少为 256 色，最低分辨率为 800x600（建议采用 1024x768 或更高分辨率）。
3.0 软件需求
  • Microsoft Windows 2000（Service Pack 3 或更高版本）
    • 注意：允许使用 Microsoft Windows XP，但是不受支持。

  • 还必须已安装下列产品之一的版本：WebSphere Studio Site Developer V5.0.1、WebSphere Studio Application Developer V5.0.1、WebSphere Application Server-Express V5.0.1 或 WebSphere Studio Enterprise Developer V5.0.1。 （参阅 http://www7b.software.ibm.com/wsdd/zones/studio/）。

    注意：如果 WebSphere Studio 产品的版本为 5.0，则应该使用“更新管理器”来将产品自动升级至版本 5.0.1。连接至因特网，打开 WebSphere Studio，并单击“帮助”>“软件更新”>“新的更新”。当完成“可用的更新”窗口时，选择版本 5.0.1 的更新，并遵循屏幕上的指示信息。

4.0 安装

4.1 先决条件

  • “安装向导”要求将显示适配器至少设置为 256 色。否则，“安装向导”可能会产生错误。

  • “安装向导”要求先前已安装下列产品之一：WebSphere Studio Site Developer V5.0.1、WebSphere Studio Application Developer V5.0.1、WebSphere Application Server-Express V5.0.1 或 WebSphere Studio Enterprise Developer V5.0.1，因为此产品为这些基本平台添加了一些功能。

  • 如果具有 Voice Toolkit for WebSphere Studio、Voice Application Access Toolkit for WebSphere Studio 或 Multimodal Toolkit for WebSphere Studio 的任何先前版本，则必须卸载它之后才能安装此版本的 Voice Toolkit。

  • 如果先前已经安装了具有 TTS 的 IBM 产品，则必须卸载该产品之后才能安装 Voice Toolkit。

  • 如果先前已经安装了 WebSphere Voice Server SDK 或者其它先前语音运行时引擎，则将必须（使用“控制面板”上的“添加/删除程序”选项）卸载它们之后才能安装此版本的 Voice Toolkit。 注意：必须安装了 JRE 1.3.1 才能卸载 SDK。

    • 在卸载语音运行时引擎之后，可能需要手工删除语音根环境变量。要完成此任务：

    1. 右键单击桌面上的“我的电脑”图标，并选择
        “属性”。

    2. 在“系统属性”对话框中，单击
        “高级”选项卡，然后单击“环境变量”
        按钮。

    3. 在“系统变量”窗口中，进行滚动以找到
        SPCH_ROOT 和 SPCH_BIN 变量。选择它们
        然后单击“删除”。

    4. 单击“确定”以关闭对话框。

    5. 要使更改生效，必须重新引导系统。

4.2 安装 Voice Toolkit
  • 如果从 CD 进行安装并且自动运行未自动启动，则通过运行 Voicetools_Setup.exe 来启动安装向导。

  • 如果从因特网下载进行安装，通过运行 Voicetools_Setup.exe（它位于您下载所在的目录中）来启动“安装向导”。

  • 网络安装不受支持。如果您从共享映像通过网络来安装，则安装中的 TTS/CTTS 部分可能产生“灾难性故障”错误消息。

  • 如果系统正在资源不足的情况下运行，则您可能会注意到进度指示器与出现第一个安装面板之间存在延迟现象。

  • 安装期间发生的错误将记录在 voicetools_log.txt 文件中，该文件位于由 TMP 环境变量所标识的目录位置。

  • 一旦安装过程已启动，则按“取消”按钮可能无响应，需要您多次单击该按钮之后才会重新出现。

  • 安装过程可能需要从因特网站点下载其它文件。必须确保已配置系统与因特网建立了连接，以便“安装向导”可访问以下 Web 站点：

    http://www3.software.ibm.com/ibmdl/pub/software/websphere/voicetoolkit

  • 当在安装期间下载文件时，会将这些文件解压缩至 TMP 环境变量中指定 Temp 目录的 Voice Toolkit 文件夹。如果愿意的话，可以将可执行文件（Voicetools_Setup.exe）添加至同一目录，并保存文件或者将它们复制到 CD 中。如果您决定稍后安装附加功能部件或语音技术，则可以使用该可执行文件来自动连接至因特网下载站点并访问必需的文件。

  • 安装过程会自动检测下列产品之一的现有安装：WebSphere Studio Site Developer V5.0、WebSphere Studio Application Developer V5.0、WebSphere Application Server-Express V5.0 或 WebSphere Studio Enterprise Developer V5.0，并且只允许您将工具箱安装到这些位置之一。

遵循“安装向导”中的指示信息来安装 Voice Toolkit。

“安装向导”将文件复制到以下目录结构中：

<toolkit_install_directory>\
    eclipse － 功能部件和插件
    VoiceToolkit － jvm、许可证、自述文件、样本和卸载程序

4.3 安装语音技术

使用“安装向导”来为您安装的以下每个功能部件安装语言（语音技术）：“VoiceXML 应用程序开发和调试”、“Voice Portlet 应用程序开发和调试”或“VisualAge for Java 转换”。必须为每个功能部件至少选择一种语音技术。如果选择了两个功能部件都使用的语音技术，则将为这两个功能部件都选择和安装该语音技术。

要安装 CTTS 语音技术（最大可能达到 700 MB），在安装期间您将自动连接至下载站点。注意，每种语言只能安装一组引擎（TTS 或 CTTS）。如果您为同一种语言同时选择了 TTS 和 CTTS 语音技术，则将只安装和使用 CTTS 引擎。然后，如果您想使用 TTS 引擎，则将必须重新安装 TTS 语音技术，该过程将自动卸载 CTTS。

您随时都可以安装其它语音技术。为此，使用 Voicetools_Setup.exe 再次运行“安装向导”。在功能部件面板上单击“下一步”，并在语音技术面板上选择要安装的新语言。

4.4 启用语音工具

在完成 Voice Toolkit 的安装之后，必须通过使用“更新管理器”来在 WebSphere Studio 开发环境中启用“语音工具”：

  • 根据您的开发环境启动下列产品之一：WebSphere Studio Site Developer V5.0.1、WebSphere Studio Application Developer V5.0.1、WebSphere Application Server-Express V5.0.1 或 WebSphere Studio Enterprise Developer V5.0.1。

  • 如果出现“更新管理器”弹出窗口（如果您在安装工具箱之前已经使用了 WebSphere Studio 开发平台，则会出现此窗口），则接受所有更改。“更新管理器”仅仅确认将工具箱插件添加到 WebSphere Studio 中。

  • 如果未出现“更新管理器”弹出窗口，则应该选择“帮助”>“软件更新”>“暂挂更改”，并单击列示的所有功能部件的复选框以用选择标记来标记它们，然后按“完成”按钮。

  • 如果您已经从 Voice Toolkit 的先前版本升级，则应复位透视图以确保更新可用于新的工具。为此，从“窗口”菜单中，单击“复位透视图”。

5.0 入门

要启动 Voice Toolkit，从 Windows“开始”菜单中选择“程序”> IBM WebSphere Studio > [您的基本产品]（例如，Site Developer 5.0 或 Application Developer 5.0）。

  • 在安装这些工具并启动 WebSphere Studio 之后， 如果“语音”透视图不在可打开的可用透视图列表中， 则应该在“更新管理器”中激活新的功能部件（帮助 > 软件更新 > 暂挂更改）。选择所列示的每个功能部件的复选框，然后单击“完成”按钮。此操作确认将工具箱插件添加至 WebSphere Studio。

  • “欢迎”屏幕（帮助 > 欢迎 > Voice Portlet Tools 或 Voice Toolkit for WebSphere Studio）中包含一些信息来帮助您开始使用工具箱。“欢迎”屏幕还包含指向更详细的“入门”信息的链接。还可以在“帮助”窗口的“内容”列表中找到“入门”信息 （从“帮助”菜单中单击“帮助内容”，然后选择 Voice Portlet Tools 或“语音工具”）。

  • 使用 Voice Toolkit 创建的项目和文件被保存在您打开 WebSphere Studio 时选择的工作空间目录中。如果卸载 Voice Toolkit，该工作空间将仍然保留在系统上，以便文件仍然可用。

  • 当卸载 Voice Toolkit 时，将删除保存在下列目录中的文件。如果您在这些目录中创建了文件，则在卸载 Voice Toolkit 之前应将这些文件复制到另一个文件夹中：


        <toolkit_install_directory>/eclipse/plugins/
            com.ibm.voicetools.engines.wvs_4.2.0
       
        <toolkit_install_directory>/eclipse/features/
            com.ibm.wpstools_4.2.0
       
        <toolkit_install_directory>/eclipse/plugins/
            com.ibm.voicetools.browser.wvrsim_4.2.2
       
        <toolkit_install_directory>/eclipse/logs

  • 除了工具箱帮助之外，此软件包还包括某些相关出版物。要查看或打印这些出版物，必须使用 Adobe(R) Reader(R) V4.0.5 或更高版本。为了获得最佳查看效果，请使用 Adobe Reader V6.0。

    要下载 Adobe Reader，请转至 Adobe Web 站点，其网址为 www.adobe.com。单击 Get Adobe Reader，并遵循指示信息。

6.0 已知问题

在安装 Voice Toolkit 之前，必须卸载包含 IBM TTS 的任何产品。如果您已经卸载了这些 IBM TTS 产品，但是在安装 Voice Toolkit 时仍然看到一条错误消息 －“发现在另一个位置已经安装了 IBM TTS”，则应遵循下列步骤：

1. 运行（开始 > 运行）regedit.exe

2. 找到键
     “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\
     CurrentVersion\App Paths\ibmtts50.dll\Path”
     的注册表值，并验证已从机器上的引用路径中卸载了 TTS 引擎。

3. 删除注册表键
     “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\
     CurrentVersion\App Paths\ibmtts50.dll”

4. 重试 Voice Toolkit 的安装

7.0 卸载

7.1 卸载 Voice Toolkit

要卸载此产品，从 Windows“开始”菜单运行“添加/删除程序”实用程序：

1. 开始 > 设置 > 控制面板 > 添加/删除程序。

2. 突出显示 Voice Toolkit for WebSphere Studio 的程序条目，并选择“更改／删除”按钮。

注意：

  • 在卸载一个或多个 Voice Toolkit 功能部件之后，在重新安装一个或多个 Voice Toolkit 功能部件之前应该先关闭 WebSphere Studio 并重新启动以复位功能部件列表和配置。

  • 如果想在您安装或更新的新版本工具箱中使用已修改的 Reusable Dialog Components，则应重命名已修改的对话组件，并在安装新版本之后将这些组件复制到已更新的目录中，例如：

    <toolkit_install_directory>\eclipse\plugins\
        com.ibm.voicetools.rdc_4.2.2\resuable_comp\XML\
        subdialogs\<subdialog_name>

7.2 卸载语音技术

要卸载语音技术，使用“添加/删除程序”。在卸载向导上选择要卸载的语言。注意，必须为已安装的每个功能部件至少保留一种语音技术。可能必须在安装第二种语言之后才能卸载第一种语言。

7.3 卸载失败

如果您尝试卸载工具箱，在极少数的情况下（例如，在卸载工具箱之前卸载 WebSphere Studio 开发平台）卸载可能会失败，并且将产生“卸载程序错误”。错误消息对话框允许您从“添加/删除程序”列表中选择是否删除工具箱条目。

如果您选择“是”（首选），则将从“添加/删除程序”列表中删除工具箱条目。如果您选择“否”，则该工具箱条目将保留在“添加/删除程序”列表中。

然后您将需要删除“Windows 注册表”中的其余任何条目。

1. 运行“注册表编辑器”（REGEDIT.EXE 或 REGEDT32.EXE）

2. 删除下列键：
   
    * HKEY_LOCAL_MACHINE\Software\IBM\
      Voice Toolkit for WebSphere Studio
    * HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\
      CurrentVersion\Uninstall\
      f8ea7098568963e941a11a81e7d5a9d5

此时，您可以手工删除由工具箱安装的其余文件夹和文件。

8.0 声明

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：

国际商业机器公司以“按现状”的基础提供本出版物， 不附有任何形式的（无论是明示的，还是默示的）保证，包括（但不限于）对非侵权性、适销性和适用于某特定用途的默示保证。某些国家或地区在某些交易中不允许免除明示或默示的保证，因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其它可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其它关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

9.0 商标

下列各项是国际商业机器公司在美国和／或其它国家或地区的商标或注册商标：
   IBM
   WebSphere

Intel 和 Pentium 是 Intel Corporation 在美国和／或其它国家或地区的商标或注册商标。

Microsoft 和 Windows 是 Microsoft Corporation 在美国和／或其它国家或地区的商标。

Java 和所有基于 Java 的商标和徽标是 Sun Microsystems, Inc. 在美国和／或其它国家或地区的商标或注册商标。

Adobe、Acrobat 和 Reader 是 Adobe Corporation 在美国和／或其它国家或地区的商标或注册商标。

其它公司、产品和服务名称可能是其它公司的商标或服务标记。

10.0 第三方许可证

本程序包括须遵守下列条款的第三方组件：

无论您可能与 IBM 公司或其任一相关公司或关联公司（统称为“IBM”）间的任何其它协议的条款和条件有何规定，下列条款和条件适用于本部分或本产品的许可证信息文档中标识的所有“第三方组件”：(a) 所有第三方组件均在“按现状”的基础上提供；(b) IBM 免除任何和所有明示和暗含的保证和条件，包括（但不限于）对非侵权或冲突的保证以及暗含的关于适销性和适用于某特定用途的保证和条件；(c) 对于与第三方组件相关的任何索赔，IBM 将无须负责或赔偿；(d) 对于与第三方组件相关的任何直接的、间接的、附带的、特别惩戒性的、惩罚性的或后果性的损害，IBM 均无须负责。