Voice Toolkit V5.0 for WebSphere Studio
安裝 ReadMe 檔

2004 年 4 月

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

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

 

內容

本文件包含下列安裝 Voice Toolkit for WebSphere(R) Studio 的相關主題。

 

簡介

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

  • VoiceXML 應用程式開發與除錯 包括： 整合開發環境 (IDE)；呼叫流程建置器，是一種圖形式編輯器； VoiceXML 編輯器；CCXML 編輯器；以及用來建立以 SRGS (XML 或 ABNF) 撰寫文法的編輯器。它也包括發音建置器、錄音程式以及一組 VoiceXML 可重複使用的對話框元件。
     
  • 語音 Portlet 應用程式開發與除錯 包括： 整合開發環境 (IDE)；呼叫流程建置器，是一種圖形式編輯器； VoiceXML 編輯器；CCXML 編輯器； 以及用來建立以 SRGS (XML 或 ABNF) 撰寫文法的編輯器。 它也包括發音建置器、錄音程式、一組 VoiceXML 可重複使用的對話框元件， 以及在語音入口網站伺服器上建立可部署 Portlet 所需的所有 Java 工具。
     
  • VisualAge for Java 轉換資訊 包括 WebSphere Voice Response Java 應用程式設計介面 (API)，取代了先前搭配 VisualAge for Java 使用的 JavaBeans 介面。它也包括音效區段、文件，以及教學。
     
  • 自然語言辨識 (NLU) 開發 「自然語言辨識」功能包括一個使用者介面，可將建立 NLU 模型之必要資料的匯入、編輯及匯出程序所需的技能與時間降到最少，以便與 NLU 應用程式搭配使用。

這個 Readme 檔 readme_install.html，位於 <WebSphere_Studio_dir>\VoiceToolkit\Readme 目錄， 其中 <WebSphere_Studio_dir> 是 WebSphere Studio 基本產品及版本號碼的完整路徑。 依預設，這個路徑是：

Program Files\IBM\WebSphere Studio\<基本產品的名稱，例如 Site Developer>\v5.1\

取得說明

如需使用「語音工具箱」的資訊，請參閱線上「說明」。 若要檢視「說明」，請在完成安裝之後，按一下說明功能表中的說明內容。出現「說明」視窗時，選取內容清單中的 VoiceXML 開發人員資訊。 您可以從「內容」清單檢視其他「語音工具箱」功能的「說明」。 其它的說明有：語音 Portlet 開發人員資訊；NLU 開發人員資訊及 VisualAge for Java 轉換資訊。

 

硬體需求

  • 適用於執行 Microsoft(R) Windows(R) 2000 或 Microsoft Windows XP 的系統。
  • 至少為 Intel(R) Pentium(R) 500 MHz 處理器或同等級的處理器。
  • 768 MB RAM。
  • 150 MB 的磁碟空間，加上可供選取安裝選項使用的其它空間。
  • 使用者 TMP 環境變數中指定的磁碟機上需要 150 MB 的暫時空間。
  • 顯示卡設定至少為 256 色，解析度至少為 800x600 (建議使用 1024x768 或更高的設定值)。

 

軟體需求

  • Microsoft Windows 2000 (Service Pack 4 或更高版本)，或 Microsoft Windows XP (Service Pack 1 或更高版本)。
  • 已安裝下列其中一種基本平台的版本：WebSphere Studio Site Developer V5.1.0、WebSphere Studio Application Developer V5.1.0 或 WebSphere Application Server-Express V5.1.0。

    如需詳細資訊，請參閱：
     http:\\www-106.ibm.com/developerworks/websphere/zones/studio/

    附註：
  • 如果您的 WebSphere Studio 產品是 5.0.1 版或更舊的版本，您應該將該版本解除安裝，然後再安裝 5.1.0 版。
     
  • 您可以在 5.1.1 版的 Studio 基本平台上安裝「語音工具箱」，但不支援「語音 Portlet 開發與除錯」功能。

    如果您在 5.1.1 基本平台上使用「語音 Portlet 開發與除錯」功能時遇到問題，您應該依序解除安裝「語音工具箱」及 Studio 5.1.1 基本平台。若要使用「語音 Portlet 開發與除錯」功能的支援版本，請先安裝 Studio 5.1.0 基本平台，再安裝「語音工具箱」。 
     

 

