IntentRecognizer Klasse

Paket:

com.microsoft.cognitiveservices.speech.intent

Maven-Artefakt:

com.microsoft.cognitiveservices.speech:client-sdk:1.38.0

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.Recognizer
  • • com.microsoft.cognitiveservices.speech.intent.IntentRecognizer

public final class IntentRecognizer
extends Recognizer

Führt die Absichtserkennung für die Spracheingabe aus. Es gibt sowohl den erkannten Text als auch die erkannte Absicht zurück. Hinweis: close() muss aufgerufen werden, um die zugrunde liegenden Ressourcen freizugeben, die sich im Objekt befinden.

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
final EventHandlerImpl<IntentRecognitionCanceledEventArgs>	canceled Das ereignis canceled signalisiert, dass die Absichtserkennung abgebrochen wurde.
final EventHandlerImpl<IntentRecognitionEventArgs>	recognized Das ereignis erkannte signalisiert, dass ein endgültiges Erkennungsergebnis empfangen wird.
final EventHandlerImpl<IntentRecognitionEventArgs>	recognizing Das Ereignis, das erkennt, signalisiert, dass ein zwischengeschaltetes Erkennungsergebnis empfangen wird.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig)	Erstellt eine neue instance einer Absichtserkennung mit eingebetteter Sprachkonfiguration.
IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig, AudioConfig audioConfig)	Erstellt eine neue instance einer Absichtserkennung mit eingebetteter Sprachkonfiguration.
IntentRecognizer(SpeechConfig speechConfig)	Erstellt eine neue instance einer Absichtserkennung.
IntentRecognizer(SpeechConfig speechConfig, AudioConfig audioConfig)	Erstellt eine neue instance einer Absichtserkennung.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
void	addAllIntents(LanguageUnderstandingModel model) Fügt alle Absichten aus dem angegebenen Language Understanding-Modell hinzu.
void	addAllIntents(LanguageUnderstandingModel model, String intentId) Fügt alle Absichten aus dem angegebenen Language Understanding-Modell hinzu.
void	addIntent(LanguageUnderstandingModel model, String intentName) Fügt eine einzelne Absicht anhand des Namens aus dem angegebenen Language Understanding-Modell hinzu.
void	addIntent(LanguageUnderstandingModel model, String intentName, String intentId) Fügt eine einzelne Absicht anhand des Namens aus dem angegebenen Language Understanding-Modell hinzu.
void	addIntent(String simplePhrase) Fügt einen einfachen Ausdruck hinzu, der vom Benutzer gesprochen werden kann, der eine bestimmte Benutzerabsicht angibt.
void	addIntent(String simplePhrase, String intentId) Fügt einen einfachen Ausdruck hinzu, der vom Benutzer gesprochen werden kann, der eine bestimmte Benutzerabsicht angibt.
boolean	applyLanguageModels(Collection<LanguageUnderstandingModel> collection) Übernimmt eine Sammlung von Sprachverständnismodellen, erstellt eine Kopie davon und wendet sie auf die Erkennung an.
protected void	dispose(boolean disposing) Diese Methode führt eine Bereinigung von Ressourcen durch.
java.lang.String	getAuthorizationToken() Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird.
PropertyCollection	getProperties() Die Auflistung der Eigenschaften und deren Werte, die für diese Absichtserkennungdefiniert sind.
java.lang.String	getSpeechRecognitionLanguage() Ruft die gesprochene Erkennungssprache ab.
java.util.concurrent.Future<IntentRecognitionResult>	recognizeOnceAsync() Startet die Absichtserkennung und kehrt zurück, nachdem eine einzelne Äußerung erkannt wurde.
java.util.concurrent.Future<IntentRecognitionResult>	recognizeOnceAsync(String text) Führt die Absichtserkennung aus und generiert ein Ergebnis aus dem übergebenen Text.
void	setAuthorizationToken(String token) Legt das Autorisierungstoken fest, das für die Kommunikation mit dem Dienst verwendet wird.
java.util.concurrent.Future<java.lang.Void>	startContinuousRecognitionAsync() Startet die Spracherkennung für einen kontinuierlichen Audiodatenstrom, bis "ContinuousRecognitionAsync()"aufgerufen wird.
java.util.concurrent.Future<java.lang.Void>	startKeywordRecognitionAsync(KeywordRecognitionModel model) Konfiguriert die Erkennung mit dem angegebenen Schlüsselwort (keyword)-Modell.
java.util.concurrent.Future<java.lang.Void>	stopContinuousRecognitionAsync() Beendet einen ausgeführten Erkennungsvorgang so schnell wie möglich und fordert sofort ein Ergebnis basierend auf der Eingabe an, die bisher verarbeitet wurde.
java.util.concurrent.Future<java.lang.Void>	stopKeywordRecognitionAsync() Beendet die Schlüsselwort (keyword) initiierte Erkennung.

