継続的なディクテーション

[アーティクル]
04/06/2023

長い形式の継続的なディクテーション音声入力をキャプチャし、認識する方法について説明します。

重要な API: SpeechContinuousRecognitionSession、ContinuousRecognitionSession

「音声認識」では、SpeechRecognizer オブジェクトの RecognizeAsync メソッドまたは RecognizeWithUIAsync メソッドを使って、比較的短い音声入力をキャプチャし、認識する方法について説明しました。たとえば、ショートメッセージサービス (SMS) のメッセージを作成したり、質問したりする場合です。

ディクテーションまたはメールなど、より長い継続的な音声認識セッションの場合は、SpeechRecognizer の ContinuousRecognitionSession プロパティを使って SpeechContinuousRecognitionSession オブジェクトを取得します。

注意

ディクテーション言語のサポートは、アプリが実行しているデバイスによって異なります。 PC とノート PC の場合は en-US だけが認識され、Xbox とスマートフォンは音声認識でサポートされているすべての言語を認識できます。詳細については、「音声認識エンジンの言語の指定」を参照してください。

設定

アプリには、継続的なディクテーションセッションを管理するためのオブジェクトがいくつか必要です。

1 インスタンスの SpeechRecognizer オブジェクト。
ディクテーション中の UI を更新するための UI ディスパッチャーへの参照。
ユーザーが発声し、蓄積された単語を追跡する方法。

ここでは、SpeechRecognizer インスタンスを、コードビハインドクラスのプライベートフィールドとして宣言します。継続的なディクテーションが、1 つの XAML (Extensible Application Markup Language) ページを超えて持続する場合、アプリは、参照を別の場所に格納する必要があります。

private SpeechRecognizer speechRecognizer;

ディクテーション中に認識エンジンは、バックグラウンドスレッドからイベントを生成します。バックグラウンドスレッドは、XAML の UI を直接更新できないため、アプリはディスパッチャーを使って、認識イベントに応答して UI を更新する必要があります。

ここでは、プライベートフィールドを宣言し、それが後で UI ディスパッチャーで初期化されます。

// Speech events may originate from a thread other than the UI thread.
// Keep track of the UI thread dispatcher so that we can update the
// UI in a thread-safe manner.
private CoreDispatcher dispatcher;

ユーザーが発声した内容を追跡するには、音声認識エンジンによって生成された認識イベントを処理する必要があります。これらのイベントは、ユーザーの発声のチャンクを認識した結果を提供します。

ここでは、StringBuilder オブジェクトを使って、セッション中に取得したすべての認識結果を保持します。新しい検索結果は、処理されるに従って StringBuilder に追加されます。

private StringBuilder dictatedTextBuilder;

初期化

継続的な音声認識の初期化時には、次の操作を行う必要があります。

連続的な認識のイベントハンドラーでアプリの UI を更新する場合は、UI スレッドのディスパッチャーを取得します。
音声認識エンジンを初期化します。
組み込みのディクテーション文法をコンパイルします。注音声認識では、少なくとも 1 つの制約を使って、認識できるボキャブラリを定義する必要があります。制約が指定されていない場合は、定義済みのディクテーション文法が使われます。「音声認識」をご覧ください。
認識イベントのイベントリスナーをセットアップします。

この例では、OnNavigatedTo ページイベントで音声認識を初期化します。

音声認識エンジンが生成するイベントはバックグラウンドスレッドで発生するため、UI スレッドを更新するためのディスパッチャーへの参照を作成します。 OnNavigatedTo は、常に UI スレッド上で呼び出されます。

this.dispatcher = CoreWindow.GetForCurrentThread().Dispatcher;

その後、SpeechRecognizer インスタンスを初期化します。

this.speechRecognizer = new SpeechRecognizer();

そして、SpeechRecognizer によって認識される語句と単語をすべて定義する文法を追加し、コンパイルします。

文法を明示的に指定しない場合は、既定で定義済みのディクテーション文法が使われます。通常、一般的なディクテーションには、既定の文法が最適です。

ここでは、文法を追加せずに、すぐに CompileConstraintsAsync を呼び出します。

SpeechRecognitionCompilationResult result =
      await speechRecognizer.CompileConstraintsAsync();

認識イベントの処理

RecognizeAsync または RecognizeWithUIAsync を呼び出して、1 つの短い発声または語句をキャプチャできます。

ただし、より長い継続的な認識セッションをキャプチャするには、ユーザーが話す間にバックグラウンドで動作するイベントリスナーを指定し、ディクテーション文字列を作成するためのハンドラーを定義します。

