Voice Toolkit V4.2.1 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 已知问题和修正
    3.1 概述
    3.2 特定于语言的注意事项
    3.3 语音识别测试工具
    3.4 编辑器
    3.5 VoiceXML 测试和调试
    3.6 语法测试工具
    3.7 Voice Toolkit 文档
4.0 声明
5.0 商标
6.0 第三方许可证

1.0 简介

本自述文件提供有关“VoiceXML 应用程序开发和调试”功能部件和“Voice Portlet 应用程序开发和调试”功能部件的已知问题和修正的信息。

有关使用这些功能部件的信息，在安装它们之后请参阅联机帮助：
 
   “帮助”>“帮助内容”>“语音工具”，或者


   “帮助”>“帮助内容”>“Voice Portlet Tools”

2.0 入门

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

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

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

  • “欢迎”（帮助 > 欢迎 > Voice Toolkit for WebSphere Studio 或 Voice Portlet Tools）包含有关如何开始使用工具箱的信息。建议您阅读此帮助文件以了解如何开始使用这些工具的信息。“欢迎”屏幕还包含指向更详细的“入门”信息的链接，您还可以在“帮助”窗口的“内容”（帮助 > 帮助内容 > 语音工具或 Voice Portlet Tools）中找到这些信息。

  • 除了工具箱帮助之外，此软件包还包括某些相关出版物。要查看或打印任何相关出版物，必须使用 Adobe(R) Reader(R) V4.0.5 或更高版本。为了获得最佳查看效果，请使用 Adobe Reader V6.0。 要下载 Adobe Reader 的最新版本，请转至 Adobe Web 站点 www.adobe.com。单击 Get Adobe Reader，并遵循指示信息。

    • 3.0 已知问题和修正

    3.1 概述

    • 在某些配置中，一个或多个 javaw.exe 进程可在您退出工具箱之后（特别是在程序异常终止之后）继续运行。可以使用 Windows“任务管理器”来查找和结束任何此类不正常的进程。

    • 使用 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.1
         
          <toolkit_install_directory>/eclipse/logs

    • 当更改“工作台”或“工作台”>“外观”首选项时，“复原缺省值”按钮可能不会复原原始缺省值。另外，可能必须关闭 WebSphere Studio 然后重新启动才能使更改生效。

    • 如果接收到“内部错误 － 窗口小部件已排列”错误消息，则关闭并重新启动 WebSphere Studio 以修正错误。

    • 目录、文件夹和文件的名称中只能包含字母数字字符和空格。这些名称不应该包括非字母数字字符（例如，~!@#$%^&*）。

    • 由于随 WebSphere Studio 一起封装的 JRE 中的 Java Sound 支持存在已知问题，因此，Voice Toolkit 附带提供的缺省录音机不支持 USB 麦克风。

    • 要导入或使用网络资源中的文件，将驱动器盘符映射至该网络资源并从该网络驱动器导入这些文件。
    3.2 特定于语言的注意事项
    • 如果选择安装非 IBM 语音合成（TTS）语言以在语音应用程序服务器（例如，WebSphere Voice Server）上使用，则应该查阅供应商提供的文档以获取有关供应商的 VoiceXML 2.0 和“语音合成标记语言”（SSML）实现的详细信息。另外，如果使用另一个供应商的语言，则还应该使用该供应商的工具来生成发音。如果使用 IBM 工具来为 TTS 输出生成 SSML，则产生的代码在该语言的部署环境中可能不会按期望方式运行。

    • 随工具箱封装在一起的 VoiceXML Programmer's Guide（pgmguide.pdf）（在“帮助”>“帮助内容”>“语音工具”（或 Voice Portlet Tools）>“相关文档”中）包含有关 SSML 的语音标记中受支持的字母的不正确信息。有关更新的信息，请参阅同样位于『相关文档』中的 IBM Text-to-Speech SSML Programming Guide（tts_ssml.pdf）。

    • 不要使用 DBCS 字符来创建项目名称。如果这样做，就会产生验证错误，并且将不验证 XML 文件。

    • 当使用“已知发音”视图时，粤语字被标记为“未知”。要获得工具的正确“粤语”功能， Windows 区域设置应为“Chinese-Taiwan”而不是“Chinese-HongKong”。如果您更改“语音工具”首选项中的语音语言，则需要关闭 WebSphere Studio 以便更改生效。
    3.3 语音识别测试工具
    • 如果想要运行语音识别测试工具，则不要以 Unicode 格式保存脚本文件。如果以 Unicode 格式保存脚本文件，则“结果”对话框会显示一条消息“脚本求值错误！”。无论您选择还是清除“使用 Unicode 方式”复选框，都会发生此问题。要修正此问题，则不要以 Unicode 格式保存脚本文件及选择“使用 Unicode 方式”复选框。

    • 如果使用语音识别测试工具，并且脚本文件包含 DBCS 字符作为音频文件名（.ulw）或语法文件名（.fsg），则必须选择“使用 Unicode 方式”复选框。如果不选择“使用 Unicode 方式”复选框，则不会显示结果。

    • 如果运行语音识别测试工具并且要识别的文本短语具有 DBCS 字符，则选择“使用 Unicode 方式”复选框。如果不选择该复选框，则不会显示结果。
    3.4 编辑器
    • 当选择大型 VoiceXML 文件中的文本时，有时要花几秒钟才会出现突出显示。

    • 如果在编辑器中打开了文件，并且撤销自从上次保存以来对该文件所作的所有更改，则即使它恢复为其原始状态，仍认为该文件具有暂挂的更改。

    • 在某些配置中，在运行或调试 VoiceXML 应用程序之后，您可能会在验证发音时遇到一些问题。如果发生这种情况，则关闭 WebSphere Studio，终止任何 javaw.exe 和 engine.exe 进程，然后重新启动 WebSphere Studio。可以使用 Windows“任务管理器”来查找和结束任何此类不正常的进程。

    • <vxml> 元素必须包含另一个元素才能通过 XML 验证。因此，“新建文件”向导创建的 VoiceXML 文档将 <meta> 标记插入到 <vxml> 元素中。

    • 无论在 VoiceXML 编辑器还是在 SRGS XML 编辑器中，对于长度很长的文本行（例如，具有数千个字符长的行），您都可能会遇到问题。某些情况可能会导致 WebSphere Studio 被挂起。如果发生此问题，则关闭 WebSphere Studio 再重新启动它。

      使用 WebSphere Studio 中的“缺省文本编辑器”打开文件（“文件”>“打开方式”或者从上下文菜单中选择“打开方式”）以将很长的行分成较短的行，然后保存它，并在 VoiceXML 或 SRGS XML 编辑器中重新打开该文件。

    • 如果您正在使用 VoiceXML 文件和使用“内容辅助”，并单击描述弹出窗口，则“内容辅助”窗口将关闭。要继续进行，应重新打开“内容辅助”。

    • 在 SRGS 和 JSGF 语法编辑器中，如果定义了规则但是未使用它，则不会生成警告。

    • 如果看到语法错误“此语法的 SISR 中存在不能确定的错误”，但没有行信息，则可能是由于在 SRGS XML 或 ABNF 语法中使用了无效 SISR 语法。如果您声明 SISR 对象，然后引用了该对象的未声明子对象，则在语法或 VoiceXML 编辑器中就会发生此错误。

    • 在 WebSphere Studio 中关闭编辑器之后，可能要延迟一会儿才能删除文件。

    3.5 VoiceXML 测试和调试
    • 如果 VoiceXML 浏览器装入某一文档（该文档为其 DTD 指定了 HTTP URI），而不能访存该 DTD（例如，如果与网络或因特网断开连接），则正在运行或调试的 VoiceXML 应用程序将终止。

    • 当使用“运行”菜单时，如果“运行方式”子菜单找不到，则使用“运行”工具栏图标以打开下拉列表。

    • 当调试 VoiceXML 应用程序时，双击标尺栏不会添加断点。要添加断点，右键单击标尺栏并选择“添加断点”。

    • 当在调试方式下逐步运行 VoiceXML 应用程序时，您可能会遇到很长的延迟。
    3.6 语法测试工具
    • 当使用语音来测试语法时，与定义的语法项相匹配的短语就会列示在“测试结果”区域中。但是，不能识别的字不会列示。您将不会接收到短语不匹配的指示。
    3.7 Voice Toolkit 文档
    • 如果系统上安装了 Adobe Acrobat(R) 6.0，并且在工具箱的“帮助”窗口中打开 PDF 文件，则在关闭 PDF 文件或切换至另一个主题时，“帮助”窗口可能会停止响应。如果发生此问题，则使用“任务管理器”来结束“帮助”应用程序，然后重新打开“帮助”窗口。
    4.0 声明

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

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

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

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

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

    5.0 商标

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

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

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

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

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

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

    6.0 第三方许可证

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

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