使用注册词的方法
本文介绍如何启用通过预先注册方法保存在profile中的词语。
使用方法
在语音识别的请求参数中,除了设置语音识别引擎(grammarFileNames)外,还需设置 profileId(profileId)。在该请求会话期间,profile 中注册的词语将会生效。
grammarFileNames={连接引擎名} profileId=:{profileId}
profileId请在":"(半角冒号)后指定 profile 的名称。- profile 是按语音识别引擎区分的,因此请求时也要设置注册单词时指定的
grammarFileNames。 - 如果是从 MyPage 注册的,请将 Service ID 设置为 profileId。
提示
即使不在 profileId 前加":"也能正常运行。但是,由于以下原因,可能会导致意外内容的 profile 被保存,从而降低识别精度。
- 如果不加":",在语音识别处理会话结束时,会用该会话中使用的 profile 内容覆盖原 profile。
- 例如,如果在使用
testprofile 进行语音识别处理的过程中,另外通过词语注册API更新了testprofile 的内容。在这种情况下,当语音识别会话结束时,testprofile 将被"语音识别处理中使用的内容"(即"更新前的内容")覆盖,导致回滚。
如果同时指定了profileId和profileWords,则profileWords将优先生效。已经注册在配置文件中的单词将不会被启用。
例如,如果使用"会話_汎用"引擎(-a-general),将profileId设置为":test",将profileWords设置为"AMI あみ"进行请求,那么在这个会话中,通过profileId指定的配置文件中保存的词将不会被启用。只有在profileWords中设置的"AMI あみ"会生效。
grammarFileNames=-a-general profileId=:test profileWords="AMI あみ"
词语注册测试
请下载音频文件(www.wav)并复制到执行命令的目录中。该文件中录制了"とりぷるだぶる"的发音。使用以下参数运行示例。
{Service ID}是显示在 MyPage 连接信息中的[Service ID]。请在前面加上":"。例如,如果 serviceID 是 user01,则应写为:user01{APP_KEY}是显示在 MyPage 上的[APPKEY]。
curl https://acp-api.amivoice.com/v1/recognize \
-F u={APP_KEY} \
-F d="grammarFileNames=-a-general profileId=:{serviceID}" \
-F a=@www.wav
在 JavaScript 版样例中,可以通过以下步骤确认单词注册的效果:
- 用浏览器(除IE外)打开 WrpTester.html 或 wrp.html。
- 在[プロファイル ID]中输入 MyPage 上[Service ID]前加":"的字符串。
- 在[APPKEY]中输入 MyPage 上的[APPKEY]。
- 点击[録音の開始]按钮,说出"とりぷるだぶる"。
关于使用一次性 APPKEY 执行 JavaScript 版样例的步骤,请参考这里。