そして、認識エンジンの ContinuousRecognitionSession プロパティを使って、継続的な認識セッションを管理するためのメソッドとイベントを提供する SpeechContinuousRecognitionSession オブジェクトを取得します。

特に、次の 2 つのイベントが重要です。

ResultGenerated。これは、認識エンジンがいくつかの結果を生成したときに発生します。
Completed。継続的な認識セッションが終了したときに発生します。

ResultGenerated イベントは、ユーザーが発声すると発生します。認識エンジンは、ユーザーの発声を聞き続け、音声入力のチャンクを渡すイベントを定期的に生成します。音声入力は、イベントの引数の Result プロパティを使って確認し、イベントハンドラーで適切な処置を行う必要があります。たとえば、StringBuilder オブジェクトにテキストを追加します。

SpeechRecognitionResult のインスタンスである Result プロパティは、音声入力を受け入れるかどうかを決定するために役立ちます。 SpeechRecognitionResult には、このための 2 つのプロパティが用意されています。

Status は、正常に認識できたかどうかを示します。さまざまな原因により、認識できない場合もあります。
Confidence は、認識エンジンが、正しい単語を理解したことを比較的確信していることを示します。

継続的な認識をサポートするための基本的な手順は次のとおりです。

ここでは、ResultGenerated 継続的認識イベントのハンドラーを OnNavigatedTo ページイベントに登録します。

speechRecognizer.ContinuousRecognitionSession.ResultGenerated +=
        ContinuousRecognitionSession_ResultGenerated;

そして、Confidence プロパティを確認します。 Confidence の値が Medium 以上である場合は、StringBuilder にテキストを追加します。入力の収集時に UI も更新します。

注ResultGenerated イベントは、UI を直接更新できないバックグラウンドスレッドで発生します。 (「音声と TTS のサンプル」のように) ハンドラーが UI を更新する必要がある場合は、ディスパッチャーの RunAsync メソッドで更新を UI スレッドにディスパッチする必要があります。

private async void ContinuousRecognitionSession_ResultGenerated(
      SpeechContinuousRecognitionSession sender,
      SpeechContinuousRecognitionResultGeneratedEventArgs args)
      {

        if (args.Result.Confidence == SpeechRecognitionConfidence.Medium ||
          args.Result.Confidence == SpeechRecognitionConfidence.High)
          {
            dictatedTextBuilder.Append(args.Result.Text + " ");

            await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
              dictationTextBox.Text = dictatedTextBuilder.ToString();
              btnClearText.IsEnabled = true;
            });
          }
        else
        {
          await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
              dictationTextBox.Text = dictatedTextBuilder.ToString();
            });
        }
      }

その後、Completed イベントを処理します。これが、継続的なディクテーションの終了を示します。

セッションは、StopAsync メソッドまたは CancelAsync メソッド (次のセクションを参照) を呼び出すと終了します。セッションは、エラーが発生したときや、ユーザーが発声を停止したときに終了することもあります。イベントの引数の Status プロパティを確認して、セッションが終了した理由を特定してください (SpeechRecognitionResultStatus)。

ここでは、Completed 継続的認識イベントのハンドラーを OnNavigatedTo ページイベントに登録します。

speechRecognizer.ContinuousRecognitionSession.Completed +=
      ContinuousRecognitionSession_Completed;

イベントハンドラーは Status プロパティを確認して、正常に認識できたかどうかを判断します。また、ユーザーが発声を停止した場合の処理も行います。多くの場合、TimeoutExceeded によって、正常に認識されたと見なされます。これは、ユーザーの発声が終了したことを意味するためです。快適に使えるように、このケースをコード内で処理する必要があります。

注ResultGenerated イベントは、UI を直接更新できないバックグラウンドスレッドで発生します。 (「音声と TTS のサンプル」のように) ハンドラーが UI を更新する必要がある場合は、ディスパッチャーの RunAsync メソッドで更新を UI スレッドにディスパッチする必要があります。

private async void ContinuousRecognitionSession_Completed(
      SpeechContinuousRecognitionSession sender,
      SpeechContinuousRecognitionCompletedEventArgs args)
      {
        if (args.Status != SpeechRecognitionResultStatus.Success)
        {
          if (args.Status == SpeechRecognitionResultStatus.TimeoutExceeded)
          {
            await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
              rootPage.NotifyUser(
                "Automatic Time Out of Dictation",
                NotifyType.StatusMessage);

              DictationButtonText.Text = " Continuous Recognition";
              dictationTextBox.Text = dictatedTextBuilder.ToString();
            });
          }
          else
          {
            await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
              rootPage.NotifyUser(
                "Continuous Recognition Completed: " + args.Status.ToString(),
                NotifyType.StatusMessage);

              DictationButtonText.Text = " Continuous Recognition";
            });
          }
        }
      }

