Voice Toolkit V5.0 for WebSphere Studio
Readme

2004년 4월

주: 이 정보 및 지원 제품을 사용하기 전에 이 문서의 주의사항에 있는 일반 정보를 읽으십시오.

소개

readme는 다음 기능에 대해 알려진 문제점 및 수정사항에 관한 정보를 제공합니다.

VoiceXML 응용프로그램 개발 및 디버그
음성 포틀렛 응용프로그램 개발 및 디버그
VisualAge for Java 변환 정보
NLU(Natural Language Understanding) 개발

Voice Toolkit 사용에 대한 정보는 온라인 도움말을 참조하십시오. 도움말 메뉴에서, 도움말 목차를 클릭하십시오. 도움말 창이 나타나면, 목차에서 다음 기능 중 하나를 선택하십시오.

VoiceXML 개발자 정보
음성 포틀렛 개발자 정보
NLU 개발자 정보
VisualAge for Java 변환 정보

이 readme 파일은 readme_vt.html이며, 이는 <WebSphere_Studio_dir>\VoiceToolkit\Readme 디렉토리에 위치합니다. (여기서 <WebSphere_Studio_dir>은 WebSphere Studio 기본 제품 및 버전 번호의 전체 경로입니다.) 기본적으로 이 경로는 다음과 같습니다.

Program Files\IBM\WebSphere Studio\<기본 제품 이름(예:Site Developer)>\v5.1\

시작하기

Voice Toolkit을 실행하려면, 작업 표시줄에서 시작 단추를 클릭하고 프로그램에서, IBM WebSphere Studio를 지시하십시오. 그런 다음, Site Developer 5.1 또는 Application Developer 5.1과 같은 기본 제품을 클릭하십시오.

WebSphere Studio 제품의 버전이 5.0.1 이하인 경우, 이를 설치 제거한 후 버전 5.1.0을 설치해야 합니다.
추가 정보는 다음을 참조하십시오.
www7b.software.ibm.com/wsdd/zones/studio/
이러한 도구를 설치하고 WebSphere Studio를 실행한 후, Voice, 자연어 또는 음성 포틀렛 Perspective가 열 수 있는 사용 가능한 Perspective 목록에 없는 경우에는 갱신 관리자에서 새 기능을 활성화시켜야 합니다. 이를 수행하려면, 도움말 메뉴에서 소프트웨어 갱신을 지시하고 변경 보류를 클릭하십시오. 나열된 각 기능에 대한 선택란을 선택한 다음, 완료를 클릭하십시오. 이 조치는 WebSphere Studio에 툴킷 플러그인 추가를 확인합니다.
환영 페이지를 보려면, 도움말 메뉴에서 환영을 클릭하고 VoiceXML 응용프로그램 개발 및 디버그 기능, 음성 포틀렛 개발 응용프로그램 및 디버그 기능 또는 NLU(Natural Language Understanding) 개발 기능 중 하나를 선택하십시오. 툴킷으로 작업을 시작하는 데 도움이 되는 정보가 나타납니다.

환영 페이지에는 자세한 시작하기 정보에 대한 링크가 포함되어 있습니다. VoiceXML 개발자 정보, 음성 포틀렛 개발자 정보 또는 NLU 개발자 정보에 대해 도움말 창의 목차에서 시작하기 정보를 찾을 수도 있습니다. 환영 페이지에 액세스하려면, 도움말 메뉴에서 도움말 목차를 클릭하십시오.
이 패키지에는 툴킷 도움말 외에 특정 관련 서적이 포함됩니다. 이러한 서적을 보거나 인쇄하려면, Adobe^(R) Reader^(R) 버전 4.0.5 이상을 사용해야 합니다. 보기를 최적화하려면 Adobe Reader 버전 6.0을 사용하십시오.

Adobe Reader를 다운로드하려면 Adobe 웹 사이트(www.adobe.com)로 이동하십시오. Get Adobe Reader를 클릭하고 지시사항을 따르십시오.

