Partager via


SpeechRecognizer class

Effectue la reconnaissance vocale à partir du microphone, du fichier ou d’autres flux d’entrée audio, et obtient ainsi du texte transcrit.

Extends

Constructeurs

SpeechRecognizer(SpeechConfig, AudioConfig)

Constructeur SpeechRecognizer.

Propriétés

authorizationToken

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

canceled

L’événement a annulé les signaux indiquant qu’une erreur s’est produite lors de la reconnaissance.

endpointId

Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale.

internalData
outputFormat

Obtient le format de sortie de la reconnaissance.

properties

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

recognized

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

recognizing

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

speechRecognitionLanguage

Obtient la langue parlée de la 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 de session.

speechEndDetected

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

speechStartDetected

Définit le gestionnaire d’événements pour les événements speech démarrés.

Méthodes

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

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

dispose(boolean)

Supprime toutes les ressources détenues par l’objet.

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Constructeur SpeechRecognizer.

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

Démarre la reconnaissance vocale et s’arrête une fois que le premier énoncé est reconnu. La tâche retourne le texte de reconnaissance en conséquence. Remarque : RecognizeOnceAsync() retourne lorsque le premier énoncé a été reconnu, de sorte qu’il convient uniquement à la reconnaissance de capture unique comme la commande ou la requête. Pour la reconnaissance longue, 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 mot clé, 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 de mots clés n’est disponible que 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 vocale continue.

stopKeywordRecognitionAsync(() => void)

Arrête la reconnaissance vocale continue. Remarque : La fonctionnalité de détection de mots clés n’est disponible que 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

SpeechRecognizer(SpeechConfig, AudioConfig)

Constructeur SpeechRecognizer.

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

Paramètres

speechConfig
SpeechConfig

un ensemble de propriétés initiales pour ce module de reconnaissance

audioConfig
AudioConfig

Configuration 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 a annulé les signaux indiquant qu’une erreur s’est produite lors de la reconnaissance.

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

Valeur de propriété

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

endpointId

Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale.

string endpointId

Valeur de propriété

string

ID de point de terminaison d’un modèle de reconnaissance vocale personnalisé utilisé pour la reconnaissance vocale.

internalData

object internalData

Valeur de propriété

object

outputFormat

Obtient le format de sortie de la reconnaissance.

OutputFormat outputFormat

Valeur de propriété

Format de sortie de la reconnaissance.

properties

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

PropertyCollection properties

Valeur de propriété

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

recognized

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

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

Valeur de propriété

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

recognizing

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

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

Valeur de propriété

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

speechRecognitionLanguage

Obtient la langue parlée de la reconnaissance.

string speechRecognitionLanguage

Valeur de propriété

string

Langue parlée de la 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 sinon.

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ée deRecognizer.sessionStarted

sessionStopped

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

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

Valeur de propriété

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

héritée deRecognizer.sessionStopped

speechEndDetected

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

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

Valeur de propriété

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

héritée deRecognizer.speechEndDetected

speechStartDetected

Définit le gestionnaire d’événements pour les événements speech démarrés.

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

Valeur de propriété

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

héritée deRecognizer.speechStartDetected

Détails de la méthode

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

dispose(boolean)

Supprime toutes les ressources détenues par l’objet.

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

Paramètres

disposing

boolean

true si vous éliminez l’objet.

Retours

Promise<void>

FromConfig(SpeechConfig, AutoDetectSourceLanguageConfig, AudioConfig)

Constructeur SpeechRecognizer.

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

Paramètres

speechConfig
SpeechConfig

un ensemble de propriétés initiales pour ce module de reconnaissance

autoDetectSourceLanguageConfig
AutoDetectSourceLanguageConfig

Configuration de détection de langue source associée au module de reconnaissance

audioConfig
AudioConfig

Configuration audio facultative associée au module de reconnaissance

Retours

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

Démarre la reconnaissance vocale et s’arrête une fois que le premier énoncé est reconnu. La tâche retourne le texte de reconnaissance en conséquence. Remarque : RecognizeOnceAsync() retourne lorsque le premier énoncé a été reconnu, de sorte qu’il convient uniquement à la reconnaissance de capture unique comme la commande ou la requête. Pour la reconnaissance longue, utilisez Plutôt StartContinuousRecognitionAsync().

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

Paramètres

cb

(e: SpeechRecognitionResult) => void

Rappel qui a reçu speechRecognitionResult.

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 mot clé, 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 de mots clés n’est disponible que 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 vocale continue.

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)

Arrête la reconnaissance vocale continue. Remarque : La fonctionnalité de détection de mots clés n’est disponible que 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)

Paramètres

cb

() => void

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

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 données de télémétrie. Si la valeur est true, les informations de télémétrie telles que les erreurs de microphone, 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ée deRecognizer.enableTelemetry