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
Speech |
Constructeur SpeechRecognizer. |
Propriétés
authorization |
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. |
endpoint |
Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale. |
internal |
|
output |
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. |
speech |
Obtient la langue parlée de la reconnaissance. |
telemetry |
Cette méthode retourne l’état actuel du paramètre de télémétrie. |
Propriétés héritées
session |
Définit le gestionnaire d’événements pour les événements démarrés par la session. |
session |
Définit le gestionnaire d’événements pour les événements arrêtés de session. |
speech |
Définit le gestionnaire d’événements pour les événements arrêtés par reconnaissance vocale. |
speech |
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. |
From |
Constructeur SpeechRecognizer. |
recognize |
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(). |
start |
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. |
start |
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). |
stop |
Arrête la reconnaissance vocale continue. |
stop |
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
enable |
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