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
Speech |
Constructor SpeechRecognizer. |
Propiedades
authorization |
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. |
endpoint |
Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz. |
internal |
|
output |
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. |
speech |
Obtiene el idioma hablado del reconocimiento. |
telemetry |
Este método devuelve el estado actual de la configuración de telemetría. |
Propiedades heredadas
session |
Define el controlador de eventos para los eventos iniciados por la sesión. |
session |
Define el controlador de eventos para los eventos detenidos de sesión. |
speech |
Define el controlador de eventos para los eventos detenidos por voz. |
speech |
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 . |
From |
Constructor SpeechRecognizer. |
recognize |
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. |
start |
Inicia el reconocimiento de voz, hasta que se llama a stopContinuousRecognitionAsync(). El usuario debe suscribirse a eventos para recibir resultados de reconocimiento. |
start |
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. |
stop |
Detiene el reconocimiento continuo de voz. |
stop |
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
enable |
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