IntentRecognizer class

  • Referenz
Paket:
microsoft-cognitiveservices-speech-sdk

Absichtserkennung.

Extends
Recognizer

Konstruktoren

IntentRecognizer(SpeechConfig, AudioConfig)

Initialisiert eine Instanz von IntentRecognizer.

Eigenschaften

authorizationToken

Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird. Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird. Hinweis: Verwenden Sie ein Token, das von Ihrem LanguageUnderstanding-Abonnementschlüssel für die Absichtserkennung abgeleitet ist.
canceled

Das abgebrochene Ereignis signalisiert, dass während der Erkennung ein Fehler aufgetreten ist.
properties

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

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

Das Ereignis, das erkennt, signalisiert, dass ein Zwischenerkennungsergebnis empfangen wird.
speechRecognitionLanguage

Ruft die gesprochene Erkennungssprache ab.
telemetryEnabled

Diese Methode gibt den aktuellen Zustand der Telemetrieeinstellung zurück.

Geerbte Eigenschaften

sessionStarted

Definiert den Ereignishandler für ereignisse, die mit der Sitzung gestartet wurden.
sessionStopped

Definiert den Ereignishandler für beendete Ereignisse der Sitzung.
speechEndDetected

Definiert den Ereignishandler für sprachstoppte Ereignisse.
speechStartDetected

Definiert den Ereignishandler für sprachaktivierte Ereignisse.

Methoden

addAllIntents(LanguageUnderstandingModel, string)
addIntent(string, string)

Fügt einen Ausdruck hinzu, der als Absicht erkannt werden soll.
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

Fügt eine Absicht aus Language Understanding Dienst zur Erkennung hinzu.
close(() => void, (error: string) => void)

schließt alle externen Ressourcen, die von einer Instanz dieser Klasse gehalten werden.
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

Startet die Absichtserkennung und wird beendet, nachdem die erste Äußerung erkannt wurde. Der Task gibt den Erkennungstext und die Absicht als Ergebnis zurück. Hinweis: RecognizeOnceAsync() gibt zurück, wenn die erste Äußerung erkannt wurde, sodass sie nur für die Einzelschusserkennung wie Befehl oder Abfrage geeignet ist. Verwenden Sie für die Erkennung mit langer Laufzeit stattdessen StartContinuousRecognitionAsync().
startContinuousRecognitionAsync(() => void, (e: string) => void)

Startet die Spracherkennung, bis stopContinuousRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

Startet die Spracherkennung mit Schlüsselworterkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Key Word-Spotting-Funktionalität ist nur im Speech Devices SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.
stopContinuousRecognitionAsync(() => void, (e: string) => void)

Beendet die kontinuierliche Absichtserkennung.
stopKeywordRecognitionAsync(() => void, (e: string) => void)

Stoppt die kontinuierliche Spracherkennung. Hinweis: Key Word-Spotting-Funktionalität ist nur im Speech Devices SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

Geerbte Methoden

enableTelemetry(boolean)

Diese Methode aktiviert oder deaktiviert Telemetriedaten global.

Details zum Konstruktor

IntentRecognizer(SpeechConfig, AudioConfig)

Initialisiert eine Instanz von IntentRecognizer.

new IntentRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)

Parameter

speechConfig
SpeechConfig

Der Satz der Konfigurationseigenschaften.

audioConfig
AudioConfig

Eine optionale Audioeingabekonfiguration, die der Erkennung zugeordnet ist

Details zur Eigenschaft

authorizationToken

Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird. Ruft das Autorisierungstoken ab, das für die Kommunikation mit dem Dienst verwendet wird. Hinweis: Verwenden Sie ein Token, das von Ihrem LanguageUnderstanding-Abonnementschlüssel für die Absichtserkennung abgeleitet ist.

string authorizationToken

Eigenschaftswert

string

Autorisierungstoken.

canceled

Das abgebrochene Ereignis signalisiert, dass während der Erkennung ein Fehler aufgetreten ist.

public canceled: (sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

Eigenschaftswert

(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

properties

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

PropertyCollection properties

Eigenschaftswert

PropertyCollection

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

recognized

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

public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

Eigenschaftswert

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

recognizing

Das Ereignis, das erkennt, signalisiert, dass ein Zwischenerkennungsergebnis empfangen wird.

public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

Eigenschaftswert

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

speechRecognitionLanguage

Ruft die gesprochene Erkennungssprache ab.

string speechRecognitionLanguage

Eigenschaftswert

string

die gesprochene Erkennungssprache.

telemetryEnabled

Diese Methode gibt den aktuellen Zustand der Telemetrieeinstellung zurück.

static boolean telemetryEnabled

Eigenschaftswert

boolean

true, wenn die Telemetrie aktiviert ist, andernfalls false.

Geerbte Eigenschaftsdetails

sessionStarted

Definiert den Ereignishandler für ereignisse, die mit der Sitzung gestartet wurden.

public sessionStarted: (sender: Recognizer, event: SessionEventArgs) => void

Eigenschaftswert

(sender: Recognizer, event: SessionEventArgs) => void

Geerbt vonRecognizer.sessionStarted

sessionStopped

Definiert den Ereignishandler für beendete Ereignisse der Sitzung.

public sessionStopped: (sender: Recognizer, event: SessionEventArgs) => void

Eigenschaftswert

(sender: Recognizer, event: SessionEventArgs) => void

Geerbt vonRecognizer.sessionStopped

speechEndDetected

Definiert den Ereignishandler für sprachstoppte Ereignisse.

public speechEndDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

Eigenschaftswert

(sender: Recognizer, event: RecognitionEventArgs) => void

Geerbt vonRecognizer.speechEndDetected

speechStartDetected

Definiert den Ereignishandler für sprachaktivierte Ereignisse.

public speechStartDetected: (sender: Recognizer, event: RecognitionEventArgs) => void

Eigenschaftswert

(sender: Recognizer, event: RecognitionEventArgs) => void

Geerbt vonRecognizer.speechStartDetected

Details zur Methode

addAllIntents(LanguageUnderstandingModel, string) 

function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)

Parameter

model
LanguageUnderstandingModel

Das Sprachverständnismodell, das die Absichten enthält.

intentId

string

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

addIntent(string, string)

Fügt einen Ausdruck hinzu, der als Absicht erkannt werden soll.

function addIntent(simplePhrase: string, intentId?: string)

Parameter

simplePhrase

string

intentId

string

Eine Zeichenfolge, die den Bezeichner der zu erkennenden Absicht darstellt.

addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

Fügt eine Absicht aus Language Understanding Dienst zur Erkennung hinzu.

function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)