알려진 문제점

일반

일부 구성에서, 하나 이상의 javaw.exe 프로세스가 툴킷을 종료한 후(특히, 프로그램의 비정상 종료 후)에도 계속해서 실행될 수 있습니다. Windows 작업 관리자를 사용하여 이와 같은 비정상 프로세스를 찾아 종료하십시오.
프로그램이 응답하지 않을 경우, WebSphere Studio를 닫고 모든 javaw.exe 프로세스를 닫아야 합니다. 이에 실패할 경우, 컴퓨터를 다시 시동하십시오.
Voice Toolkit을 사용하여 작성하는 프로젝트 및 파일은 WebSphere Studio를 열 때 선택하는 작업공간 위치에 저장됩니다. Voice Toolkit을 설치 제거해도 작업공간은 시스템에 그대로 남아 있어 파일을 계속 사용할 수 있습니다.
다음 디렉토리에 저장되는 파일은 Voice Toolkit을 설치 제거할 때 삭제됩니다. 이 디렉토리에 파일을 작성하는 경우 Voice Toolkit을 설치 제거하기 전에 다른 폴더에 복사하십시오.
- <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
Workbench 또는 Workbench > 모양 환경 설정을 변경하는 경우, 기본값 복원 단추가 원래의 기본값을 복원하지 않을 수 있습니다. 또한, 변경사항이 효력을 발휘하도록 WebSphere Studio를 종료한 후 다시 시작해야 할 수도 있습니다.
"내부 오류 - 위지트(Widget) 배치" 오류 메시지가 발생한 경우, WebSphere Studio를 닫고 다시 시작하여 오류를 복구하십시오.
디렉토리, 폴더 및 파일 이름에 영숫자 문자 및 공백만을 사용해야 합니다. 이름에 영숫자가 아닌 문자(예: ~!@#$%^&*)가 포함되서는 안됩니다.
WebSphere Studio와 함께 패키지된 JRE에서 지원하는 알려진 Java 사운드 문제로 인해서 음성 툴킷에 포함된 기본 오디오 레코더가 USB 마이크를 지원하지 않습니다.
네트워크 자원으로부터 파일을 가져오거나 사용하려면 드라이브 이름을 해당 네트워크 자원에 맵하고 해당 네트워크 드라이브로부터 가져오십시오.
컴퓨터에서 개인용 방화벽 소프트웨어를 사용 중일 경우 VoiceXML 응용프로그램 실행 시 문제점이 발생할 수도 있습니다. "호스트 관리자가 제대로 초기화되지 않았습니다"와 같은 오류 메시지가 나타날 경우, 방화벽을 사용 불가능하게 한 후 다시 VoiceXML 응용프로그램 실행을 시도하십시오.

언어별 고려사항

비IBM 텍스트를 음성으로 변환(TTS) 언어를 음성 응용프로그램 서버(예: WebSphere Voice Server)에 사용하도록 설치를 선택한 경우, 벤더의 VoiceXML 2.0 및 SSML(Speech Synthesis Markup Language) 구현에 관한 자세한 사항을 위해 벤더의 문서를 참조해야 합니다. 또한 다른 벤더의 언어를 사용하는 경우, 벤더의 도구를 사용하여 발음을 생성해야 합니다. TTS 출력의 SSML을 생성하기 위해 IBM 도구를 사용하는 경우, 결과 코드가 해당 언어의 전개 환경에서 예상대로 실행되지 않을 수도 있습니다.
툴킷에 패키지된 VoiceXML Programmer's Guide (pgmguide.pdf)에는 SSML의 음소 태그에서 지원하는 영문자에 대한 올바르지 않은 정보가 들어 있습니다. 안내서를 보려면, 도움말 메뉴에서 도움말 목차를 클릭한 후 VoiceXML 개발자 정보 또는 음성 포틀렛 개발자 정보 중 하나를 선택하십시오. 목차에서 관련 문서를 선택하십시오. 갱신된 정보를 보려면 관련 문서에 있는 IBM Text-to-Speech SSML Programming Guide (tts_ssml.pdf)를 참조하십시오.
DBCS 문자를 사용하여 프로젝트 이름을 작성하지 마십시오. 그런 경우, 유효성 검증 오류가 발생하며 XML 파일이 유효성 검증되지 않습니다.
알 수 없는 발음 보기를 사용하는 경우, 광둥어 단어는 "알 수 없음"으로 플래그됩니다. 도구의 올바른 광둥어 기능을 위해 Windows 지역 설정이 "중국어-홍콩"이 아니라 "중국어-대만"으로 되어 있어야 합니다. 음성 도구 환경 설정에서 음성 언어를 변경하는 경우, 변경사항이 효력을 발휘하도록 WebSphere Studio을 종료해야 합니다.

음성 인식 테스트 도구

음성 인식 테스트 도구를 실행하려면 유니코드 형식으로 스크립트 파일을 저장하지 마십시오. 스크립트 파일을 유니코드 형식으로 저장하려는 경우, 결과 대화 상자가 "스크립트 평가 오류!" 메시지를 표시합니다. 유니코드 모드 사용 선택란의 선택 여부에 상관없이 이 오류가 발생합니다. 이 문제를 수정하려면 스크립트 파일을 유니코드 형식으로 저장하지 않도록 하고 유니코드 모드 사용 선택란을 선택하십시오.
음성 인식 테스트 도구를 사용하고 스크립트 파일에 오디오(.ulw) 또는 문법(.fsg) 파일 이름에 대한 DBCS 문자가 들어 있는 경우, 유니코드 모드 사용 선택란을 선택해야 합니다. 유니코드 모드 사용 선택란을 선택하지 않으면 결과가 표시되지 않습니다.
음성 인식 테스트 도구를 실행하고 인식될 텍스트 구문에 DBCS 문자가 있으면 유니코드 모드 선택란 사용을 선택하십시오. 선택란을 선택하지 않으면 결과가 표시되지 않습니다.

편집기

대형 VoiceXML 파일에서 텍스트를 선택하는 경우, 강조표시하는 데 몇 초가 걸립니다.
편집기에서 파일을 열고 마지막 저장 후에 파일에 변경한 모든 사항을 실행 취소하면 파일은 원래 상태로 돌아간 후에도 여전히 변경사항이 보류 중인 것으로 간주합니다.
일부 구성에서, VoiceXML 응용프로그램을 실행 또는 디버그한 다음 발음을 확인하는 데 문제가 발생할 수도 있습니다. 이런 경우, WebSphere Studio를 닫고 javaw.exe 및 engine.exe 프로세스를 종료한 다음 WebSphere Studio를 다시 시작하십시오. Windows 작업 관리자를 사용하여 이와 같은 비정상 프로세스를 찾아 종료하십시오.
유효성 검증을 전달하려면, VoiceXML 문서에 최소한 하나의 VXML 하위 요소가 있어야 합니다.
VoiceXML 편집기에서 문서 정리 기능을 사용 중일 경우, JSV 파일에서 오류가 작성될 수 있습니다. 이는 불필요한 명령문 닫기(>)가 파일에 삽입되어서 발생합니다. 오류를 정정하려면, 불필요한 명령문을 삭제하십시오.
VoiceXML 편집기 또는 SRGS XML 문법 편집기에서 긴 행의 텍스트(예: 수천자 길이의 행)에 문제가 발생할 수 있습니다. 일부 경우에는 WebSphere Studio가 정지될 수 있습니다. 이런 경우, WebSphere Studio를 종료하고 다시 시작하십시오.

WebSphere Studio에서 기본 텍스트 편집기(파일 > 열기 도구 또는 컨텍스트 메뉴에서 열기 도구)로 파일을 열어 긴 행을 짧은 행으로 나누십시오. 그런 다음 저장하고 VoiceXML 또는 SRGS XML 편집기에서 파일을 다시 여십시오.
SRGS 및 JSGF 문법 편집기에서 규칙이 정의되었으나 사용하지 않으면 경고가 생성되지 않습니다.
행 정보 없이 구문 오류 "판별할 수 없는 오류가 이 문법의 SISR에 존재합니다"가 발생한 경우 SRGS XML 또는 ABNF 문법에서 유효하지 않은 SISR 구문의 사용이 원인일 수 있습니다. 이 오류는 SISR 오브젝트를 선언하고 해당 오브젝트의 선언되지 않은 하위 오브젝트를 참조한 경우, 문법 또는 VoiceXML 편집기에서 발생할 수 있습니다.
WebSphere Studio에서 편집기를 닫은 다음 파일을 삭제할 수 있게 되기까지 시간이 걸릴 수도 있습니다.
SRGS XML 문법 편집기로 작업할 경우, 동일한 오류에 대해 두 개의 메시지가 타스크 보기에 표시됩니다. SRGS XML 편집기에서 XML 구문 분석을 사용하지 않으려면, 다음 단계를 따르십시오.

네비게이터 보기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 컨텍스트 메뉴에서 특성을 클릭하십시오.

특성 대화 상자에서, 유효성 검증을 선택하십시오. 유효성 검증 환경 설정 겹쳐쓰기 선택란도 선택하고 SRGS XML 양식 환경 설정 선택란을 지우십시오.

적용을 클릭한 다음, 확인을 클릭하십시오.

참고: SRGS XML 편집기 컴파일러는 꺼지지만 컴파일러 XML 유효성 검증은 여전히 나타납니다.

호출 플로우 빌더

Voice Toolkit Technical Preview 응용프로그램으로 작성한 파일이 현재 버전인 Voice Toolkit V5.0에서 제대로 열리지 않습니다.

VoiceXML 테스트 및 디버그

VoiceXML 브라우저가 DTD의 HTTP URI를 지정하는 문서를 로드하고 DTD가 페치될 수 없는 경우(예: 네트워크 또는 인터넷에서 연결이 끊긴 경우) 실행 또는 디버그 중인 VoiceXML 응용프로그램이 종료됩니다.
실행 메뉴 사용 시 실행 하위 메뉴가 누락된 경우, 실행 도구 모음 아이콘을 사용하여 드롭 다운 목록을 여십시오.
VoiceXML 응용프로그램의 디버그 시, 눈금자 막대에서 두 번 누르기로 중단점이 추가되지 않습니다. 중단점을 추가하려면 눈금자 막대에서 마우스 오른쪽 단추를 누르고 중단점 추가를 선택하십시오.

NLU(Natural Language Understanding) 기능

모델 빌드 도구를 실행할 때 문제점이 발생하면, NLU 개발자 정보의 시작하기 섹션에 나와 있는 지시사항을 따랐는지 확인하십시오. 모델 빌드 도구가 실행되기 전에 Tcl 2진 및 libxml2.dll 2진 패키지를 다운로드하여 설치해야 합니다. libxml2.dll 2진 패키지는 세 개의 파일(libxml2.dll, iconv.dll 및 zlib.dll)로 구성되어 있습니다.

Voice Toolkit 문서

시스템에 Adobe Acrobat 6.0이 설치되어 있고 툴킷 도움말 창에서 PDF 파일을 여는 경우, PDF 파일을 닫거나 다른 주제로 변경하는 경우 도움말 창이 응답하지 않을 수도 있습니다. 이런 경우, 작업 관리자를 사용하여 도움말 응용프로그램을 닫은 다음 도움말 창을 다시 여십시오.

음성 포틀렛 테스트 및 디버그

로컬 테스트 환경에서 음성 포틀렛을 디버그 및 테스트하려는 경우, WebSphere Studio 기본 제품이 간략한 경로 이름으로 설치되어야 합니다. 추가 프로그램도 설치해야 합니다. 음성 포틀렛 개발 및 테스트를 위해 필요한 소프트웨어 전제조건에 대한 자세한 내용은 Getting started with developing voice portlet applications를 참조하십시오.

주의사항

다음 단락은 현지법과 상충하는 영국이나 기타 국가에서는 적용되지 않습니다.

IBM은 타인의 권리 비침해, 상품성 및 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여(단, 이에 한하지 않음) 묵시적이든 명시적이든 어떠한 종류의 보증없이 이 책을 현상태대로 제공합니다. 일부 국가에서는 특정 거래에서 명시적 또는 묵시적 보증의 면책사항을 허용하지 않으므로, 이 사항이 적용되지 않을 수도 있습니다.

이 정보에는 기술적으로 부정확한 내용이나 인쇄상의 오류가 있을 수 있습니다. 이 정보는 주기적으로 변경되며, 변경된 사항은 최신판에 통합됩니다. IBM은 이 책에서 설명한 제품 및(또는) 프로그램을 사전 통고없이 언제든지 개선 및(또는) 변경할 수 있습니다.

이 정보에서 언급되는 비IBM의 웹 사이트는 단지 편의상 제공된 것으로, 어떤 방식으로든 이들 웹 사이트를 옹호하고자 하는 것은 아닙니다. 해당 웹 사이트의 자료는 본 IBM 제품 자료의 일부가 아니므로 해당 웹 사이트 사용으로 인한 위험은 사용자 본인이 감수해야 합니다.

비IBM 제품에 관한 정보는 해당 제품의 공급업체, 공개 자료 또는 다른 기타 범용 소스로부터 얻은 것입니다. IBM에서는 이러한 비IBM 제품을 테스트하지 않았으므로, 이들 제품과 관련된 성능의 정확성, 호환성 또는 기타 주장에 대해서는 확신할 수 없습니다. 비 IBM 제품의 성능에 대한 의문사항은 해당 제품의 공급업체에 문의하십시오.

상표

다음 용어는 미국 또는 기타 국가에서 사용되는 IBM Corporation의 상표 또는 등록상표입니다.
IBM
WebSphere

Intel 및 Pentium은 미국 또는 기타 국가에서 사용되는 Intel Corporation의 상표 또는 등록 상표입니다.

Microsoft 및 Windows는 미국 또는 기타 국가에서 사용되는 Microsoft Corporation의 상표 또는 등록 상표입니다.

Java와 모든 Java 기반 상표 및 로고는 미국 또는 기타 국가에서 사용되는 Sun Microsystems, Inc.의 상표 또는 등록상표입니다.

기타 회사, 제품 및 서비스 이름은 타사의 상표 또는 서비스표입니다.

제3자 라이센스

본 프로그램에는 다음 조건이 적용되는 제3자 구성요소가 들어 있습니다.

귀하가 IBM 및 IBM 관계사 또는 계열사(통칭하여 "IBM")와 체결하는 모든 계약의 조건에도 불구하고, 다음 조건이 본 절 또는 본 제품의 라이센스 정보 문서에서 명시된 모든 "제3자 구성요소"에 적용됩니다. IBM은 (a) 모든 제3자 구성요소를 " 현상태대로" 제공하며 (b) 타인의 권리 비침해에 대한 보증 및 상품성 및 특정 목적에의 적합성에 대한 묵시적 보증 등 명시적이거나 묵시적인 일체의 보증을 하지 않으며 (c) 본 제3자 구성요소와 관련된 어떠한 배상 청구에 대해서도 책임을 지거나 귀하를 면책하지 않으며 (d) 본 제3자 구성요소와 관련된 모든 직접 손해, 간접 손해, 부수 손해, 특별 손해, 징벌적 손해 또는 결과적 손해에 대해 일체 책임을 지지 않습니다.

Voice Toolkit V5.0 for WebSphere Studio Readme