SpeechConfig Classe

Paquet:

com.microsoft.cognitiveservices.speech

Artefact Maven:

com.microsoft.cognitiveservices.speech:client-sdk:1.32.1

• java.lang.Object
• • com.microsoft.cognitiveservices.speech.SpeechConfig

Implémente

java.lang.AutoCloseable

public class SpeechConfig
implements java.lang.AutoCloseable

Configuration vocale. Remarque : close() doit être appelé pour libérer les ressources sous-jacentes détenues par l’objet . Modification dans la version 1.7.0

Récapitulatif du champ

Modificateur et type	Champ et description
static java.lang.Class<?>	speechConfigClass Accesseur pour charger la bibliothèque native.

Récapitulatif du constructeur

Modificateur	Constructeur	Description
protected	SpeechConfig(long handleValue)	Constructeur interne pour l’objet de configuration vocale.

Résumé de la méthode

Modificateur et type	Méthode et description
void	close() Supprimer les ressources associées.
void	enableAudioLogging() Activer la journalisation audio dans le service.
void	enableDictation() Activez la dictée.
static SpeechConfig	fromAuthorizationToken(String authorizationToken, String region) Crée une instance d’une configuration vocale avec le jeton d’autorisation et la région de service spécifiés.
static SpeechConfig	fromEndpoint(URI endpoint) Crée une instance de la configuration vocale avec le point de terminaison spécifié.
static SpeechConfig	fromEndpoint(URI endpoint, String subscriptionKey) Crée une instance de la configuration vocale avec le point de terminaison et la clé d’abonnement spécifiés.
static SpeechConfig	fromHost(URI host) Crée une instance de la configuration vocale avec l’hôte spécifié.
static SpeechConfig	fromHost(URI host, String subscriptionKey) Crée une instance de la configuration speech avec l’hôte et la clé d’abonnement spécifiés.
static SpeechConfig	fromSubscription(String subscriptionKey, String region) Crée une instance d’une configuration speech avec la clé d’abonnement et la région de service spécifiées.
java.lang.String	getAuthorizationToken() Obtient le jeton d’autorisation.
java.lang.String	getEndpointId() Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale ou d’un modèle vocal personnalisé pour la synthèse vocale.
SafeHandle	getImpl() Obtenez le handle natif de l’objet de configuration speech.
OutputFormat	getOutputFormat() Obtient le format de sortie de la reconnaissance vocale (simple ou détaillé).
java.lang.String	getProperty(PropertyId id) Obtient la propriété par ID de propriété.
java.lang.String	getProperty(String name) Obtient une propriété nommée en tant que valeur.
java.lang.String	getSpeechRecognitionLanguage() Obtient la langue de reconnaissance vocale
java.lang.String	getSpeechSynthesisLanguage() Obtient la langue de synthèse vocale.
java.lang.String	getSpeechSynthesisOutputFormat() Obtient le format de sortie de synthèse vocale.
java.lang.String	getSpeechSynthesisVoiceName() Obtient le nom de la voix de synthèse vocale.
void	requestWordLevelTimestamps() Inclut des horodatages au niveau du mot.
void	setAuthorizationToken(String value) Définit le jeton d’autorisation.
void	setEndpointId(String value) Définit l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale ou d’un modèle vocal personnalisé pour la synthèse vocale.
void	setOutputFormat(OutputFormat format) Définit le format de sortie de la reconnaissance vocale (simple ou détaillé).
void	setProfanity(ProfanityOption profanity) Définit l’option de grossièreté.
void	setProperty(PropertyId id, String value) Définit la propriété par id de propriété.
void	setProperty(String name, String value) Définit une propriété nommée comme valeur.
void	setProxy(String proxyHostName, int proxyPort, String proxyUserName, String proxyPassword) Définit la configuration du proxy Ajoutée dans la version 1.1.0.
void	setServiceProperty(String name, String value, ServicePropertyChannel channel) Définit une valeur de propriété qui sera passée au service à l’aide du canal spécifié.
void	setSpeechRecognitionLanguage(String value) Définit la langue de reconnaissance vocale
void	setSpeechSynthesisLanguage(String value) Définit la langue de synthèse vocale.
void	setSpeechSynthesisOutputFormat(SpeechSynthesisOutputFormat value) Définit le format de sortie de synthèse vocale.
void	setSpeechSynthesisVoiceName(String value) Définit le nom de la voix de synthèse vocale.

Méthodes héritées de java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

Détails du champ

speechConfigClass

public static Class speechConfigClass

Accesseur pour charger la bibliothèque native. Maintient la classe active afin que la classe GC ne la récupère pas (et les variables locales !)

Détails du constructeur

SpeechConfig