Parameter

intentId

string

Eine Zeichenfolge, die den Bezeichner der zu erkennenden Absicht darstellt. Wird ignoriert, wenn intentName leer ist.

model
LanguageUnderstandingModel

Das Absichtsmodell aus Language Understanding Dienst.

intentName

string

Der im Absichtsmodell definierte Absichtsname. Wenn es leer ist, werden alle im Modell definierten Absichtsnamen hinzugefügt.

close(() => void, (error: string) => void)

schließt alle externen Ressourcen, die von einer Instanz dieser Klasse gehalten werden.

function close(cb?: () => void, errorCb?: (error: string) => void)

Parameter

cb

() => void

errorCb

(error: string) => void

recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)

Startet die Absichtserkennung und wird beendet, nachdem die erste Äußerung erkannt wurde. Der Task gibt den Erkennungstext und die Absicht als Ergebnis zurück. Hinweis: RecognizeOnceAsync() gibt zurück, wenn die erste Äußerung erkannt wurde, sodass sie nur für die Einzelschusserkennung wie Befehl oder Abfrage geeignet ist. Verwenden Sie für die Erkennung mit langer Laufzeit stattdessen StartContinuousRecognitionAsync().

function recognizeOnceAsync(cb?: (e: IntentRecognitionResult) => void, err?: (e: string) => void)

Parameter

cb

(e: IntentRecognitionResult) => void

Rückruf, der die Erkennung erhalten hat, wurde mit einem IntentRecognitionResult abgeschlossen.

err

(e: string) => void

Rückruf, der im Falle eines Fehlers aufgerufen wird.

startContinuousRecognitionAsync(() => void, (e: string) => void)

Startet die Spracherkennung, bis stopContinuousRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten.

function startContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Parameter

cb

() => void

Rückruf wird aufgerufen, sobald die Erkennung gestartet wurde.

err

(e: string) => void

Rückruf, der im Falle eines Fehlers aufgerufen wird.

startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)

Startet die Spracherkennung mit Schlüsselworterkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Key Word-Spotting-Funktionalität ist nur im Speech Devices SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

function startKeywordRecognitionAsync(model: KeywordRecognitionModel, cb?: () => void, err?: (e: string) => void)

Parameter

model
KeywordRecognitionModel

Das Schlüsselworterkennungsmodell, das das zu erkennende Schlüsselwort angibt.

cb

() => void

Rückruf wird aufgerufen, sobald die Erkennung gestartet wurde.

err

(e: string) => void

Rückruf, der im Falle eines Fehlers aufgerufen wird.

stopContinuousRecognitionAsync(() => void, (e: string) => void)

Beendet die kontinuierliche Absichtserkennung.

function stopContinuousRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Parameter

cb

() => void

Rückruf wird aufgerufen, sobald die Erkennung beendet wurde.

err

(e: string) => void

Rückruf, der im Falle eines Fehlers aufgerufen wird.

stopKeywordRecognitionAsync(() => void, (e: string) => void)

Stoppt die kontinuierliche Spracherkennung. Hinweis: Key Word-Spotting-Funktionalität ist nur im Speech Devices SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

function stopKeywordRecognitionAsync(cb?: () => void, err?: (e: string) => void)

Parameter

cb

() => void

Rückruf wird aufgerufen, sobald die Erkennung beendet wurde.

err

(e: string) => void

Rückruf, der im Falle eines Fehlers aufgerufen wird.

Details zur geerbten Methode

enableTelemetry(boolean)

Diese Methode aktiviert oder deaktiviert Telemetriedaten global.

static function enableTelemetry(enabled: boolean)

Parameter

enabled

boolean

Globale Einstellung für die Telemetriesammlung. Wenn auf true festgelegt ist, werden Telemetrieinformationen wie Mikrofonfehler, Erkennungsfehler gesammelt und an Microsoft gesendet. Wenn auf false festgelegt ist, werden keine Telemetriedaten an Microsoft gesendet.

Geerbt vonRecognizer.enableTelemetry