classe SpeechConfig

Classe qui définit des configurations pour la reconnaissance ou la synthèse vocale.

Membres

EmbeddedSpeechConfig

Syntaxe : public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntaxe : public friend HybridSpeechConfig;

opérateur SPXSPEECHCONFIGHANDLE

Syntaxe : public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Opérateur interne utilisé pour obtenir la valeur de handle sous-jacente.

Retours

Un handle.

SetSpeechRecognitionLanguage

Syntaxe : public inline void SetSpeechRecognitionLanguage ( const std::string & lang );

Définissez la langue d’entrée sur le module de reconnaissance vocale.

Paramètres

• lang Spécifie le nom de la langue parlée à reconnaître au format BCP-47.

GetSpeechRecognitionLanguage

Syntaxe : public inline std::string GetSpeechRecognitionLanguage ( ) const;

Obtient la langue d’entrée de la reconnaissance vocale. La langue est spécifiée au format BCP-47.

Retours

Langue de reconnaissance vocale.

SetSpeechSynthesisLanguage

Syntaxe : public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

Définit la langue du synthétiseur vocal. Ajouté dans la version 1.4.0.

Paramètres

• lang Spécifie le nom de la langue (par exemple, en-US)

GetSpeechSynthesisLanguage

Syntaxe : public inline std::string GetSpeechSynthesisLanguage ( ) const;

Obtient la langue du synthétiseur vocal. Ajouté dans la version 1.4.0.

Retours

Langage de synthèse vocale.

SetSpeechSynthesisVoiceName

Syntaxe : public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

Définissez la voix du synthétiseur vocal. Ajouté dans la version 1.4.0.

Paramètres

• voiceName Spécifie le nom de la voix

GetSpeechSynthesisVoiceName

Syntaxe : public inline std::string GetSpeechSynthesisVoiceName ( ) const;

Obtient la voix du synthétiseur vocal. Ajouté dans la version 1.4.0.

Retours

Nom vocal de synthèse vocale.

SetSpeechSynthesisOutputFormat

Syntaxe : public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Définit le format de sortie de synthèse vocale (par exemple, Riff16Khz16BitMonoPcm). Ajouté dans la version 1.4.0.

Paramètres

• formatId Spécifie l’ID de format de sortie

GetSpeechSynthesisOutputFormat

Syntaxe : public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

Obtient le format de sortie de synthèse vocale. Ajouté dans la version 1.4.0.

Retours

Format de sortie de synthèse vocale.

SetEndpointId

Syntaxe : public inline void SetEndpointId ( const std::string & endpointId );

Définit l’ID de point de terminaison de Custom Speech ou Custom Voice.

Paramètres

• endpointId ID de point de terminaison.

GetEndpointId

Syntaxe : public inline std::string GetEndpointId ( ) const;

Obtient l’ID de point de terminaison de Custom Speech ou Custom Voice.

Retours

ID de point de terminaison.

SetAuthorizationToken

Syntaxe : public inline void SetAuthorizationToken ( const std::string & token );

Définit le jeton d’autorisation pour se connecter au service. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant l’expiration du jeton d’autorisation, l’appelant doit l’actualiser en appelant ce setter avec un nouveau jeton valide. Comme les valeurs de configuration sont copiées lors de la création d’un module de reconnaissance, la nouvelle valeur de jeton ne s’applique pas aux modules de reconnaissance qui ont déjà été créés. Pour les modules de reconnaissance créés précédemment, vous devez définir le jeton d’autorisation du module de reconnaissance correspondant pour actualiser le jeton. Sinon, les modules de reconnaissance rencontrent des erreurs lors de la reconnaissance.

Paramètres

• token Le jeton d’autorisation.

GetAuthorizationToken

Syntaxe : public inline std::string GetAuthorizationToken ( ) const;

Obtient le jeton d’autorisation pour se connecter au service.

Retours

Jeton d’autorisation.

GetSubscriptionKey

Syntaxe : public inline std::string GetSubscriptionKey ( ) const;

Obtient la clé d’abonnement utilisée pour créer le Reconnaisseur de la Parole, le Reconnaisseur de Traduction ou le Synthétiseur de Parole.

Retours

Clé d’abonnement.

GetRegion

Syntaxe : public inline std::string GetRegion ( ) const;

Obtient la clé de région qui a servi à créer le reconnaisseur vocal, le reconnaisseur de traduction ou le synthétiseur vocal.

Retours

Région.

GetOutputFormat

Syntaxe : public inline OutputFormat GetOutputFormat ( ) const;

