Partager via


SpeechConfig Classe

  • 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.

S’applique à