IntentRecognizer class
Reconocedor de intenciones.
- Extends
Constructores
Intent |
Inicializa una instancia de IntentRecognizer. |
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. |
internal |
|
properties | Colección de propiedades y sus valores definidos para este IntentRecognizer. |
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
add |
|
add |
Agrega una frase que se debe reconocer como intención. |
add |
Agrega una intención del servicio Language Understanding para el reconocimiento. |
close(() => void, (error: string) => void) | cierra todos los recursos externos mantenidos por una instancia de esta clase. |
recognize |
Inicia el reconocimiento de intenciones y se detiene después de que se reconozca la primera expresión. La tarea devuelve el texto de reconocimiento y la intención 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 intenciones. |
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
IntentRecognizer(SpeechConfig, AudioConfig)
Inicializa una instancia de IntentRecognizer.
new IntentRecognizer(speechConfig: SpeechConfig, audioConfig?: AudioConfig)
Parámetros
- speechConfig
- SpeechConfig
Conjunto de propiedades de configuración.
- audioConfig
- AudioConfig
Una configuración de entrada 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: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void
Valor de propiedad
(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void
internalData
object internalData
Valor de propiedad
object
properties
Colección de propiedades y sus valores definidos para este IntentRecognizer.
PropertyCollection properties
Valor de propiedad
Colección de propiedades y sus valores definidos para este IntentRecognizer.
recognized
El evento reconocido indica que se recibe un resultado de reconocimiento final.
public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void
Valor de propiedad
(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void
recognizing
El evento reconoce que se recibe un resultado de reconocimiento intermedio.
public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void
Valor de propiedad
(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void
speechRecognitionLanguage
Obtiene el idioma hablado del reconocimiento.
string speechRecognitionLanguage
Valor de propiedad
string
el 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
addAllIntents(LanguageUnderstandingModel, string)
function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)
Parámetros
Modelo de Language Understanding que contiene las intenciones.
- intentId
-
string
Un identificador personalizado String que se va a devolver en el método getIntentId() de IntentRecognitionResult.
addIntent(string, string)
Agrega una frase que se debe reconocer como intención.
function addIntent(simplePhrase: string, intentId?: string)
Parámetros
- simplePhrase
-
string
- intentId
-
string
Cadena que representa el identificador de la intención que se va a reconocer.
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)
Agrega una intención del servicio Language Understanding para el reconocimiento.
function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)
Parámetros
- intentId
-
string
Cadena que representa el identificador de la intención que se va a reconocer. Se omite si intentName está vacío.
Modelo de intención del servicio Language Understanding.
- intentName
-
string
Nombre de intención definido en el modelo de intención. Si está vacío, se agregarán todos los nombres de intención definidos en el modelo.
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
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)
Inicia el reconocimiento de intenciones y se detiene después de que se reconozca la primera expresión. La tarea devuelve el texto de reconocimiento y la intención 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: IntentRecognitionResult) => void, err?: (e: string) => void)
Parámetros
- cb
-
(e: IntentRecognitionResult) => void
La devolución de llamada que recibió el reconocimiento ha finalizado con intentRecognitionResult.
- 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 intenciones.
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, (e: string) => 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, 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.
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