Partager via


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.