Partager via


SpeechRecognizer class

Effectue la reconnaissance vocale à partir d’un microphone, d’un 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 annulé indique 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 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

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

ferme toutes les ressources externes détenues par un 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 comme résultat. 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 mot clé spotting, 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 vocale continue.

stopKeywordRecognitionAsync(() => 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

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 annulé indique 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 vocal 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 reconnu indique 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 signale 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 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

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

ferme toutes les ressources externes détenues par un 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 la 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 comme résultat. 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: SpeechRecognitionResult) => void, err?: (e: string) => void)

Paramètres

cb

(e: SpeechRecognitionResult) => void

Rappel qui a reçu le 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 mot clé spotting, 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

Le modèle de reconnaissance mot clé qui spécifie les 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 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)

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 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