安裝

必備條件

「VoiceXML 應用程式開發與除錯」必備條件

  • 如果您已安裝任一舊版的 Voice Toolkit for WebSphere Studio、Voice Application Access Toolkit for WebSphere Studio 或 Multimodal Toolkit for WebSphere Studio，您必須先解除安裝舊版的產品，才能安裝這個版本的「語音工具箱」。
     
  • 如果您已安裝具有 TTS 的 IBM 產品，您必須先解除安裝該產品，才能安裝「語音工具箱」。
     
  • 您果您已安裝舊版的 WebSphere Voice Server SDK 或其他舊版的語音 Runtime 引擎，您必須先解除安裝這些產品，才能安裝這個版本的「語音工具箱」。 附註：您必須已安裝 JRE 1.3.1 才能解除安裝 SDK。

    解除安裝語音 Runtime 引擎之後，您可能必須手動刪除語音根目錄環境變數。若要執行此作業：
    1. 用滑鼠右鍵按一下「我的電腦」桌面圖示，並選取內容。
    2. 在「系統內容」對話框上，按一下進階欄標，然後按一下環境變數按鈕。
    3. 在「環境變數」視窗的「系統」變數下，捲動以尋找 SPCH_ROOT、SPCH_BIN 及 IBMVS 環境變數。選取這些變數，然後按一下刪除。
    4. 按一下確定以關閉對話框。
    5. 請重新啟動系統，讓變更生效。
  • 若要使用「呼叫流程建置器」工具，請將顯示設定設定為「小型字」。
    • 若要在 Windows 2000 中設定您的顯示設定，請按一下開始，指向設定，按一下控制台，然後選取「顯示」。在「顯示內容」對話框中，選取設定值欄標，再按一下進階。在「字型大小」框中，選取小型字。
       
    • 若要在 Windows XP 中設定您的顯示設定，請按一下開始，再按一下控制台，然後選取顯示。在「顯示內容」對話框中，選取外觀欄標，再選取最小的字型，標準。
       

「語音 Portlet 應用程式開發與除錯」必備條件

  •  如果您打算在本端測試環境中進行除錯與測試語音 Portlet，則必須使用短路徑名稱來安裝 WebSphere Studio 基本產品。同時，您也需要安裝其它的程式，包括：
    • Portlet Toolkit V5.0.2 for WebSphere Studio
    • WebSphere Portal V5.0.2 CD #2
    • Voice Aggregator，是 WebSphere Voice Application Access 的套裝軟體

    如需開發與測試語音 Portlet 所需之軟體需求的詳細資料，請參閱開發語音 Portlet 應用程式入門。

「自然語言辨識 (NLU) 開發」必備條件

  • 若要使用 NLU 功能，您必須安裝 (最小安裝) DB2(R) 8.1 Runtime Client。如需詳細資訊，請參閱開發與建置自然語言模型入門手冊。

