Compartir a través de


SpeechRecognizer class

Realiza el reconocimiento de voz desde micrófono, archivo u otras secuencias de entrada de audio y obtiene texto transcrito como resultado.

Extends

Constructores

SpeechRecognizer(SpeechConfig, AudioConfig)

Constructor SpeechRecognizer.

Propiedades

authorizationToken

Obtiene el token de autorización usado para comunicarse con el servicio.

canceled

El evento canceló indica que se produjo un error durante el reconocimiento.

endpointId

Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz.

internalData
outputFormat

Obtiene el formato de salida del reconocimiento.

properties

Colección de propiedades y sus valores definidos para speechRecognizer.

recognized

El evento reconocido indica que se recibe un resultado de reconocimiento final.

recognizing

El evento reconoce que se recibe un resultado de reconocimiento intermedio.

speechRecognitionLanguage

Obtiene el idioma hablado del reconocimiento.

telemetryEnabled

Este método devuelve el estado actual de la configuración de telemetría.

Propiedades heredadas

sessionStarted

Define el controlador de eventos para los eventos iniciados por la sesión.

sessionStopped

Define el controlador de eventos para los eventos detenidos de sesión.

speechEndDetected

Define el controlador de eventos para los eventos detenidos por voz.

speechStartDetected

Define el controlador de eventos para los eventos iniciados por voz.

Métodos

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

cierra todos los recursos externos mantenidos por una instancia de esta clase.

dispose(boolean)

Elimina los recursos mantenidos por el objeto .

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Constructor SpeechRecognizer.

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

Inicia el reconocimiento de voz y se detiene después de que se reconozca la primera expresión. La tarea devuelve el texto de reconocimiento como resultado. Nota: RecognizeOnceAsync() devuelve cuando se ha reconocido la primera expresión, por lo que solo es adecuado para el reconocimiento de captura única, como el comando o la consulta. Para el reconocimiento de larga duración, use StartContinuousRecognitionAsync() en su lugar.

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

Inicia el reconocimiento de voz, hasta que se llama a stopContinuousRecognitionAsync(). El usuario debe suscribirse a eventos para recibir resultados de reconocimiento.

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

Inicia el reconocimiento de voz con la detección de palabras clave, hasta que se llama a stopKeywordRecognitionAsync(). El usuario debe suscribirse a eventos para recibir resultados de reconocimiento. Nota: La funcionalidad de detección de palabras clave solo está disponible en el SDK de dispositivos de voz. Esta funcionalidad no se incluye actualmente en el propio SDK.

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

Detiene el reconocimiento continuo de voz.

stopKeywordRecognitionAsync(() => void)

Detiene el reconocimiento continuo de voz. Nota: La funcionalidad de detección de palabras clave solo está disponible en el SDK de dispositivos de voz. Esta funcionalidad no se incluye actualmente en el propio SDK.

Métodos heredados

enableTelemetry(boolean)

Este método habilita o deshabilita la telemetría globalmente.

Detalles del constructor

SpeechRecognizer(SpeechConfig, AudioConfig)

Constructor SpeechRecognizer.

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

Parámetros

speechConfig
SpeechConfig

un conjunto de propiedades iniciales para este reconocedor

audioConfig
AudioConfig

Una configuración de audio opcional asociada al reconocedor

Detalles de las propiedades

authorizationToken

Obtiene el token de autorización usado para comunicarse con el servicio.

string authorizationToken

Valor de propiedad

string

Token de autorización.

canceled

El evento canceló indica que se produjo un error durante el reconocimiento.

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

Valor de propiedad

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

endpointId

Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz.

string endpointId

Valor de propiedad

string

el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz.

internalData

object internalData

Valor de propiedad

object

outputFormat

Obtiene el formato de salida del reconocimiento.

OutputFormat outputFormat

Valor de propiedad

Formato de salida del reconocimiento.

properties

Colección de propiedades y sus valores definidos para speechRecognizer.

PropertyCollection properties

Valor de propiedad

Colección de propiedades y sus valores definidos para speechRecognizer.

recognized

El evento reconocido indica que se recibe un resultado de reconocimiento final.

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

Valor de propiedad

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

recognizing

El evento reconoce que se recibe un resultado de reconocimiento intermedio.

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

Valor de propiedad

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

speechRecognitionLanguage

Obtiene el idioma hablado del reconocimiento.