protected SpeechConfig(long handleValue)

Constructeur interne pour l’objet de configuration vocale.

Parameters:

handleValue - Handle natif.

Détails de la méthode

close

public void close()

Supprimer les ressources associées.

enableAudioLogging

public void enableAudioLogging()

Activer la journalisation audio dans le service. Les journaux d’activité 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 (ressource Speech byOS (Bring Your Own Storage) activée). Ajouté dans la version 1.5.0.

enableDictation

public void enableDictation()

Activez la dictée. Prise en charge uniquement dans la reconnaissance vocale continue. Ajouté dans la version 1.5.0.

fromAuthorizationToken

public static SpeechConfig fromAuthorizationToken(String authorizationToken, String region)

Crée une instance d’une configuration vocale avec le jeton d’autorisation et la région de service spécifiés. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode 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 qui ont été 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.

Parameters:

authorizationToken - Jeton d’autorisation.

region - Nom de la région (voir la page région).

Returns:

Une configuration vocale instance.

fromEndpoint

public static SpeechConfig fromEndpoint(URI endpoint)

Crée une instance de la configuration vocale avec le point de terminaison spécifié. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison ou des paramètres 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 la langue de reconnaissance est définie dans l’URI en tant que paramètre de requête « language=de-DE », et également définie par setSpeechRecognitionLanguage(« en-US »), le paramètre de langue dans URI est prioritaire et la langue effective est « de-DE ». Seuls les paramètres non 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(java.net.URI, String) 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 un instance SpeechConfig, puis appelez setAuthorizationToken() sur le instance SpeechConfig créé. Remarque : Ajouté dans la version 1.5.0.

Parameters:

endpoint - Point de terminaison de service auquel se connecter.

Returns:

Une configuration vocale instance.

fromEndpoint

public static SpeechConfig fromEndpoint(URI endpoint, String subscriptionKey)

Crée une instance de la configuration vocale avec le point de terminaison et la clé d’abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison ou des paramètres 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 la langue de reconnaissance est définie dans l’URI en tant que paramètre de requête « language=de-DE », et également définie par setSpeechRecognitionLanguage(« en-US »), le paramètre de langue dans URI est prioritaire et la langue effective est « de-DE ». Seuls les paramètres non 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(java.net.URI), puis appelez setAuthorizationToken() sur le instance SpeechConfig créé.

Parameters:

endpoint - Point de terminaison de service auquel se connecter.

subscriptionKey - Clé d’abonnement.

Returns:

Une configuration vocale instance.

fromHost

public static SpeechConfig fromHost(URI host)

Crée une instance de la configuration vocale avec l’hôte spécifié. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un hôte de service autre que celui 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 plutôt fromEndpoint. 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(java.net.URI, String) 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 un instance SpeechConfig, puis appelez setAuthorizationToken() sur le instance SpeechConfig créé. Remarque : Ajouté dans la version 1.8.0.

Parameters:

host - Hôte de service auquel se connecter. Le format est « protocol://host:port » où « :p ort » est facultatif.

Returns:

Une configuration vocale instance.

fromHost

public static SpeechConfig fromHost(URI host, String subscriptionKey)

Crée une instance de la configuration speech avec l’hôte et la clé d’abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un hôte de service autre que celui 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 plutôt fromEndpoint. 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(java.net.URI), puis appelez setAuthorizationToken() sur le instance SpeechConfig créé. Remarque : Ajouté dans la version 1.8.0.

Parameters:

host - Hôte de service auquel se connecter. Le format est « protocol://host:port » où « :p ort » est facultatif.

subscriptionKey - Clé d’abonnement.

Returns:

Une configuration vocale instance.

fromSubscription

public static SpeechConfig fromSubscription(String subscriptionKey, String region)

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

Parameters:

subscriptionKey - Clé d’abonnement.

region - Nom de la région (voir la page région).

Returns:

Une configuration vocale instance.

getAuthorizationToken

public String getAuthorizationToken()

Obtient le jeton d’autorisation.

Returns:

Jeton d’autorisation.

getEndpointId

public String getEndpointId()

Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale ou d’un modèle vocal personnalisé pour la synthèse vocale.

Returns:

L’ID de point de terminaison.

getImpl

public SafeHandle getImpl()

Obtenez le handle natif de l’objet de configuration speech.

Returns:

Handle natif.

getOutputFormat

public OutputFormat getOutputFormat()

Obtient le format de sortie de la reconnaissance vocale (simple ou détaillé). Remarque : Ce format de sortie est destiné aux résultats de la reconnaissance vocale, à utiliser com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat pour définir le format de sortie audio synthétisé.

Returns:

Retourne le format de sortie de la reconnaissance vocale.

