IntentRecognizer class

Paquet:

microsoft-cognitiveservices-speech-sdk

Module de reconnaissance d’intention.

Extends

Recognizer

Constructeurs

IntentRecognizer(SpeechConfig, AudioConfig)

Initialise une instance de IntentRecognizer.

Propriétés

authorizationToken	Obtient le jeton d’autorisation utilisé pour communiquer avec le service.
canceled	L’événement annulé indique qu’une erreur s’est produite lors de la reconnaissance.
internalData
properties	Collection de propriétés et leurs valeurs définies pour ce IntentRecognizer.
recognized	L’événement reconnu indique qu’un résultat de reconnaissance final est reçu.
recognizing	L’événement reconnaissant signale qu’un résultat de reconnaissance intermédiaire est reçu.
speechRecognitionLanguage	Obtient la langue parlée de reconnaissance.
telemetryEnabled	Cette méthode retourne l’état actuel du paramètre de télémétrie.

Propriétés héritées

sessionStarted	Définit le gestionnaire d’événements pour les événements démarrés par la session.
sessionStopped	Définit le gestionnaire d’événements pour les événements arrêtés par la session.
speechEndDetected	Définit le gestionnaire d’événements pour les événements d’arrêt vocal.
speechStartDetected	Définit le gestionnaire d’événements pour les événements de démarrage vocal.

Méthodes

addAllIntents(LanguageUnderstandingModel, string)
addIntent(string, string)	Ajoute une expression qui doit être reconnue comme intention.
addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)	Ajoute une intention de Language Understanding service pour la reconnaissance.
close(() => void, (error: string) => void)	ferme toutes les ressources externes détenues par une instance de cette classe.
recognizeOnceAsync((e: IntentRecognitionResult) => void, (e: string) => void)	Démarre la reconnaissance des intentions et s’arrête une fois que le premier énoncé est reconnu. La tâche retourne le texte de reconnaissance et l’intention en conséquence. Remarque : RecognizeOnceAsync() retourne lorsque le premier énoncé a été reconnu. Il convient donc uniquement à la reconnaissance par capture unique comme une commande ou une requête. Pour une reconnaissance longue durée, utilisez plutôt StartContinuousRecognitionAsync().
startContinuousRecognitionAsync(() => void, (e: string) => void)	Démarre la reconnaissance vocale, jusqu’à ce que stopContinuousRecognitionAsync() soit appelé. L’utilisateur doit s’abonner aux événements pour recevoir les résultats de la reconnaissance.
startKeywordRecognitionAsync(KeywordRecognitionModel, () => void, (e: string) => void)	Démarre la reconnaissance vocale avec la détection de mots clés, jusqu’à ce que stopKeywordRecognitionAsync() soit appelé. L’utilisateur doit s’abonner aux événements pour recevoir les résultats de la reconnaissance. Remarque : La fonctionnalité de détection des mots clés est disponible uniquement sur le Kit de développement logiciel (SDK) Speech Devices. Cette fonctionnalité n’est actuellement pas incluse dans le Kit de développement logiciel (SDK).
stopContinuousRecognitionAsync(() => void, (e: string) => void)	Arrête la reconnaissance continue de l’intention.
stopKeywordRecognitionAsync(() => void, (e: string) => void)	Arrête la reconnaissance vocale continue. Remarque : La fonctionnalité de détection des mots clés est disponible uniquement sur le Kit de développement logiciel (SDK) Speech Devices. Cette fonctionnalité n’est actuellement pas incluse dans le Kit de développement logiciel (SDK).

Méthodes héritées

enableTelemetry(boolean)

Cette méthode active ou désactive globalement la télémétrie.

Détails du constructeur

IntentRecognizer(SpeechConfig, AudioConfig)

Initialise une instance de IntentRecognizer.

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

Paramètres

speechConfig

SpeechConfig

Ensemble de propriétés de configuration.

audioConfig

AudioConfig

Configuration d’entrée audio facultative associée au module de reconnaissance

Détails de la propriété

authorizationToken

Obtient le jeton d’autorisation utilisé pour communiquer avec le service.

string authorizationToken

Valeur de propriété

string

Jeton d’autorisation,

canceled

L’événement annulé indique qu’une erreur s’est produite lors de la reconnaissance.

