등록된 단어 사용 방법

사전 등록 방법으로 단어를 프로파일에 저장한 경우, 해당 단어를 활성화하는 방법을 설명합니다.

사용 방법

음성 인식 요청 파라미터에 음성 인식 엔진(grammarFileNames)과 함께 프로파일 ID(profileId)를 설정합니다. 해당 요청 세션 중에는 프로파일에 등록된 단어가 활성화됩니다.

grammarFileNames={연결 엔진 이름} profileId=:{프로파일 ID}

profileId에는 ":" (콜론) 다음에 프로파일 이름을 지정하십시오.
프로파일은 음성 인식 엔진별로 구분되므로, 단어 등록 시 지정한 grammarFileNames를 요청 시에도 설정하십시오.
마이페이지에서 등록한 경우, 프로파일 ID에 서비스 ID를 설정하십시오.

팁

profileId 앞에 ":"를 붙이지 않아도 작동합니다. 그러나 다음과 같은 이유로 의도하지 않은 내용으로 프로파일이 저장되어 인식 정확도가 저하될 수 있습니다.

":"를 붙이지 않은 경우, 음성 인식 처리 세션 종료 시 해당 세션에서 사용된 프로파일 내용으로 프로파일이 덮어쓰기됩니다.
예를 들어, test라는 프로파일을 사용하여 음성 인식 처리를 실행하는 중에, 별도로 단어 등록 API로 test 프로파일의 내용을 업데이트했다고 가정합니다. 이 경우, 음성 인식 세션 종료 시 test 프로파일은 "음성 인식 처리에 사용된 내용" = "단어 등록 API로 업데이트하기 전의 내용"으로 덮어쓰기되어 롤백됩니다.

만약 profileId와 profileWords를 동시에 지정한 경우에는 profileWords가 우선됩니다. 이미 프로필에 등록된 단어는 활성화되지 않습니다.

예를 들어, 다음과 같이 "会話_汎用(대화 범용) 엔진"(-a-general)에서 profileId에 ":test", profileWords에 "AMI あみ"로 설정하여 요청을 한 경우. 이 세션에서는 profileId로 지정한 프로필에 저장된 단어는 활성화되지 않습니다. profileWords에 설정한 "AMI あみ"만 활성화됩니다.

grammarFileNames=-a-general profileId=:test profileWords="AMI あみ"

단어 등록 테스트

음성 파일(www.wav)을 다운로드하여 명령어를 실행할 디렉토리에 복사하십시오. "とりぷるだぶる"라는 발화가 녹음되어 있습니다. 다음 파라미터를 설정하여 샘플을 실행합니다.

{서비스 ID}는 마이페이지의 연결 정보 [サービスID]에 표시된 서비스 ID입니다. 앞에 ":"를 붙이십시오. 예를 들어, 서비스 ID가 user01인 경우 :user01과 같이 입력합니다.
{APP_KEY}는 마이페이지에 표시된 [APPKEY]입니다.

curl https://acp-api.amivoice.com/v1/recognize \
     -F u={APP_KEY} \
     -F d="grammarFileNames=-a-general profileId=:{서비스 ID}" \
     -F a=@www.wav

JavaScript 버전 샘플에서는 다음 단계로 단어 등록의 효과를 확인할 수 있습니다.

WrpTester.html 또는 wrp.html을 브라우저(IE 제외)에서 엽니다.
[プロファイル ID]에는, 마이페이지의 연결 정보 [サービスID]의 서비스 ID 앞에 ":"를 붙여서 입력합니다.
[APPKEY]에는, 마이페이지의 [APPKEY]를 입력합니다.
[録音の開始] 버튼을 클릭하여 녹음이 시작되면 "とりぷるだぶる"라고 발화합니다.

JavaScript 버전 샘플에서 원타임 APPKEY를 얻어 실행하는 절차는 여기를 참조하십시오.

사용 방법​

단어 등록 테스트​

사용 방법

단어 등록 테스트