string speechRecognitionLanguage

Valor de propiedad

string

Idioma hablado del reconocimiento.

telemetryEnabled

Este método devuelve el estado actual de la configuración de telemetría.

static boolean telemetryEnabled

Valor de propiedad

boolean

True si la telemetría está habilitada, false en caso contrario.

Detalles de las propiedades heredadas

sessionStarted

Define el controlador de eventos para los eventos iniciados por la sesión.

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

Valor de propiedad

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

Heredado deRecognizer.sessionStarted

sessionStopped

Define el controlador de eventos para los eventos detenidos de sesión.

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

Valor de propiedad

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

Heredado deRecognizer.sessionStopped

speechEndDetected

Define el controlador de eventos para los eventos detenidos por voz.

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

Valor de propiedad

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

Heredado deRecognizer.speechEndDetected

speechStartDetected

Define el controlador de eventos para los eventos iniciados por voz.

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

Valor de propiedad

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

Heredado deRecognizer.speechStartDetected

Detalles del método

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

cierra todos los recursos externos mantenidos por una instancia de esta clase.

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

Parámetros

cb

() => void

errorCb

(error: string) => void

dispose(boolean)

Elimina los recursos mantenidos por el objeto .

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

Parámetros

disposing

boolean

true si se elimina el objeto .

Devoluciones

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Constructor SpeechRecognizer.

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

Parámetros

speechConfig
SpeechConfig

un conjunto de propiedades iniciales para este reconocedor

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

Configuración de detección de idioma de origen asociada al reconocedor

audioConfig
AudioConfig

Una configuración de audio opcional asociada al reconocedor

Devoluciones

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

Inicia el reconocimiento de voz y se detiene después de que se reconozca la primera expresión. La tarea devuelve el texto de reconocimiento como resultado. Nota: RecognizeOnceAsync() devuelve cuando se ha reconocido la primera expresión, por lo que solo es adecuado para el reconocimiento de captura única, como el comando o la consulta. Para el reconocimiento de larga duración, use StartContinuousRecognitionAsync() en su lugar.

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

Parámetros

cb

(e: SpeechRecognitionResult) => void

Devolución de llamada que recibió SpeechRecognitionResult.

err

(e: string) => void

Devolución de llamada invocada en caso de error.

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

Inicia el reconocimiento de voz, hasta que se llama a stopContinuousRecognitionAsync(). El usuario debe suscribirse a eventos para recibir resultados de reconocimiento.

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

Parámetros

cb

() => void

Devolución de llamada invocada una vez iniciado el reconocimiento.

err

(e: string) => void

Devolución de llamada invocada en caso de error.

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

Inicia el reconocimiento de voz con la detección de palabras clave, hasta que se llama a stopKeywordRecognitionAsync(). El usuario debe suscribirse a eventos para recibir resultados de reconocimiento. Nota: La funcionalidad de detección de palabras clave solo está disponible en el SDK de dispositivos de voz. Esta funcionalidad no se incluye actualmente en el propio SDK.

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

Parámetros

model
KeywordRecognitionModel

Modelo de reconocimiento de palabras clave que especifica la palabra clave que se va a reconocer.

cb

() => void

Devolución de llamada invocada una vez iniciado el reconocimiento.

err

(e: string) => void

Devolución de llamada invocada en caso de error.

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

Detiene el reconocimiento continuo de voz.

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

Parámetros

cb

() => void

Devolución de llamada invocada una vez detenido el reconocimiento.

err

(e: string) => void

Devolución de llamada invocada en caso de error.

stopKeywordRecognitionAsync(() => void)

Detiene el reconocimiento continuo de voz. Nota: La funcionalidad de detección de palabras clave solo está disponible en el SDK de dispositivos de voz. Esta funcionalidad no se incluye actualmente en el propio SDK.

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

Parámetros

cb

() => void

Devolución de llamada invocada una vez detenido el reconocimiento.

Detalles de los métodos heredados

enableTelemetry(boolean)

Este método habilita o deshabilita la telemetría globalmente.

static function enableTelemetry(enabled: boolean)

Parámetros

enabled

boolean

Configuración global para la recopilación de telemetría. Si se establece en true, la información de telemetría, como los errores de micrófono, los errores de reconocimiento se recopilan y envían a Microsoft. Si se establece en false, no se envía telemetría a Microsoft.

Heredado deRecognizer.enableTelemetry