public canceled: (sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

Valeur de propriété

(sender: IntentRecognizer, event: IntentRecognitionCanceledEventArgs) => void

internalData

object internalData

Valeur de propriété

object

properties

Collection de propriétés et leurs valeurs définies pour ce IntentRecognizer.

PropertyCollection properties

Valeur de propriété

PropertyCollection

Collection de propriétés et leurs valeurs définies pour ce IntentRecognizer.

recognized

L’événement reconnu indique qu’un résultat de reconnaissance final est reçu.

public recognized: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

Valeur de propriété

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

recognizing

L’événement reconnaissant signale qu’un résultat de reconnaissance intermédiaire est reçu.

public recognizing: (sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

Valeur de propriété

(sender: IntentRecognizer, event: IntentRecognitionEventArgs) => void

speechRecognitionLanguage

Obtient la langue parlée de reconnaissance.

string speechRecognitionLanguage

Valeur de propriété

string

langue parlée de reconnaissance.

telemetryEnabled

Cette méthode retourne l’état actuel du paramètre de télémétrie.

static boolean telemetryEnabled

Valeur de propriété

boolean

true si la télémétrie est activée, false dans le cas contraire.

Détails de la propriété héritée

sessionStarted

Définit le gestionnaire d’événements pour les événements démarrés par la session.

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

Valeur de propriété

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

Hérité deRecognizer.sessionStarted

sessionStopped

Définit le gestionnaire d’événements pour les événements arrêtés par la session.

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

Valeur de propriété

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

Hérité deRecognizer.sessionStopped

speechEndDetected

Définit le gestionnaire d’événements pour les événements d’arrêt vocal.

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

Valeur de propriété

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

Hérité deRecognizer.speechEndDetected

speechStartDetected

Définit le gestionnaire d’événements pour les événements de démarrage vocal.

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

Valeur de propriété

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

Hérité deRecognizer.speechStartDetected

Détails de la méthode

addAllIntents(LanguageUnderstandingModel, string)

function addAllIntents(model: LanguageUnderstandingModel, intentId?: string)

Paramètres

model

LanguageUnderstandingModel

Modèle de compréhension du langage contenant les intentions.

intentId

string

Chaîne d’id personnalisée à retourner dans la méthode getIntentId() de IntentRecognitionResult.

addIntent(string, string)

Ajoute une expression qui doit être reconnue comme intention.

function addIntent(simplePhrase: string, intentId?: string)

Paramètres

simplePhrase

string

intentId

string

Chaîne qui représente l’identificateur de l’intention à reconnaître.

addIntentWithLanguageModel(string, LanguageUnderstandingModel, string)

Ajoute une intention de Language Understanding service pour la reconnaissance.

function addIntentWithLanguageModel(intentId: string, model: LanguageUnderstandingModel, intentName?: string)

Paramètres

intentId

string

Chaîne qui représente l’identificateur de l’intention à reconnaître. Ignoré si intentName est vide.

model

LanguageUnderstandingModel

Modèle d’intention de Language Understanding service.

intentName

string

Nom d’intention défini dans le modèle d’intention. S’il est vide, tous les noms d’intention définis dans le modèle seront ajoutés.

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

ferme toutes les ressources externes détenues par une instance de cette classe.

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

Paramètres

cb

() => void

errorCb

(error: string) => void

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

Démarre la reconnaissance des intentions et s’arrête une fois que le premier énoncé est reconnu. La tâche retourne le texte de reconnaissance et l’intention en conséquence. Remarque : RecognizeOnceAsync() retourne lorsque le premier énoncé a été reconnu. Il convient donc uniquement à la reconnaissance par capture unique comme une commande ou une requête. Pour une reconnaissance longue durée, utilisez plutôt StartContinuousRecognitionAsync().

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

Paramètres

cb

(e: IntentRecognitionResult) => void

Le rappel qui a reçu la reconnaissance s’est terminé avec un IntentRecognitionResult.

err

(e: string) => void

Rappel appelé en cas d’erreur.

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

Démarre la reconnaissance vocale, jusqu’à ce que stopContinuousRecognitionAsync() soit appelé. L’utilisateur doit s’abonner aux événements pour recevoir les résultats de la reconnaissance.

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

Paramètres

cb

() => void

Rappel appelé une fois la reconnaissance démarrée.

err

(e: string) => void

Rappel appelé en cas d’erreur.

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

Démarre la reconnaissance vocale avec la détection de mots clés, jusqu’à ce que stopKeywordRecognitionAsync() soit appelé. L’utilisateur doit s’abonner aux événements pour recevoir les résultats de la reconnaissance. Remarque : La fonctionnalité de détection des mots clés est disponible uniquement sur le Kit de développement logiciel (SDK) Speech Devices. Cette fonctionnalité n’est actuellement pas incluse dans le Kit de développement logiciel (SDK).

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

Paramètres

model

KeywordRecognitionModel

Modèle de reconnaissance de mot clé qui spécifie le mot clé à reconnaître.

cb

() => void

Rappel appelé une fois la reconnaissance démarrée.

err

(e: string) => void

Rappel appelé en cas d’erreur.

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

Arrête la reconnaissance continue de l’intention.

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

Paramètres

cb

() => void

Rappel appelé une fois la reconnaissance arrêtée.

err

(e: string) => void

Rappel appelé en cas d’erreur.

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

Arrête la reconnaissance vocale continue. Remarque : La fonctionnalité de détection des mots clés est disponible uniquement sur le Kit de développement logiciel (SDK) Speech Devices. Cette fonctionnalité n’est actuellement pas incluse dans le Kit de développement logiciel (SDK).

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

Paramètres

cb

() => void

Rappel appelé une fois la reconnaissance arrêtée.

err

(e: string) => void

Rappel appelé en cas d’erreur.

Détails de la méthode héritée

enableTelemetry(boolean)

Cette méthode active ou désactive globalement la télémétrie.

static function enableTelemetry(enabled: boolean)

Paramètres

enabled

boolean

Paramètre global pour la collecte de télémétrie. Si la valeur est true, les informations de télémétrie telles que les erreurs de microphone et les erreurs de reconnaissance sont collectées et envoyées à Microsoft. Si la valeur est false, aucune télémétrie n’est envoyée à Microsoft.

Hérité deRecognizer.enableTelemetry