メインコンテンツまでスキップ

登録単語を利用する方法

事前に登録しておく方法で単語をプロファイルに保存した場合に、その単語を有効にする方法を説明します。

利用方法​

音声認識のリクエストパラメータに、音声認識エンジン(grammarFileNames)に加えて、プロファイルID(profileId)を設定します。そのリクエストのセッション中はプロファイルに登録した単語が有効になります。

grammarFileNames={接続エンジン名} profileId=:{プロファイルID}
  • profileIdには「:」（半角コロン）に続けてプロファイルの名前を指定してください。
  • プロファイルは音声認識エンジンごとに区別されているので、単語登録したときに指定したgrammarFileNamesをリクエスト時にも設定してください。
  • マイページから登録した場合は、プロファイルIDにユーザーIDを設定してください。
ヒント

profileId の先頭に「:」をつけなくても動作しますが、認識精度が低下する場合があります。

単語登録のテスト​

音声ファイル(www.wav)をダウンロードしてコマンドを実行するディレクトリにコピーしてください。「とりぷるだぶる」という発話が録音されています。以下のパラメータを設定してサンプルを実行します。

  • {サービス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 版サンプルでは、単語登録の効果を、以下の手順で確認できます。

  1. WrpTester.html または wrp.html をブラウザ（IE を除く）で開きます。
  2. [プロファイル ID]に、マイページの[サービス ID]の先頭に":"を付加した文字列を入力します。
  3. [APPKEY]に、マイページの[APPKEY]を入力します。
  4. [録音開始]ボタンをクリックして、「とりぷるだぶる」と発話します。

JavaScript 版のサンプルでワンタイム APPKEY を取得して実行する手順はこちらを参照してください。