Geerbte Methoden von Recognizer

canceledSetCallback close dispose doAsyncRecognitionAction getImpl getPropertyBagFromRecognizerHandle recognize recognizedSetCallback recognizingSetCallback sessionStartedEventCallback sessionStartedSetCallback sessionStoppedEventCallback sessionStoppedSetCallback speechEndDetectedEventCallback speechEndDetectedSetCallback speechStartDetectedEventCallback speechStartDetectedSetCallback startContinuousRecognition startKeywordRecognition stopContinuousRecognition stopKeywordRecognition

Geerbte Methoden von java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Felddetails

canceled

public final EventHandlerImpl canceled

Das ereignis canceled signalisiert, dass die Absichtserkennung abgebrochen wurde.

recognized

public final EventHandlerImpl recognized

Das ereignis erkannte signalisiert, dass ein endgültiges Erkennungsergebnis empfangen wird.

recognizing

public final EventHandlerImpl recognizing

Das Ereignis, das erkennt, signalisiert, dass ein zwischengeschaltetes Erkennungsergebnis empfangen wird.

Details zum Konstruktor

IntentRecognizer

public IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig)

Erstellt eine neue instance einer Absichtserkennung mit eingebetteter Sprachkonfiguration.

Parameter:

embeddedSpeechConfig - Eingebettete Sprachkonfiguration.

IntentRecognizer

public IntentRecognizer(EmbeddedSpeechConfig embeddedSpeechConfig, AudioConfig audioConfig)

Erstellt eine neue instance einer Absichtserkennung mit eingebetteter Sprachkonfiguration.

Parameter:

embeddedSpeechConfig - Eingebettete Sprachkonfiguration.

audioConfig - Audiokonfiguration.

IntentRecognizer

public IntentRecognizer(SpeechConfig speechConfig)

Erstellt eine neue instance einer Absichtserkennung.

Parameter:

speechConfig - Sprachkonfiguration.

IntentRecognizer

public IntentRecognizer(SpeechConfig speechConfig, AudioConfig audioConfig)

Erstellt eine neue instance einer Absichtserkennung.

Parameter:

speechConfig - Sprachkonfiguration.

audioConfig - Audiokonfiguration.

Details zur Methode

addAllIntents

public void addAllIntents(LanguageUnderstandingModel model)

Fügt alle Absichten aus dem angegebenen Language Understanding-Modell hinzu.

Parameter:

model - Das Language Understanding-Modell, das die Absichten enthält.

addAllIntents

public void addAllIntents(LanguageUnderstandingModel model, String intentId)

Fügt alle Absichten aus dem angegebenen Language Understanding-Modell hinzu.

Parameter:

model - Das Language Understanding-Modell, das die Absichten enthält.

intentId - Eine benutzerdefinierte ID-Zeichenfolge, die in der getIntentId()-Methode von IntentRecognitionResult zurückgegeben werden soll.

addIntent

public void addIntent(LanguageUnderstandingModel model, String intentName)

Fügt eine einzelne Absicht anhand des Namens aus dem angegebenen Language Understanding-Modell hinzu.

Parameter:

