Voice Toolkit V4.2.2 for WebSphere(R) Studio
安裝 ReadMe 檔

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.

附註：使用此資訊及其支援的產品之前，請先閱讀本文件中「注意事項」之下的一般資訊。

本安裝 ReadMe 檔分成下列各節：

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 工具箱更新。 請改而使用安裝精靈。

本 ReadMe 檔提供有關安裝 Voice Toolkit for WebSphere Studio 的資訊，它包括下列功能：

  • VoiceXML 應用程式開發與除錯--包括整合式開發環境 (IDE)、 VoiceXML 編輯器，以及用來建立以 SRGS (XML 或 ABNF) 來撰寫文法的編輯器。 它也包括發音建置器、錄音程式以及一組 VoiceXML 可重複使用的對話框元件。

  • 語音 Portlet 應用程式開發與除錯--包括整合式開發環境 (IDE)、 VoiceXML 編輯器，以及用來建立以 SRGS (XML 或 ABNF) 來撰寫文法的編輯器。 它也包括發音建置器、錄音程式、一組 VoiceXML 可重複使用的對話框元件， 以及在語音入口網站伺服器上建立可部署 Portlet 所需的所有 Java 工具。

  • VisualAge for Java 轉換資訊--包括 WebSphere Voice Response Java 應用程式設計介面 (API)， 它取代了先前搭配 VisualAge for Java 使用的 JavaBeans 介面。它也包括音效區段、文件，以及教學。

如需使用 Voice Toolkit 的資訊，請參閱線上說明。 若要檢視說明，請在完成安裝之後，按一下「說明」功能表中的「說明內容」。 出現「說明」視窗時，按一下「內容」清單中的「語音工具」。

若要檢視「語音 Portlet 工具」功能的說明，請按一下「內容」清單中的「語音 Portlet 工具」。

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 或其他舊版的語音 Runtime 引擎，您必須先解除安裝這些產品 (使用「控制台」上的「新增/移除程式」選項)， 才能安裝這個版本的 Voice Toolkit。 附註：您必須安裝 JRE 1.3.1 才能解除安裝 SDK。

    • 解除安裝語音 Runtime 引擎之後，您可能必須手動刪除語音根目錄環境變數。若要執行此作業：

    1. 用滑鼠右鍵按一下「我的電腦」桌面圖示，並選取「內容」。

    2. 在「系統內容」對話框上，按一下「進階」欄標，然後按一下「環境變數」按鈕。

    3. 在「系統變數」視窗中，捲動以尋找 SPCH_ROOT 與 SPCH_BIN 變數。 選取它們，然後按一下「刪除」。

    4. 按一下「確定」以關閉對話框。

    5. 請重新啟動系統，讓變更生效。

4.2 安裝 Voice Toolkit
  • 如果是從 CD 進行安裝，且 autorun 沒有自動執行，則請執行 Voicetools_Setup.exe 以啟動「安裝精靈」。

  • 如果是從網際網路下載來進行安裝，請執行 Voicetools_Setup.exe (位於其下載目錄中) 以啟動「安裝精靈」。

  • 不支援網路安裝。如果您透過網路從共用映像檔來安裝， 則安裝 TTS/CTTS 部分時可能會產生 "Catastrophic Failure" 錯誤訊息。

  • 如果系統資源不足，您可能會注意到進度指示器與第一個安裝畫面之間有延遲。

  • 在安裝期間發生的錯誤，會記錄在 voicetools_log.txt 檔案中，該檔案位於由 TMP 環境變數所識別的目錄位置中。

  • 啟動安裝程序之後，取消按鈕就會變成沒有回應，您必須按該按鈕數次，它才會重新出現。

  • 安裝程序可能需要從網際網路網站下載其他檔案。 請確定系統已配置網際網路連線功能，這樣「安裝精靈」才能存取下列網站：

    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 - features、plugins
    VoiceToolkit - jvm、license、Readme、Samples、uninstall

4.3 安裝語音技術

請使用「安裝精靈」來安裝您安裝之每種功能的語言 (語音技術)： 「VoiceXML 應用程式開發與除錯」、「語音 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 升級， 則請重設視景，以確保新工具的更新可以使用。 若要執行此作業，請從 Window 功能表按一下「重新設定視景」。

