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

プロファイルと単語登録

プロファイルとは、音声認識サーバ上に保管されるユーザーごとのデータファイルです。プロファイルに保存される主なデータは、そのユーザーが登録した単語です。音声認識 API の接続時にプロファイル ID を指定すれば、その接続中における音声認識処理で、プロファイルに保存された単語が利用されます。

マイページの単語登録からプロファイルに単語登録​

AmiVoice API の登録ユーザーには、そのユーザー ID を識別子とするプロファイル（マイ単語帳）が、自動的に割り当てられます。AmiVoice API のマイページにログインし、単語登録を行うと、その単語は「マイ単語帳」に登録されます。「マイ単語帳」を認識処理に利用するには、音声認識 API の接続時に「ユーザー ID の先頭に半角コロン”:”を付加した文字列」を profileId に指定します。例えばユーザー ID が「aiueo12345」だとすると、「:aiueo12345」を profileId に指定します。

マイページの単語登録画面は以下です。表示するにはログインが必要です。

例えば、「とりぷるだぶる」という発話を"WWW"に変換するためには以下のようにします。

  1. AmiVoice API にログインし、マイページの[単語登録] をクリックします。

  2. [接続エンジン名] より、単語を登録したいエンジン名を選択します。ここでは、[-a-general]を選択します。

  3. [表記]に「WWW」、[読み]に「とりぷるだぶる」を入力します。

    • 登録したい単語に適したクラスが無い場合は、[クラス]は未選択のままにしてください。ここでは何も選択しません。
    • クラスの「名前」は人名の苗字を、「名前(名)」は人名のファーストネームを表しています。

  4. 登録ボタンをクリックします。

  5. 次に、 以下のコマンドを使用して音声認識を行なってください。認識結果には、"WWW"という表記が含まれているはずです。

note
  • 引数の<:ユーザー ID>は、マイページに表示されている[ユーザー ID]の先頭に":"を付加した文字列です。
  • 引数の<AppKey>は、マイページに表示されている[APPKEY]です。
  • 引数の www.wav には「とりぷるだぶる」という発話が録音されています。

HTTP 音声認識 API で確認​

java -cp .;Hrp.jar HrpTester https://acp-api.amivoice.com/v1/recognize ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>
info

'd'パラメータに与える"-a-general profileId=<:ユーザー ID>"の部分は URL エンコードしてください。

例）

エンコード前：-a-general profileId=:test

エンコード後：-a-general%20profileId%3D%3Atest

WebSocket 音声認識 API で確認​

java -cp .;Wrp.jar WrpTester wss://acp-api.amivoice.com/v1/ ../../audio/www.wav c=16K g=-a-general i=<:ユーザーID> u=<AppKey>

JavaScript​

JavaScript 版サンプルでは、単語登録の効果を、以下の手順で確認できます。

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

JavaScript 版のサンプルでワンタイム AppKey を取得して実行する手順はこちら。