Obtient le format de sortie de reconnaissance vocale (simple ou détaillé). Remarque : Ce format de sortie est destiné au résultat de la reconnaissance vocale, utilisez SpeechConfig ::GetSpeechSynthesisOutputFormat pour obtenir le format de sortie audio synthétisé.

Retours

Format de sortie de reconnaissance vocale.

SetOutputFormat

Syntaxe : public inline void SetOutputFormat ( OutputFormat format );

Définit le format de sortie de reconnaissance vocale (simple ou détaillé). Remarque : ce format de sortie est destiné au résultat de la reconnaissance vocale, utilisez SpeechConfig ::SetSpeechSynthesisOutputFormat pour définir le format de sortie audio synthétisé.

Paramètres

• format de sortie de reconnaissance vocale format

SetProfanity

Syntaxe : public inline void SetProfanity ( ProfanityOption profanity );

Définit l’option de profanité. Ajouté dans la version 1.5.0.

Paramètres

• profanity valeur de l’option Profanity.

EnableAudioLogging

Syntaxe : public inline void EnableAudioLogging ( );

Active la journalisation audio dans le service. Ajouté dans la version 1.5.0.

Les journaux audio et de contenu sont stockés dans le stockage appartenant à Microsoft ou dans votre propre compte de stockage lié à votre abonnement Cognitive Services (ByOS) avec la ressource Speech compatible avec Votre propre stockage( BYOS).

RequestWordLevelTimestamps

Syntaxe : public inline void RequestWordLevelTimestamps ( );

Inclut les horodatages au niveau du mot dans le résultat de la réponse. Ajouté dans la version 1.5.0.

EnableDictation

Syntaxe : public inline void EnableDictation ( );

Active le mode de dictée. Uniquement pris en charge dans la reconnaissance vocale continue. Ajouté dans la version 1.5.0.

SetProxy

Syntaxe : public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );

Définit la configuration du proxy ajoutée dans la version 1.1.0.

Remarque : La fonctionnalité proxy n’est pas disponible sur macOS. Cette fonction n’aura aucun effet sur cette plateforme.

Paramètres

• proxyHostName Le nom d’hôte du serveur proxy, sans le schéma de protocole ([http://](http://))

• proxyPort Le numéro de port du serveur proxy

• proxyUserName Le nom d’utilisateur du serveur proxy

• proxyPassword Le mot de passe du serveur proxy

SetProperty

Syntaxe : public inline void SetProperty ( const std::string & name , const std::string & value );

Définit une valeur de propriété par nom.

Paramètres

• name Le nom de la propriété.

• value Valeur de la propriété.

GetProperty

Syntaxe : public inline std::string GetProperty ( const std::string & name ) const;

Obtient une valeur de propriété par nom.

Paramètres

• name Le nom du paramètre.

Retours

Valeur de la propriété.

GetProperty

Syntaxe : public inline std::string GetProperty ( PropertyId id ) const;

Obtient une valeur de propriété par ID.

Paramètres

• id l’ID de paramètre.

Retours

Valeur de la propriété.

SetProperty

Syntaxe : public inline void SetProperty ( PropertyId id , const std::string & value );

Définit une valeur de propriété par ID.

Paramètres

• id l’ID de propriété.

• value Valeur de la propriété.

SetServiceProperty

Syntaxe : public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );

Définit une valeur de propriété qui sera transmise au service à l’aide du canal spécifié. Ajouté dans la version 1.5.0.

Paramètres

• name Le nom de la propriété.

• value Valeur de la propriété.

• channel Le canal utilisé pour passer la propriété spécifiée au service.

~SpeechConfig

Syntaxe : public inline virtual ~SpeechConfig ( );

Destructeur l’objet.

FromSubscription

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );

Crée une instance de la configuration vocale avec la clé d’abonnement et la région spécifiées.

Paramètres

• subscription La clé d’abonnement.

• region Le nom de la région (voir la page région).

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.

FromAuthorizationToken

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

Crée une instance de la configuration vocale avec le jeton d’autorisation et la région spécifiés. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant l’expiration du jeton d’autorisation, l’appelant doit l’actualiser en appelant ce setter avec un nouveau jeton valide. Comme les valeurs de configuration sont copiées lors de la création d’un module de reconnaissance, la nouvelle valeur de jeton ne s’applique pas aux modules de reconnaissance qui ont déjà été créés. Pour les modules de reconnaissance créés précédemment, vous devez définir le jeton d’autorisation du module de reconnaissance correspondant pour actualiser le jeton. Sinon, les modules de reconnaissance rencontrent des erreurs lors de la reconnaissance.