安裝「語音工具箱」

  • 如果系統資源不足，您可能會注意到進度指示器與第一個安裝畫面之間有延遲。
     
  • 在安裝期間發生的錯誤，會記錄在 voicetools_log.txt 檔案中，該檔案位於由 TMP 環境變數所識別的目錄位置中。
     
  • 啟動安裝程序之後，取消按鈕就會變成沒有回應，您必須按該按鈕數次，它才會重新出現。
     
  • 安裝程序可能需要從網際網路網站下載其他檔案。 請確定系統已配置網際網路連線功能，讓「安裝精靈」能存取下列網站：
    http://www3.software.ibm.com/ibmdl/pub/software/websphere/voicetoolkit
     
  • 如果您在 Windows 2000 系統上正進行安裝作業，並於安裝期間接到一則警告，表示您的 PATH 變數太大 (此變數上限為 1024 個字元)，請使用下列步驟移除路徑變數中重複的路徑：
  1.  用滑鼠右鍵按一下桌面上的我的電腦，再選取內容。
  2. 在「系統內容」視窗，按一下進階欄標。
  3. 按一下環境變數，以開啟「環境變數」對話框。
  4. 在系統變數下選取 Path 變數，再按一下編輯。隨即顯示「編輯系統變數」對話框。
  5. 在變數值欄位，移除重複的路徑。若要這麼做，請尋找分號 (;)，其為路徑之間的分隔字元。如果路徑重複，請將該路徑移除，再按一下確定。
    附註：  為方便編輯，您可以將欄位中的變數資訊複製到「記事本」中，然後在移除重複路徑之後，再把變數內容貼回「變數值」欄位。
  6. 在「環境變數」對話框中，按一下確定。隨即顯示系統內容對話框。
  7. 按一下確定，繼續進行安裝作業。
  • 在安裝期間下載檔案時，會將檔案解壓縮到 TMP 變數所指定的 Temp 目錄中的 Voice Toolkit 資料夾。 這些檔案是安裝程序的必要項目，如果您不打算再重新安裝，則在安裝作業結束之後可以將這些檔案移除。如果您可能會再重新安裝，則可將執行檔 (Voicetools_Setup.exe) 加入檔案所在的目錄，以保存檔案與執行檔，或將這些檔案複製到 CD。 那麼，如果您決定稍後再安裝其它功能或語音技術，即可使用執行檔自動連接到網際網路下載網站，以存取必要的檔案。
     
  • 請遵循「安裝精靈」的指示來安裝「語音工具箱」。
    「安裝精靈」會將檔案複製到下列目錄結構：
          <WebSphere_Studio_dir>\
               eclipse - features、plugins
               VoiceToolkit - jvm、license、Readme、Samples、uninstall
     

安裝語音技術

請使用「安裝精靈」來安裝您所安裝之各種功能的語言 (語音技術)： 「VoiceXML 應用程式開發與除錯」、「語音 Portlet 應用程式開發與除錯」或「VisualAge for Java 轉換」。 您必須為每種功能至少選取一種語音技術。 如果您選取兩種功能共用的語音技術，則會為這兩種功能選取與安裝該語音技術。

若要安裝 CTTS 語音技術 (最高需要 700 MB)，您將會在安裝期間自動連接到下載網站。 請注意，每種語言只能安裝一組引擎 (TTS 或 CTTS)。如果您為同一種語言選取 TTS 與 CTTS 語音技術，則只會安裝與使用 CTTS 引擎。 那麼，如果您要使用 TTS 引擎，就必須重新安裝 TTS 語音技術，而這樣會自動解除安裝 CTTS。

您隨時可以安裝其他「語音技術」。若要這麼做，請使用 Voicetools_Setup.exe 再次執行「安裝精靈」。在功能畫面上按一下 「下一步」，並在語音技術畫面上，選取要安裝的新語言。

啟用語音工具

完成「語音工具箱」安裝之後，必須使用「更新管理程式」，在 WebSphere Studio 開發環境中啟用「語音工具」：

  • 根據您的開發環境，啟動下列其中一項： WebSphere Studio Site Developer V5.1.0、WebSphere Studio Application Developer V5.1.0 或 WebSphere Application Server-Express V5.1.0。
     
  • 如果出現「更新管理程式」蹦現視窗 (如果您在安裝工具箱之前曾經使用 WebSphere Studio 開發平台，就會出現此視窗)，請接受所有變更。「更新管理程式」只是用來確認要將工具箱外掛程式新增到 WebSphere Studio。
     
  • 如果未出現「更新管理程式」蹦現視窗，請從說明功能表指向軟體更新，再按一下擱置變更。 選取所有列示功能的勾選框，然後再按一下完成。
     
  • 如果您是從前版的「語音工具箱」升級， 則請重設視景，以確保新工具的更新可以使用。 若要這麼做，請先確定開啟「語音」視景；從「視窗」功能表指向開啟視景，再按一下語音。接著，請重設視景，從「視窗」功能表按一下重新設定視景。

 

入門

