class KeywordRecognizer

class KeywordRecognizer
  : public std::enable_shared_from_this< KeywordRecognizer >

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

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

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< const KeywordRecognitionEventArgs & > Recognized;

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

キャンセル

構文： public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;

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

プロパティ

構文： public const PropertyCollection & Properties;

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

~KeywordRecognizer

構文： public inline ~KeywordRecognizer ( );

デストラクターです。

RecognizeOnceAsync

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

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

パラメーター

返品ポリシー

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

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

StopRecognitionAsync

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

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

返品ポリシー

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

FromConfig

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

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

パラメーター

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

返品ポリシー

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

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

  • Last updated on