model - Das Language Understanding-Modell, das die Absicht enthält.

intentName - Der Name der einzelnen Absicht, die aus dem Language Understanding-Modell eingeschlossen werden soll.

addIntent

public void addIntent(LanguageUnderstandingModel model, String intentName, String intentId)

Fügt eine einzelne Absicht anhand des Namens aus dem angegebenen Language Understanding-Modell hinzu.

Parameter:

model - Das Language Understanding-Modell, das die Absicht enthält.

intentName - Der Name der einzelnen Absicht, die aus dem Language Understanding-Modell eingeschlossen werden soll.

intentId - Eine benutzerdefinierte ID-Zeichenfolge, die in der getIntentId()-Methode von IntentRecognitionResult zurückgegeben werden soll.

addIntent

public void addIntent(String simplePhrase)

Fügt einen einfachen Ausdruck hinzu, der vom Benutzer gesprochen werden kann, der eine bestimmte Benutzerabsicht angibt.

Parameter:

simplePhrase - Der Ausdruck, der der Absicht entspricht.

addIntent

public void addIntent(String simplePhrase, String intentId)

Fügt einen einfachen Ausdruck hinzu, der vom Benutzer gesprochen werden kann, der eine bestimmte Benutzerabsicht angibt.

Parameter:

simplePhrase - Der Ausdruck, der der Absicht entspricht.

intentId - Eine benutzerdefinierte ID-Zeichenfolge, die in der getIntentId()-Methode von IntentRecognitionResult zurückgegeben werden soll.

applyLanguageModels

public boolean applyLanguageModels(Collection collection)

Erstellt eine Sammlung von Sprachverständnismodellen, erstellt eine Kopie davon und wendet sie auf die Erkennung an. Diese Anwendung wird je nach LanguageUnderstandingModel-Typ zu unterschiedlichen Zeiten wirksam. PatternMatchingModels wird sofort aktiv, während LanguageUnderstandingModels, die den LUIS-Dienst verwendet, sofort aktiv wird, es sei denn, die Erkennung befindet sich in der Mitte der Absichtserkennung. In diesem Fall wird sie nach dem nächsten Erkannten Ereignis wirksam. Dadurch werden alle zuvor angewendeten Modelle ersetzt.

Parameter:

collection - Eine Sammlung von freigegebenen Zeigern auf LanguageUnderstandingModels.

Gibt zurück:

True, wenn die Anwendung der Modelle sofort wirksam wird. Andernfalls false.

Löst aus:

java.lang.NullPointerException - Wenn die übergebene Auflistung NULL ist.

dispose

protected void dispose(boolean disposing)

Diese Methode führt eine Bereinigung von Ressourcen durch. Der verwerfende boolesche Parameter gibt an, ob die Methode von Dispose (wenn die Entsorgung true ist) oder vom Finalizer (wenn die Entsorgung false ist) aufgerufen wird. Abgeleitete Klassen sollten diese Methode überschreiben, um bei Bedarf Ressourcen zu entsorgen.

Überschreibt:

IntentRecognizer.dispose(boolean disposing)

Parameter:

disposing

getAuthorizationToken

public String getAuthorizationToken()

Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird.

Gibt zurück:

Autorisierungstoken.

getProperties

public PropertyCollection getProperties()

Die Auflistung der Eigenschaften und deren Werte, die für diesen IntentRecognizer definiert sind.

Gibt zurück:

Die Auflistung der Eigenschaften und deren Werte, die für diesen IntentRecognizer definiert sind.

getSpeechRecognitionLanguage

public String getSpeechRecognitionLanguage()

Ruft die gesprochene Erkennungssprache ab.

Gibt zurück:

die gesprochene Erkennungssprache.

recognizeOnceAsync

public Future recognizeOnceAsync()