Paramètres

• authToken Le jeton d’autorisation.

• region Le nom de la région (voir la page région).

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.

FromEndpoint

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );

Crée une instance de la configuration vocale avec un point de terminaison et un abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison de service non standard. Remarque : les paramètres de requête spécifiés dans l’URI du point de terminaison ne sont pas modifiés, même s’ils sont définis par d’autres API. Par exemple, si le langage de reconnaissance est défini dans l’URI en tant que paramètre de requête « language =de-DE», et également défini par SetSpeechRecognitionLanguage( »en-US« ), le paramètre de langue dans l’URI est prioritaire, et la langue effective est «de-DE». Seuls les paramètres qui ne sont pas spécifiés dans l’URI de point de terminaison peuvent être définis par d’autres API. Remarque : Pour utiliser un jeton d’autorisation avec FromEndpoint, utilisez FromEndpoint(const SPXSTRING&), puis appelez SetAuthorizationToken() sur l’instance SpeechConfig créée.

Paramètres

• endpoint point de terminaison de service auquel se connecter.

• subscription La clé d’abonnement.

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.

FromEndpoint

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );

Crée une instance de SpeechConfig avec un point de terminaison spécifié. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison de service non standard. Remarque : les paramètres de requête spécifiés dans l’URI du point de terminaison ne sont pas modifiés, même s’ils sont définis par d’autres API. Si un paramètre de requête spécifique est pris en charge ou non, dépend du point de terminaison et du scénario. Par exemple, si le langage de reconnaissance est défini dans l’URI en tant que paramètre de requête « language =de-DE», et également défini par SetSpeechRecognitionLanguage( »en-US« ), le paramètre de langue dans l’URI est prioritaire, et la langue effective est «de-DE». L’exemple s’applique uniquement lorsque la combinaison de points de terminaison et de scénario prend en charge le langage en tant que paramètre de requête. Seuls les paramètres qui ne sont pas spécifiés dans l’URI de point de terminaison peuvent être définis par d’autres API. Remarque : Si le point de terminaison nécessite une clé d’abonnement pour l’authentification, utilisez FromEndpoint(const SPXSTRING&, const SPXSTRING&) pour passer la clé d’abonnement en tant que paramètre. Pour utiliser un jeton d’autorisation avec FromEndpoint, utilisez cette méthode pour créer une instance SpeechConfig, puis appelez SetAuthorizationToken() sur l’instance SpeechConfig créée. Remarque : ajoutée dans la version 1.5.0.

Paramètres

• endpoint l’URI du point de terminaison de service auquel se connecter.

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.

FromHost

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );

Crée une instance de la configuration vocale avec l’hôte et l’abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un hôte de service non par défaut. Le chemin d’accès aux ressources standard est supposé. Pour les services avec un chemin de ressource non standard ou aucun chemin d’accès du tout, utilisez FromEndpoint à la place. Remarque : les paramètres de requête ne sont pas autorisés dans l’URI hôte et doivent être définis par d’autres API. Remarque : Pour utiliser un jeton d’autorisation avec FromHost, utilisez FromHost(const SPXSTRING&), puis appelez SetAuthorizationToken() sur l’instance SpeechConfig créée. Remarque : ajoutée dans la version 1.8.0.

Paramètres

• host l’hôte de service auquel se connecter. Le format est « protocol ://host :port » où « :p ort » est facultatif.

• subscription La clé d’abonnement.

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.

FromHost

Syntaxe : public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );

Crée une instance de SpeechConfig avec l’hôte spécifié. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un hôte de service non par défaut. Le chemin d’accès aux ressources standard est supposé. Pour les services avec un chemin de ressource non standard ou aucun chemin d’accès du tout, utilisez FromEndpoint à la place. Remarque : les paramètres de requête ne sont pas autorisés dans l’URI hôte et doivent être définis par d’autres API. Remarque : Si l’hôte nécessite une clé d’abonnement pour l’authentification, utilisez FromHost(const SPXSTRING&, const SPXSTRING&) pour passer la clé d’abonnement en tant que paramètre. Pour utiliser un jeton d’autorisation avec FromHost, utilisez cette méthode pour créer une instance SpeechConfig, puis appelez SetAuthorizationToken() sur l’instance SpeechConfig créée. Remarque : ajoutée dans la version 1.8.0.

Paramètres

• host l’URI hôte du service auquel se connecter. Le format est « protocol ://host :port » où « :p ort » est facultatif.

Retours

Pointeur partagé vers la nouvelle instance de configuration speech.