Freigeben über


SpeechRecognizer class

Führt die Spracherkennung von Mikrofon-, Datei- oder anderen Audioeingabestreams aus und ruft als Ergebnis transkribierten Text ab.

Extends

Konstruktoren

SpeechRecognizer(SpeechConfig, AudioConfig)

SpeechRecognizer-Konstruktor.

Eigenschaften

authorizationToken

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

canceled

Das Ereignis wurde abgebrochen, um zu signalisieren, dass während der Erkennung ein Fehler aufgetreten ist.

endpointId

Ruft die Endpunkt-ID eines benutzerdefinierten Sprachmodells ab, das für die Spracherkennung verwendet wird.

internalData
outputFormat

Ruft das Ausgabeformat der Erkennung ab.

properties

Die Auflistung der Eigenschaften und deren Werte, die für dieses SpeechRecognizer definiert sind.

recognized

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

recognizing

Das Ereignis, das erkennt, signalisiert, dass ein zwischengeschaltetes Erkennungsergebnis 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 vom Sitzungsstart gestartet werden.

sessionStopped

Definiert den Ereignishandler für Ereignisse, die angehaltene Sitzungen ausführen.

speechEndDetected

Definiert den Ereignishandler für sprachaktive Ereignisse.

speechStartDetected

Definiert den Ereignishandler für ereignisse, die von der Spracheingabe gestartet wurden.

Methoden

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

schließt alle externen Ressourcen, die von einem instance dieser Klasse gespeichert werden.

dispose(boolean)

Entsorgt alle Ressourcen, die im Objekt gespeichert sind.

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

SpeechRecognizer-Konstruktor.

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

Startet die Spracherkennung und beendet, nachdem die erste Äußerung erkannt wurde. Die Aufgabe gibt als Ergebnis den Erkennungstext zurück. Hinweis: RecognizeOnceAsync() gibt zurück, wenn die erste Äußerung erkannt wurde, sodass sie nur für die Erkennung einzelner Aufnahmen 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üsselwort (keyword) Erkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Die Funktion zum Erkennen von Schlüsselwörtern 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 Spracherkennung.

stopKeywordRecognitionAsync(() => void)

Beendet die kontinuierliche Spracherkennung. Hinweis: Die Funktion zum Erkennen von Schlüsselwörtern 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

SpeechRecognizer(SpeechConfig, AudioConfig)

SpeechRecognizer-Konstruktor.

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

Parameter

speechConfig
SpeechConfig

eine Reihe von anfänglichen Eigenschaften für diese Erkennung

audioConfig
AudioConfig

Eine optionale Audiokonfiguration, die der Erkennung zugeordnet ist

Details zur Eigenschaft

authorizationToken

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

string authorizationToken

Eigenschaftswert

string

Autorisierungstoken.

canceled

Das Ereignis wurde abgebrochen, um zu signalisieren, dass während der Erkennung ein Fehler aufgetreten ist.

public canceled: (sender: Recognizer, event: SpeechRecognitionCanceledEventArgs) => void

Eigenschaftswert

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

endpointId

Ruft die Endpunkt-ID eines benutzerdefinierten Sprachmodells ab, das für die Spracherkennung verwendet wird.

string endpointId

Eigenschaftswert

string

Die Endpunkt-ID eines angepassten Sprachmodells, das für die Spracherkennung verwendet wird.

internalData

object internalData

Eigenschaftswert

object

outputFormat

Ruft das Ausgabeformat der Erkennung ab.

OutputFormat outputFormat

Eigenschaftswert

Das Ausgabeformat der Erkennung.

properties

Die Auflistung der Eigenschaften und deren Werte, die für dieses SpeechRecognizer definiert sind.

PropertyCollection properties

Eigenschaftswert

Die Auflistung der Eigenschaften und deren Werte, die für dieses SpeechRecognizer definiert sind.

recognized

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

public recognized: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Eigenschaftswert

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

recognizing

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

public recognizing: (sender: Recognizer, event: SpeechRecognitionEventArgs) => void

Eigenschaftswert

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

speechRecognitionLanguage

Ruft die gesprochene Erkennungssprache ab.

string speechRecognitionLanguage

Eigenschaftswert

string

Die gesprochene Sprache der Erkennung.

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 vom Sitzungsstart gestartet werden.

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

Eigenschaftswert

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

Geerbt vonRecognizer.sessionStarted

sessionStopped

Definiert den Ereignishandler für Ereignisse, die angehaltene Sitzungen ausführen.

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

Eigenschaftswert

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

Geerbt vonRecognizer.sessionStopped

speechEndDetected

Definiert den Ereignishandler für sprachaktive Ereignisse.

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

Eigenschaftswert

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

Geerbt vonRecognizer.speechEndDetected

speechStartDetected

Definiert den Ereignishandler für ereignisse, die von der Spracheingabe gestartet wurden.

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

Eigenschaftswert

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

Geerbt vonRecognizer.speechStartDetected

Details zur Methode

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

schließt alle externen Ressourcen, die von einem instance dieser Klasse gespeichert werden.

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

Parameter

cb

() => void

errorCb

(error: string) => void

dispose(boolean)

Entsorgt alle Ressourcen, die im Objekt gespeichert sind.

function dispose(disposing: boolean): Promise<void>

Parameter

disposing

boolean

TRUE, wenn das Objekt entfernt wird.

Gibt zurück

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

SpeechRecognizer-Konstruktor.

static function FromConfig(speechConfig: SpeechConfig, autoDetectSourceLanguageConfig: AutoDetectSourceLanguageConfig, audioConfig?: AudioConfig): SpeechRecognizer

Parameter

speechConfig
SpeechConfig

eine Reihe von anfänglichen Eigenschaften für diese Erkennung

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

Eine Der Erkennung zugeordnete Quellspracherkennungskonfiguration

audioConfig
AudioConfig

Eine optionale Audiokonfiguration, die der Erkennung zugeordnet ist

Gibt zurück

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

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

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

Parameter

cb

(e: SpeechRecognitionResult) => void

Rückruf, der speechRecognitionResult empfangen hat.

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, nachdem 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üsselwort (keyword) Erkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Die Funktion zum Erkennen von Schlüsselwörtern 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üsselwort (keyword) Erkennungsmodell, das die zu erkennende Schlüsselwort (keyword) angibt.

cb

() => void

Rückruf wird aufgerufen, nachdem 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 Spracherkennung.

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

Parameter

cb

() => void

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

err

(e: string) => void

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

stopKeywordRecognitionAsync(() => void)

Beendet die kontinuierliche Spracherkennung. Hinweis: Die Funktion zum Erkennen von Schlüsselwörtern ist nur im Speech Devices SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

function stopKeywordRecognitionAsync(cb?: () => void)

Parameter

cb

() => void

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

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 diese Einstellung auf TRUE festgelegt ist, werden Telemetrieinformationen wie Mikrofonfehler, Erkennungsfehler gesammelt und an Microsoft gesendet. Wenn dieser Wert auf false festgelegt ist, werden keine Telemetriedaten an Microsoft gesendet.

Geerbt vonRecognizer.enableTelemetry