Startet die Absichtserkennung und kehrt zurück, nachdem eine einzelne Äußerung erkannt wurde. Zur Erkennung des Endes einer einzelnen Äußerung wird auf Stille am Ende gelauscht oder gewartet, bis maximal 15 Sekunden an Audiodaten verarbeitet wurden. Die Aufgabe gibt als Ergebnis den Erkennungstext zurück. Hinweis: Da recognizeOnceAsync() nur eine einzelne Äußerung zurückgibt, eignet sie sich nur für die Einzelschusserkennung wie Befehl oder Abfrage. Verwenden Sie stattdessen startContinuousRecognitionAsync() für die Erkennung von mehreren Äußerungen mit langer Ausführungsdauer.

Gibt zurück:

Eine Aufgabe, die den Erkennungsvorgang darstellt. Der Task gibt den Wert von IntentRecognitionResult

recognizeOnceAsync

public Future recognizeOnceAsync(String text)

Führt die Absichtserkennung aus und generiert ein Ergebnis aus dem übergebenen Text. Dies ist nützlich für Tests und andere Zeiten, in denen die Spracheingabe nicht an intentRecognizer gebunden ist. Hinweis: Dies wird vom Absichtsdienst derzeit nicht unterstützt, sodass er nur für Offlinemusterabgleich oder exakte Abgleichsabsichten gültig ist.

Parameter:

text - Der Text, der für die Absicht erkannt werden soll.

Gibt zurück:

Eine Aufgabe, die den Erkennungsvorgang darstellt. Der Task gibt den Wert zurück IntentRecognitionResult.

setAuthorizationToken

public void setAuthorizationToken(String token)

Legt das Autorisierungstoken fest, das für die Kommunikation mit dem Dienst verwendet wird. Hinweis: Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Bevor das Autorisierungstoken abläuft, muss der Aufrufer es aktualisieren, indem er diesen Setter mit einem neuen gültigen Token aufruft. Andernfalls treten bei der Erkennung Fehler auf.

Parameter:

token - Autorisierungstoken.

startContinuousRecognitionAsync

public Future startContinuousRecognitionAsync()

Startet die Spracherkennung für einen kontinuierlichen Audiostream, bis stopContinuousRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.

Gibt zurück:

Eine Aufgabe, die den asynchronen Vorgang darstellt, der die Erkennung startet.

startKeywordRecognitionAsync

public Future startKeywordRecognitionAsync(KeywordRecognitionModel model)

Konfiguriert die Erkennung mit dem angegebenen Schlüsselwort (keyword)-Modell. Nach dem Aufrufen dieser Methode lauscht die Erkennung auf den Schlüsselwort (keyword), um die Erkennung zu starten. Rufen Sie stopKeywordRecognitionAsync() auf, um die Schlüsselwort (keyword) initiierte Erkennung zu beenden. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.

Parameter:

model - Das Schlüsselwort (keyword) Erkennungsmodell, das die zu erkennende Schlüsselwort (keyword) angibt.

Gibt zurück:

Eine Aufgabe, die den asynchronen Vorgang darstellt, der die Erkennung startet.

stopContinuousRecognitionAsync

public Future stopContinuousRecognitionAsync()

Beendet einen ausgeführten Erkennungsvorgang so schnell wie möglich und fordert sofort ein Ergebnis basierend auf der Eingabe an, die bisher verarbeitet wurde. Dies funktioniert für alle Erkennungsvorgänge, nicht nur für fortlaufende Vorgänge, und erleichtert die Verwendung von Push-to-Talk- oder "Jetzt beenden"-Schaltflächen für manuelle Audioendpunkte.

Gibt zurück:

Eine Zukunft, die abgeschlossen wird, wenn die Eingabeverarbeitung beendet wurde. Die Ergebnisgenerierung kann, falls für die angegebene Eingabe zutreffend, nach Abschluss dieser Aufgabe erfolgen und sollte mit dem entsprechenden Ereignis behandelt werden.

stopKeywordRecognitionAsync

public Future stopKeywordRecognitionAsync()

Beendet die Schlüsselwort (keyword) initiierte Erkennung.

Gibt zurück:

Eine Aufgabe, die den asynchronen Vorgang darstellt, der die Erkennung beendet.