Freigeben über


SpeechRecognizer class

Führt die Spracherkennung aus Mikrofon, Datei oder anderen Audioeingabedatenströmen 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 hat signalisiert, dass während der Erkennung ein Fehler aufgetreten ist.

endpointId

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

internalData
outputFormat

Ruft das Ausgabeformat der Erkennung ab.

properties

Die Sammlung von Eigenschaften und deren Werten, die für diesen SpeechRecognizer definiert sind.

recognized

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

recognizing

Das Ereignis erkennt Signale, dass ein Zwischenerkennungsergebnis empfangen wird.

speechRecognitionLanguage

Ruft die gesprochene Sprache der Erkennung ab.

telemetryEnabled

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

Geerbte Eigenschaften

sessionStarted

Definiert den Ereignishandler für Sitzungsstartereignisse.

sessionStopped

Definiert den Ereignishandler für beendete Sitzungsereignisse.

speechEndDetected

Definiert den Ereignishandler für angehaltene Sprachereignisse.

speechStartDetected

Definiert den Ereignishandler für Sprachstartereignisse.

Methoden

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

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

dispose(boolean)

Disposes any resources held by the object.

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

SpeechRecognizer-Konstruktor.

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

Startet die Spracherkennung und stoppt, nachdem die erste Äußerung erkannt wurde. Der Vorgang gibt den Erkennungstext als Ergebnis 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 lang andauernde Erkennung 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 Stichworterkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Schlüsselworterkennungsfunktionen sind nur im Sprachgeräte-SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

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

Stoppt die kontinuierliche Spracherkennung.

stopKeywordRecognitionAsync(() => void)

Stoppt die kontinuierliche Spracherkennung. Hinweis: Schlüsselworterkennungsfunktionen sind nur im Sprachgeräte-SDK verfügbar. Diese Funktionalität ist derzeit nicht im SDK selbst enthalten.

Geerbte Methoden

enableTelemetry(boolean)

Diese Methode aktiviert oder deaktiviert Telemetrie 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 hat signalisiert, 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 angepassten 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 Sammlung von Eigenschaften und deren Werten, die für diesen SpeechRecognizer definiert sind.

PropertyCollection properties

Eigenschaftswert

Die Sammlung von Eigenschaften und deren Werten, die für diesen SpeechRecognizer definiert sind.

recognized

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

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

Eigenschaftswert

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

recognizing

Das Ereignis erkennt Signale, dass ein Zwischenerkennungsergebnis empfangen wird.

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

Eigenschaftswert

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

speechRecognitionLanguage

Ruft die gesprochene Sprache der Erkennung ab.

string speechRecognitionLanguage

Eigenschaftswert

string

Die gesprochene Sprache der Erkennung.

telemetryEnabled

Diese Methode gibt den aktuellen Status 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 Sitzungsstartereignisse.

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

Eigenschaftswert

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

geerbt vonRecognizer.sessionStarted

sessionStopped

Definiert den Ereignishandler für beendete Sitzungsereignisse.

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

Eigenschaftswert

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

geerbt vonRecognizer.sessionStopped

speechEndDetected

Definiert den Ereignishandler für angehaltene Sprachereignisse.

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

Eigenschaftswert

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

vonRecognizer.speechEndDetected

speechStartDetected

Definiert den Ereignishandler für Sprachstartereignisse.

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

Eigenschaftswert

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

vonRecognizer.speechStartDetected

Details zur Methode

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

dispose(boolean)

Disposes any resources held by the object.

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 dem Erkennungsmodul 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 stoppt, nachdem die erste Äußerung erkannt wurde. Der Vorgang gibt den Erkennungstext als Ergebnis 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 lang andauernde Erkennung stattdessen "StartContinuousRecognitionAsync()".

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

Parameter

cb

(e: SpeechRecognitionResult) => void

Rückruf, der das SpeechRecognitionResult empfangen hat.

err

(e: string) => void

Rückruf, der bei einem Fehler 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 bei einem Fehler aufgerufen wird.

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

Startet die Spracherkennung mit Stichworterkennung, bis stopKeywordRecognitionAsync() aufgerufen wird. Der Benutzer muss Ereignisse abonnieren, um Erkennungsergebnisse zu erhalten. Hinweis: Schlüsselworterkennungsfunktionen sind nur im Sprachgeräte-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, nachdem die Erkennung gestartet wurde.

err

(e: string) => void

Rückruf, der bei einem Fehler aufgerufen wird.

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

Stoppt 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 bei einem Fehler aufgerufen wird.

stopKeywordRecognitionAsync(() => void)

Stoppt die kontinuierliche Spracherkennung. Hinweis: Schlüsselworterkennungsfunktionen sind nur im Sprachgeräte-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 Telemetrie global.

static function enableTelemetry(enabled: boolean)

Parameter

enabled

boolean

Globale Einstellung für telemetrieauflistung. Wenn dieser Wert auf "true" festgelegt ist, werden Telemetrieinformationen wie Mikrofonfehler erfasst und an Microsoft gesendet. Wenn dieser Wert auf "false" festgelegt ist, wird keine Telemetrie an Microsoft gesendet.

Geerbt vonRecognizer.enableTelemetry