クラス KeywordRecognizer

  • [アーティクル] 
class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

アクティブ化のみを処理するために特化された認識エンジンの種類キーワード (keyword)。

まず、オブジェクトをインスタンス化する必要があります。

auto audioConfig = AudioConfig::FromMicrophoneInput(); // Or an alternative input
auto recognizer = [KeywordRecognizer::FromConfig](#fromconfig)(audioConfig);

(省略可能)その後、通知を受信するには、イベントをワイヤードする必要があります。

recognizer->Recognized += [](const KeywordRecognitionEventArgs& event)
{
    // Your logic here...
};

最後に、認識を開始する必要があります。

auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();

メンバー

認識されている

構文: public EventSignal< constKeywordRecognitionEventArgs & > Recognized;

キーワードの認識に関連するイベントのシグナル。

Canceled

構文: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

相互作用の取り消しに関連するイベントのシグナル。 イベントは、理由が直接取り消しまたはエラーであるかどうかを示します。

プロパティ

構文: public constPropertyCollection & Properties;

この KeywordRecognizer に定義されているプロパティとその値のコレクション。

~KeywordRecognizer

構文: public inline ~KeywordRecognizer ( );

デストラクターです。

RecognizeOnceAsync

構文: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );

キーワード (keyword)認識セッションを開始します。 このセッションは、最初のキーワード (keyword)が認識されるまで続きます。 これが発生すると、 Recognized イベントが発生し、セッションが終了します。 キーワード (keyword)をリアームするには、イベントが生成された後にメソッドを再度呼び出す必要があります。

パラメーター

戻り値

キーワード (keyword)が検出されると解決される KeywordRecognitionResult に解決される未来。

入力でキーワード (keyword)が検出されない場合、タスクは解決されません (StopRecognition が呼び出されない限り)。

StopRecognitionAsync

構文: public inline std::future< void > StopRecognitionAsync ( );

現在アクティブなキーワード (keyword)認識セッションを停止します。

戻り値

アクティブなセッション (存在する場合) が停止したときに解決される未来。

FromConfig

構文: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );

AudioConfig から KeywordRecognizer を作成します。 構成は、認識エンジン オブジェクトによって使用されるオーディオ入力を定義するためのものです。

パラメーター

  • audioConfig 認識エンジンによって使用されるオーディオ入力を定義します。

戻り値

指定した入力のオーディオを使用する新しい KeywordRecognizer。

オーディオ構成が指定されていない場合は、AudioConfig::FromDefaultMicrophoneInput で構築された構成で を呼び出すことと同じになります。