5.0 入門

若要啟動 Voice Toolkit，請在 Windows「開始」功能表中，選取「程式集」 > IBM WebSphere Studio > [您的基礎產品] (例如 Site Developer 5.0 或 Application Developer 5.0)。

  • 安裝這些工具與啟動 WebSphere Studio 之後，如果可開啟的可用視景清單中沒有「語音」視景， 則您應該在「更新管理程式」(「說明」>「軟體更新」>「擱置變更」) 中啟動新功能。 選取每個已列出之功能的勾選框，然後按一下「完成」按鈕。 此動作會確認將工具集外掛程式新增到 WebSphere Studio。

  • 「歡迎使用」畫面 (「說明」>「歡迎使用」>「語音 Portlet 工具」或 Voice Toolkit for WebSphere Studio) 包含的資訊，可協助您開始使用工具集。「歡迎使用」畫面也包含連結，可用來取得更詳細的「入門」資訊。 您也可以在「說明」視窗的「內容」清單中，找到「入門」資訊 (按一下「說明」功能表中的「說明內容」， 然後選取「語音 Portlet 工具」或「語音工具」)。

  • 您使用 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) 4.0.5 版或以上版本。若要取得最佳的檢視效果，請使用 Adobe Reader 6.0 版。

    若要下載 Adobe Reader，請跳到 Adobe 網站：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 功能之後，您應該先關閉 WebSphere Studio 再重新啟動它， 以重設功能清單與配置，然後才能重新安裝一或多個 Voice Toolkit 功能。

  • 如果您要在您安裝或更新的新版工具集中，使用已修改的「可重複使用的對話框元件」， 請更名已修改的對話框元件，並在安裝新版本之後，將它們複製到已更新的目錄，例如：

    <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 會定期修訂； 並將修訂後的內容納入新版中。同時，IBM 得隨時改進並 (或) 變動本書中所提及的產品及 (或) 程式。

本資訊中任何對非 IBM 網站的敘述僅供參考，IBM 對該網站並不提供保證。 該網站上的資料，並非本 IBM 產品所用資料的一部分，如因使用該網站而造成損害，其責任由 貴客戶自行負責。

本書所提及之非 IBM 產品資訊，係一由產品的供應商，或其出版的聲明或其他公開管道取得。IBM 並未測試過這些產品，也無法確認這些非 IBM 產品的執行效能、 相容性、或任何對產品的其他主張是否完全無誤。如果您對非 IBM 產品的性能有任何的疑問，請逕向該產品的供應商查詢。

9.0 商標

下列專有名詞是「國際商業機器股份有限公司 (IBM)」在美國及/或其他國家的商標或註冊商標：
   IBM
   WebSphere

Intel 及 Pentium 是 Intel Corporation 在美國及/或其他國家的商標或註冊商標。

Microsoft 及 Windows 是 Microsoft Corporation 在美國及/或其他國家的商標。

Java 和所有以 Java 為基礎的商標和標誌是 Sun Microsystems, Inc. 在美國和/或其他國家的商標或註冊商標。

Adobe、Acrobat 及 Reader 是 Adobe Corporation 在美國及/或其他國家的商標或註冊商標。

其他公司、產品及服務名稱，可能是其他公司的商標或服務標記。

10.0 協力廠商授權

本程式包括協力廠商元件，它們以下列為依據：

縱使 貴客戶與 IBM 或與 IBM 相關之公司或關係企業 (以下統稱 IBM) 之其他合約中另有規定， 下列條款仍適用於本節中指明的所有「協力廠商元件」，或是本產品之「授權」資訊文件中的其他項目： (a) 所有協力廠商元件均以「現狀」提供；(b) IBM 不提供任何明示及默示之保證與條件， 其中包括 (但不限於) 非侵權或干擾之保證，以及針對特殊目的之可售性和適用性的默示保證與條件； (c) 凡與協力廠商元件相關之任何要求，IBM 均不負有任何保證或賠償的責任； (d) 凡與協力廠商元件相關之任何直接、間接、附帶、特殊、懲罰性或衍生之損害，IBM 概不負責。