実行中の認識に対するフィードバックの提供

人が会話する場合は、話の内容を完全に理解するためにコンテキストが必要であることがよくあります。同様に、信頼性の高い認識結果を提供するために音声認識エンジンにコンテキストが必要である場合がよくあります。たとえば、"weight" および "wait" という単語は、それ自体だけでは区別できないため、周囲の単語からコンテキストをさらに探り出す必要があります。認識エンジンは、単語や語句を正しく認識したことを、ある程度確信するまでは、ResultGenerated イベントを生成しません。

したがって、ユーザーが話し続けても、認識エンジンが ResultGenerated イベントを生成できると確信するまでは結果が表示されないため、ユーザーにとって快適とはいえない結果になる場合があります。

この不十分な応答性を改善するには、HypothesisGenerated イベントを処理します。このイベントは、処理中の単語と一致すると思われる新しいセットを認識エンジンが生成するたびに発生します。イベント引数は、現在の一致を含む Hypothesis プロパティを提供します。話し続けるユーザーに、これらを表示して、処理がまだ続行されていることを知らせます。認識エンジンが十分に確信し、認識結果が確定されたら、暫定の Hypothesis 結果を、ResultGenerated イベントで提供される最終的な Result に置き換えます。

ここでは、仮のテキストと省略記号 ("…") を、出力 TextBox の現在の値に追加します。テキストボックスの内容は、新しい仮の結果が生成されるたびに更新され、最後に、最終的な結果が ResultGenerated イベントから取得されます。

private async void SpeechRecognizer_HypothesisGenerated(
  SpeechRecognizer sender,
  SpeechRecognitionHypothesisGeneratedEventArgs args)
  {

    string hypothesis = args.Hypothesis.Text;
    string textboxContent = dictatedTextBuilder.ToString() + " " + hypothesis + " ...";

    await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
      dictationTextBox.Text = textboxContent;
      btnClearText.IsEnabled = true;
    });
  }

認識の開始と停止

認識セッションを開始する前に、音声認識エンジンの State プロパティの値を確認します。音声認識エンジンは、Idle 状態である必要があります。

音声認識エンジンの状態を確認した後、音声認識エンジンの ContinuousRecognitionSession プロパティの StartAsync メソッドを呼び出してセッションを開始します。

if (speechRecognizer.State == SpeechRecognizerState.Idle)
{
  await speechRecognizer.ContinuousRecognitionSession.StartAsync();
}

認識を停止するには、次の 2 つの方法があります。

StopAsync を使うと、保留中のすべての認識イベントが完了します (ResultGenerated は、保留中のすべての操作が完了するまで、引き続き発生します)。
CancelAsync を使うと、すぐに認識セッションが終了し、保留中の結果はすべて破棄されます。

音声認識エンジンの状態を確認したら、音声認識エンジンの ContinuousRecognitionSession プロパティの CancelAsync メソッドを呼び出してセッションを停止します。

if (speechRecognizer.State != SpeechRecognizerState.Idle)
{
  await speechRecognizer.ContinuousRecognitionSession.CancelAsync();
}

注意

CancelAsync を呼び出した後に ResultGenerated イベントが発生する場合があります。
マルチスレッドであるために、CancelAsync を呼び出したときに ResultGenerated イベントがスタックに残っている可能性があります。その場合は、ResultGenerated イベントも発生します。
プライベートフィールドを設定しているときに認識セッションをキャンセルした場合は、その値を常に ResultGenerated ハンドラーで確認してください。たとえば、セッションをキャンセルしたときにプライベートフィールドを null に設定している場合はハンドラー内でフィールドが初期化されると想定しないでください。

音声操作

サンプル

音声認識と音声合成のサンプル

次の方法で共有

継続的なディクテーション

設定

初期化

認識イベントの処理

実行中の認識に対するフィードバックの提供

認識の開始と停止

その他のリソース

次の方法で共有

継続的なディクテーション

設定

初期化

認識イベントの処理

実行中の認識に対するフィードバックの提供

認識の開始と停止

関連記事

その他のリソース