Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
class KeywordRecognizer
: public std::enable_shared_from_this< KeywordRecognizer >
Recognizer-type dat is gespecialiseerd om alleen trefwoordactivering af te handelen.
Eerst moet het object worden geïnstantieerd:
auto audioConfig = AudioConfig::FromMicrophoneInput(); // Or an alternative input
auto recognizer = [KeywordRecognizer::FromConfig](#fromconfig)(audioConfig);
(optioneel) Vervolgens moeten de gebeurtenissen worden bekabeld om meldingen te ontvangen:
recognizer->Recognized += [](const KeywordRecognitionEventArgs& event)
{
// Your logic here...
};
En ten slotte moet de herkenning worden gestart.
auto keywordModel = [KeywordRecognitionModel::FromFile](keywordrecognitionmodel.md#fromfile)(modelPath);
auto resultFuture = recognizer->RecognizeKeywordOnceAsync(keywordModel);
resultFuture.wait();
auto result = resultFuture.get();
Leden
Toegerekend
Syntaxis: public EventSignal< const KeywordRecognitionEventArgs & > Recognized;
Signaal voor gebeurtenissen met betrekking tot de herkenning van trefwoorden.
Geannuleerd
Syntaxis: public EventSignal< const SpeechRecognitionCanceledEventArgs & > Canceled;
Signaal voor gebeurtenissen met betrekking tot de annulering van een interactie. De gebeurtenis geeft aan of de reden een directe annulering of een fout is.
Eigenschappen
Syntaxis: public const PropertyCollection & Properties;
Een verzameling eigenschappen en de bijbehorende waarden die zijn gedefinieerd voor deze KeywordRecognizer.
~KeywordRecognizer
Syntaxis: public inline ~KeywordRecognizer ( );
Destructor.
RecognizeOnceAsync
Syntaxis: public inline std::future< std::shared_ptr< KeywordRecognitionResult > > RecognizeOnceAsync ( std::shared_ptr< KeywordRecognitionModel > model );
Hiermee start u een sessie voor het herkennen van trefwoorden. Deze sessie duurt totdat het eerste trefwoord wordt herkend. Wanneer dit gebeurt, wordt er een herkende gebeurtenis gegenereerd en wordt de sessie beëindigd. Als u het trefwoord opnieuw wilt maken, moet de methode opnieuw worden aangeroepen nadat de gebeurtenis is verzonden.
Parameterwaarden
-
modelHet KeywordRecognitionModel waarin het trefwoord wordt beschreven dat we willen detecteren.
Retouren
Een toekomst die wordt omgezet in een KeywordRecognitionResult- die wordt omgezet zodra een trefwoord is gedetecteerd.
Als er geen trefwoord wordt gedetecteerd in de invoer, wordt de taak nooit omgezet (tenzij StopRecognition wordt aangeroepen.
StopRecognitionAsync
Syntaxis: public inline std::future< void > StopRecognitionAsync ( );
Hiermee wordt een momenteel actieve sessie voor het herkennen van trefwoorden gestopt.
Retouren
Een toekomst die wordt opgelost wanneer de actieve sessie (indien aanwezig) wordt gestopt.
FromConfig
Syntaxis: public inline static std::shared_ptr< KeywordRecognizer > FromConfig ( std::shared_ptr< Audio::AudioConfig > audioConfig );
Hiermee maakt u een KeywordRecognizer op basis van een AudioConfig. De configuratie is bedoeld om de audio-invoer te definiëren die moet worden gebruikt door het recognizer-object.
Parameterwaarden
-
audioConfigDefinieert de audio-invoer die moet worden gebruikt door de recognizer.
Retouren
Een nieuwe KeywordRecognizer die audio van de opgegeven invoer verbruikt.
Als er geen audioconfiguratie is opgegeven, is deze gelijk aan het bellen met een configuratie die is samengesteld met AudioConfig::FromDefaultMicrophoneInput