若要啟動「語音工具箱」，請從工作列按一下開始按鈕，再依序指向程式 (在 Windows XP 中，請指向所有程式) 及 IBM WebSphere Studio。接著，按一下您的基本產品，例如 Site Developer 5.1 或 Application Developer 5.1。

  • 安裝這些工具並啟動 WebSphere Studio 之後，如果可開啟的可用視景清單中沒有「語音」視景， 則請在「更新管理程式」中啟動新功能。若要這麼做，請從說明功能表指向軟體更新，再按一下擱置變更。選取每個列示功能的勾選框，然後再按一下完成。此動作會確認將工具箱外掛程式新增到 WebSphere Studio。
     
  • 若要檢視「歡迎使用」頁面，請從說明功能表，按一下歡迎使用， 再選取語音 Portlet 工具或 Voice Toolkit for WebSphere Studio。 其中包含了可協助您使用工具箱的相關資訊。「歡迎使用」頁面包含的連結可讓您取得更詳細的「入門」資訊。 您也可以在「說明」視窗的「內容」清單中找到「入門」資訊，以取得「語音 Portlet」開發人員資訊或 VoiceXML 開發人員資訊。若要從「說明」功能表存取「歡迎使用」頁面，請按一下「說明內容」，然後再選取「語音 Portlet」開發人員資訊或 VoiceXML 開發人員資訊。
     
  • 您使用「語音工具箱」建立的專案與檔案，會儲存在您開啟 WebSphere Studio 時所選取的工作區位置中。 如果您解除安裝「語音工具箱」，工作區仍會保留在系統中，因此可以繼續使用那些檔案。
     
  • 解除安裝「語音工具箱」時，會刪除儲存在下列目錄中的檔案。 如果您在這些目錄中建立檔案，請在解除安裝「語音工具箱」之前，將它們複製到另一個資料夾：
     

    •     <WebSphere_Studio_dir>/eclipse/plugins/com.ibm.voicetools.engines.wvs_5.0.0

    •     <WebSphere_Studio_dir>/eclipse/features/com.ibm.wpstools_5.0.0

    •     <WebSphere_Studio_dir>/eclipse/plugins/com.ibm.voicetools.browser.wvrsim_5.0.0

    •      <WebSphere_Studio_dir>/eclipse/logs
       

  • 除了工具箱說明之外，這個套件也包括某些相關書籍。 若要檢視或列印這些書籍，您必須使用 Adobe(R) Reader(R) 4.0.5 版或以上版本。若要取得最佳的檢視效果，請使用 Adobe Reader 6.0 版。

    若要下載 Adobe Reader，請跳到 Adobe 網站：www.adobe.com。按一下 Get Adobe Reader，並遵循指示。
     
  • 若要使用 NLU 功能，請遵循這些指示：
     
    • 公佈安裝指示：
      每一個安裝都必須有一個 TCL 8.4.x 與 LibXML 2.5.10 或更高版本的複本。 這些程式庫都是開放原始碼，可從下列網站取得：
      •  http://www.tcl.tk (TCL 8.4.x)
      • http://www.xmlsoft.org (LibXML 2.5.10)

      這兩個網站都提供原始碼以及二進位檔下載功能。下載之前，請先檢視各網站可用的授權合約。
       

    • TCL 8.4.x 安裝資訊：
      從 ActiveState TCL 安裝二進位檔安裝 TCL 8.4.x：
           http://aspn.activestate.com/ASPN/Downloads/ActiveTcl
      請使用下列選項：
      • 為所有使用者安裝 (需要管理專用權)
      • 檢查兩者的登錄設定選項

      如果您不使用 activeState 安裝，請確定 tclsh84.exe 所在的目錄在您的路徑中。
       

    • LibXML 2.5.10 安裝資訊： 
      您可從 LibXML 2.5.10 網站建置開放原始碼，或是從下列網站下載 Windows 二進位檔：
             http://www.zlatkovic.com/libxml.en.html
      接著，遵循這些指示：
      1. 選取「下載」以到達程式庫位置

      2. 從這個網站下載下列三個 zip 檔：
              iconv-1.9.1.win32zip
              libxml2-2.6.2.win32.zip
              zlib-1.1.4.win32.zip

      您只需要每個 zip 檔中的一個檔案：分別是 iconv.dll、libxml2.dll 及 zlib.dll。 這三個檔案應放置於「NLU 工具」外掛程式的下列目錄中：
                   <WebSphere_Studio_dir>\eclipse\plugins\com.ibm.nlutools.utilities\bin

      如果找不到這個目錄，請在 Windows「檔案總管」中搜尋位於該目錄的其他檔案，例如 actrain.tcl、buildne.bat 或 nltrain.bat。

      附註：如果您決定編譯自己的 libxml2.dll，則不需要設定編譯器選項將 iconv 與 zlib 程式庫相依關係新增到程式庫中。只有這個經過前置編譯的程式庫需要這些項目，我們的 Runtime 並不使用。

 

