如何使用用户词典

本文介绍如何启用通过预先注册方法保存在profile中的词语。

使用方法

在语音识别的请求参数中，除了设置语音识别引擎(grammarFileNames)外，还需设置 profileId(profileId)。在该请求会话期间，profile 中注册的词语将会生效。

grammarFileNames={连接引擎名} profileId=:{profile_id}

profileId请在":"(半角冒号)后指定 profile 的名称。
profile 是按语音识别引擎区分的，因此请求时也要设置注册单词时指定的grammarFileNames。
如果是从 MyPage 注册的，请将 Service ID 设置为 profileId 。Service ID 是显示在 MyPage 连接信息中的[Service ID]。例如，如果 Service ID 为user01，则指定为profileId=:user01。

对于WebSocket接口，请按以下方式在s命令中指定。有关音频格式的详细信息，请参阅此处。

s {音频格式名} {连接引擎名} profileId=:{profile_id}

提示

即使不在 profileId 前加":"也能正常运行。但是，由于以下原因，可能会导致意外内容的 profile 被保存，从而降低识别精度。

如果不加":"，在语音识别处理会话结束时，会用该会话中使用的 profile 内容覆盖原 profile。
例如，如果在使用test profile 进行语音识别处理的过程中，另外通过用户词典注册API更新了test profile 的内容。在这种情况下，当语音识别会话结束时，test profile 将被"语音识别处理中使用的内容"（即"用户词典注册 API 更新前的内容"）覆盖，导致回滚。

如果同时指定了profileId和profileWords，则profileWords将优先生效。已经注册在配置文件中的单词将不会被启用。

例如，如果使用"会話_汎用"引擎(-a-general)，将profileId设置为":test"，将profileWords设置为"AMI あみ"进行请求，那么在这个会话中，通过profileId指定的配置文件中保存的词将不会被启用。只有在profileWords中设置的"AMI あみ"会生效。

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

用户词典注册测试

请下载音频文件(www.wav)并复制到执行命令的目录中。该文件中录制了"とりぷるだぶる"的发音。使用以下参数运行示例。

profileId请指定在 profileId 前加上"："（半角冒号）的内容。
{API_KEY}是显示在 MyPage 上的[API key]。

curl https://acp-api.amivoice.com/v1/recognize \
     -F u={API_KEY} \
     -F d="grammarFileNames=-a-general profileId=:{profile_id}" \
     -F a=@www.wav

在 JavaScript 版样例中，可以通过以下步骤确认用户词典的效果:

用浏览器(除IE外)打开 WrpTester.html 或 wrp.html。
在[プロファイル ID]中输入要使用的 profile ID，并在其前面加上"："（半角冒号）。
在[APPKEY]中输入 MyPage 上的[API key]。
点击[録音の開始]按钮，说出"とりぷるだぶる"。

关于使用 API key 执行 JavaScript 版样例的步骤，请参考这里。

使用方法​

用户词典注册测试​

使用方法

用户词典注册测试