SpeechConfig Classe

Classe qui définit des configurations pour la reconnaissance vocale/intention et la synthèse vocale.

La configuration peut être initialisée de différentes manières :

• à partir d’un abonnement : passez une clé d’abonnement et une région

• à partir d’un point de terminaison : passez un point de terminaison. La clé d’abonnement ou le jeton d’autorisation sont facultatifs.

• de l’hôte : transmettez une adresse d’hôte. La clé d’abonnement ou le jeton d’autorisation sont facultatifs.

• à partir du jeton d’autorisation : passez un jeton d’autorisation et une région

Héritage

builtins.object

SpeechConfig

Constructeur

SpeechConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, speech_recognition_language: str | None = None)

Paramètres

Nom	Description
subscription	Clé d’abonnement. valeur par défaut: None
region	Nom de la région (voir la page région). valeur par défaut: None
endpoint	Point de terminaison de service auquel se connecter. valeur par défaut: None
host	Hôte de service auquel se connecter. Le chemin d’accès aux ressources standard est supposé. Le format est « protocol://host:port » où « :p ort » est facultatif. valeur par défaut: None
auth_token	Jeton d’autorisation. valeur par défaut: None
speech_recognition_language	Langue d’entrée de la reconnaissance vocale. La langue est spécifiée au format BCP-47. valeur par défaut: None

Méthodes

enable_audio_logging	Active la journalisation audio en service. Les journaux audio et de contenu sont stockés soit dans un stockage appartenant à Microsoft, soit dans votre propre compte de stockage lié à votre abonnement Cognitive Services (Bring Your Own Storage (BYOS) enabled Speech ressource). Notes Ajout dans la version 1.5.0.
enable_dictation	Active la dictée. Prise en charge uniquement dans la reconnaissance vocale continue. Notes Ajout dans la version 1.5.0.
get_property	Obtenir une propriété par ID.
get_property_by_name	Obtenir une propriété par son nom.
request_word_level_timestamps	Inclut des horodatages au niveau des mots dans le résultat de la réponse. Notes Ajout dans la version 1.5.0.
set_profanity	Définissez l’option blasphème. Notes Ajout dans la version 1.5.0.
set_properties	Définissez plusieurs propriétés par ID.
set_properties_by_name	Définissez plusieurs propriétés par nom.
set_property	Définissez une propriété par id.
set_property_by_name	Définissez une propriété par nom.
set_proxy	Définissez les informations de proxy. Notes La fonctionnalité de proxy n’est pas disponible sur macOS. Cette fonction n’aura aucun effet sur cette plateforme.
set_service_property	Définit une valeur de propriété qui sera passée au service à l’aide du canal spécifié. Notes Ajout dans la version 1.5.0.
set_speech_synthesis_output_format	Définissez le format audio de sortie de synthèse vocale.

enable_audio_logging

Active la journalisation audio en service. Les journaux audio et de contenu sont stockés soit dans un stockage appartenant à Microsoft, soit dans votre propre compte de stockage lié à votre abonnement Cognitive Services (Bring Your Own Storage (BYOS) enabled Speech ressource).

Notes

Ajout dans la version 1.5.0.

enable_audio_logging()

enable_dictation

Active la dictée. Prise en charge uniquement dans la reconnaissance vocale continue.

Notes

Ajout dans la version 1.5.0.

enable_dictation()

get_property

Obtenir une propriété par ID.

get_property(property_id: PropertyId) -> str

Paramètres

Nom	Description
property_id Obligatoire	ID de la propriété à récupérer.

Retours

Type	Description
	Valeur de la propriété.

get_property_by_name

Obtenir une propriété par son nom.

get_property_by_name(property_name: str) -> str

Paramètres

Nom	Description
property_name Obligatoire	Nom de la propriété à récupérer.

Retours

Type	Description
	Valeur de la propriété.

request_word_level_timestamps

Inclut des horodatages au niveau des mots dans le résultat de la réponse.

Notes

Ajout dans la version 1.5.0.

request_word_level_timestamps()

set_profanity

Définissez l’option blasphème.

Notes

Ajout dans la version 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

Paramètres

Nom	Description
profanity_option Obligatoire	Niveau de grossièreté à définir.

set_properties

Définissez plusieurs propriétés par ID.

set_properties(properties: Dict[PropertyId, str])

Paramètres

Nom	Description
properties Obligatoire	Un dict mappant des id de propriété aux valeurs à définir.

set_properties_by_name

Définissez plusieurs propriétés par nom.

set_properties_by_name(properties: Dict[str, str])

Paramètres

Nom	Description
properties Obligatoire	Un dict mappant des id de propriété aux valeurs à définir.

set_property

Définissez une propriété par id.

set_property(property_id: PropertyId, value: str)

Paramètres

Nom	Description
property_id Obligatoire	ID de la propriété à définir.
value Obligatoire	Valeur à définir pour la propriété .

set_property_by_name

Définissez une propriété par nom.

set_property_by_name(property_name: str, value: str)

Paramètres

Nom	Description
property_name Obligatoire	Nom de la propriété à définir.
value Obligatoire	Valeur à définir pour la propriété .

set_proxy

Définissez les informations de proxy.

Notes

La fonctionnalité de proxy n’est pas disponible sur macOS. Cette fonction n’aura aucun effet sur

cette plateforme.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

Paramètres

Nom	Description
hostname Obligatoire	Nom d’hôte du serveur proxy. N’ajoutez pas d’informations de protocole (http) au nom d’hôte.
port Obligatoire	Numéro de port du serveur proxy.
username	Nom d’utilisateur du serveur proxy. valeur par défaut: None
password	Mot de passe du serveur proxy. valeur par défaut: None

set_service_property

Définit une valeur de propriété qui sera passée au service à l’aide du canal spécifié.

Notes

Ajout dans la version 1.5.0.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

Paramètres

Nom	Description
name Obligatoire	Nom de la propriété.
value Obligatoire	Valeur de la propriété.
channel Obligatoire	Canal utilisé pour passer la propriété spécifiée au service.

set_speech_synthesis_output_format

Définissez le format audio de sortie de synthèse vocale.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Paramètres

Nom	Description
format_id Obligatoire	ID de format audio, par exemple Riff16Khz16BitMonoPcm.

Attributs

authorization_token

Jeton d’autorisation qui sera utilisé pour la connexion au service.

Notes

L’appelant doit s’assurer que le jeton d’autorisation est valide. Avant le

le jeton d’autorisation expire, 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 nouveau module de reconnaissance, le

la nouvelle valeur de jeton ne s’applique pas aux générateurs de reconnaissance qui ont déjà été créés. For

reconnaissants qui ont été créés auparavant, vous devez définir le jeton d’autorisation du

l’outil de reconnaissance correspondant pour actualiser le jeton. Dans le cas contraire, les modules de reconnaissance rencontreront

erreurs pendant la reconnaissance.

endpoint_id

ID de point de terminaison.

output_format

Format de sortie (simple ou détaillé) du résultat de la reconnaissance vocale.

region

Clé de région utilisée pour créer le Recognizer.

speech_recognition_language

Nom de la langue parlée à reconnaître au format BCP-47.

speech_synthesis_language

Obtenir un langage de synthèse vocale.

speech_synthesis_output_format_string

Obtenir la chaîne de format audio de sortie de synthèse vocale.

speech_synthesis_voice_name

Obtenir le nom de la voix de synthèse vocale.

subscription_key

Clé d’abonnement utilisée pour créer le Recognizer.