已知的問題

  • 安裝「語音工具箱」之前，您必須解除安裝包含 IBM TTS 的任何產品。 如果您已經解除安裝這些 IBM TTS 產品，但是安裝「語音工具箱」時仍然看到錯誤訊息 「發現 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.  重試「語音工具箱」安裝。
  • 在安裝期間您可能會接收到一則「未經處理的異常」錯誤訊息，指出將立即終止「安裝程式」。如果您接收到這個訊息，請按一下「確定」再解除安裝這個程式。關閉系統中的所有執行應用程式，再嘗試重新安裝這個程式。
     
  • 部份安裝 TTS/CTTS 可能會產生「嚴重失敗」錯誤訊息。關閉系統中的所有執行應用程式，再嘗試重新安裝這個程式。
     
  • 如果您已安裝 Windows XP 及其 Service Pack 1，且已套用 Windows XP Hotfix Q328310，可能會在安裝期間發現一則「InstallShield Ikernel 應用程式錯誤」。如果這發生於安裝「語音工具箱」時，您可以在下列網址找到問題的解決方法：
    http://support.installshield.com/kb/view.asp?articleid=q108020
     
  • 麥克風會從您的電腦喇叭挑選輸出，並將該輸出解讀為符合文法規則的文字。 若要避免這個動作，請關閉喇叭音量，或使用頭戴式麥克風。

 

解除安裝

解除安裝「語音工具箱」

  • 若要解除安裝這個產品，請執行「新增/移除程式」公用程式：

    • 若要在 Windows 2000 中解除安裝這個產品，請按一下開始，指向設定，按一下控制台，然後選取新增/移除程式。 選取 Voice Toolkit for WebSphere Studio 程式。按一下變更/移除，再遵循「解除安裝精靈」的指示。
       
    • 若要在 Windows XP 中解除安裝這個產品，請按一下開始，再按一下控制台，然後再選取新增或移除程式。 選取 Voice Toolkit for WebSphere Studio 程式。按一下變更/移除，再遵循「解除安裝精靈」的指示。
  • 解除安裝一或多個「語音工具箱」功能之後，您應該先關閉 WebSphere Studio 再重新啟動它，以重設功能清單與配置，然後才能重新安裝一或多個「語音工具箱」功能。
     
  • 如果您要在您安裝或更新的新版工具箱中，使用已修改的「可重複使用的對話框元件」， 請更名已修改的對話框元件，並在安裝新版本之後，將它們複製到已更新的目錄，例如：

    <WebSphere_Studio_dir>\eclipse\plugins\com.ibm.voicetools.rdc_5.0.0\resuable_comp\XML\subdialogs\<subdialog_name>

解除安裝語音技術

在「語音工具箱」的「解除安裝精靈」中，選取要解除安裝的語音技術。 請注意，您必須為每種已安裝的功能至少保留一種已安裝的語音技術。 您可能必須先安裝第二種語音技術，才能才能解除安裝第一種語音技術。

解除安裝失敗

如果您試圖解除安裝工具箱，則在非常罕見的情況下 (例如在解除安裝工具箱之前，先解除安裝 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

此時，您可以手動移除由工具箱安裝的其餘資料夾與檔案。

 

注意事項

下列段落若與該國之法律條款抵觸，即視為不適用：

IBM 僅以「現狀」提供本書，而不提供任何明示或默示之保證 (包括但不限於可售性或符合特定效用的保證)。 若有些地區在某些交易上並不允許排除上述保證，則該排除無效。

本資訊中可能會有技術上或排版印刷上的訛誤。因此，IBM 會定期修訂； 並將修訂後的內容納入新版中。同時，IBM 得隨時改進並 (或) 變動本書中所提及的產品及 (或) 程式。

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

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

 

商標

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

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

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

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

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

 

協力廠商授權

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

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