getProperty

public String getProperty(PropertyId id)

Obtient la propriété par propertyId. Ajouté dans la version 1.3.0.

Parameters:

id - PropertyId de la propriété .

Returns:

La valeur.

getProperty

public String getProperty(String name)

Obtient une propriété nommée en tant que valeur.

Parameters:

name - nom de la propriété.

Returns:

La valeur.

getSpeechRecognitionLanguage

public String getSpeechRecognitionLanguage()

Obtient la langue de reconnaissance vocale

Returns:

Retourne la langue de reconnaissance.

getSpeechSynthesisLanguage

public String getSpeechSynthesisLanguage()

Obtient la langue de synthèse vocale. Ajouté dans la version 1.7.0

Returns:

Retourne la langue de synthèse.

getSpeechSynthesisOutputFormat

public String getSpeechSynthesisOutputFormat()

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

Returns:

Retourne le format de sortie de synthèse.

getSpeechSynthesisVoiceName

public String getSpeechSynthesisVoiceName()

Obtient le nom de la voix de synthèse vocale. Ajouté dans la version 1.7.0

Returns:

Retourne le nom de la voix de synthèse.

requestWordLevelTimestamps

public void requestWordLevelTimestamps()

Inclut des horodatages au niveau du mot. Ajouté dans la version 1.5.0.

setAuthorizationToken

public void setAuthorizationToken(String value)

Définit le jeton d’autorisation. Remarque : l’appelant doit s’assurer que le jeton d’autorisation est valide. Avant que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode 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 qui ont été 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.

Parameters:

value - jeton d’autorisation.

setEndpointId

public void setEndpointId(String value)

Définit l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale ou d’un modèle vocal personnalisé pour la synthèse vocale.

Parameters:

value - ID du point de terminaison.

setOutputFormat

public void setOutputFormat(OutputFormat format)

Définit le format de sortie de la reconnaissance vocale (simple ou détaillé). Remarque : Ce format de sortie est destiné aux résultats de la reconnaissance vocale, à utiliser com.microsoft.cognitiveservices.speech.SpeechConfig#setSpeechSynthesisOutputFormat pour définir le format de sortie audio synthétisé.

Parameters:

format - Format de sortie de la reconnaissance vocale.

setProfanity

public void setProfanity(ProfanityOption profanity)

Définit l’option de grossièreté. Ajouté dans la version 1.5.0.

Parameters:

profanity - option de propriété à définir.

setProperty

public void setProperty(PropertyId id, String value)

Définit la propriété par propertyId. Ajouté dans la version 1.3.0.

Parameters:

id - PropertyId de la propriété .

value - La valeur.

setProperty

public void setProperty(String name, String value)

Définit une propriété nommée comme valeur.

Parameters:

name - nom de la propriété.

value - valeur.

setProxy

public void setProxy(String proxyHostName, int proxyPort, String proxyUserName, String proxyPassword)

Définit la configuration du proxy Ajoutée dans la version 1.1.0. Remarque : La fonctionnalité de proxy n’est pas disponible sur macOS. Cette fonction n’aura aucun effet sur cette plateforme.

Parameters:

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

proxyPort - numéro de port du serveur proxy.

proxyUserName - nom d’utilisateur du serveur proxy. Utilisez une chaîne vide si aucun nom d’utilisateur n’est nécessaire.

proxyPassword - mot de passe du serveur proxy. Utilisez une chaîne vide si aucun mot de passe utilisateur n’est nécessaire.

setServiceProperty

public void setServiceProperty(String name, String value, ServicePropertyChannel channel)

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

Parameters:

name - nom de la propriété.

value - valeur de propriété.

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

setSpeechRecognitionLanguage

public void setSpeechRecognitionLanguage(String value)

Définit la langue de reconnaissance vocale

Parameters:

value - identificateur de langue au format BCP-47.

setSpeechSynthesisLanguage

public void setSpeechSynthesisLanguage(String value)

Définit la langue de synthèse vocale. Ajouté dans la version 1.7.0

Parameters:

value - l’identificateur de langue au format BCP-47 (par exemple, en-US).

setSpeechSynthesisOutputFormat

public void setSpeechSynthesisOutputFormat(SpeechSynthesisOutputFormat value)

Définit le format de sortie de synthèse vocale. Ajouté dans la version 1.7.0

Parameters:

value - ID du format de sortie de synthèse (par exemple, Riff16Khz16BitMonoPcm).

setSpeechSynthesisVoiceName

public void setSpeechSynthesisVoiceName(String value)

Définit le nom de la voix de synthèse vocale. Ajouté dans la version 1.7.0

Parameters:

value - Nom de la voix de synthèse vocale.