SpeechTranslationConfig class

Paquet:

microsoft-cognitiveservices-speech-sdk

Configuration de la traduction vocale.

Extends

SpeechConfig

Propriétés

authorizationToken	Obtient/Définit le jeton d’autorisation. 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.
endpointId	Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale.
outputFormat	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.speechSynthesisOutputFormat] pour obtenir le format de sortie audio synthétisé.
region
speechRecognitionLanguage	Obtient/Définit la langue de reconnaissance vocale.
speechSynthesisLanguage	Obtient la langue du synthétiseur vocal. Ajouté dans la version 1.11.0.
speechSynthesisOutputFormat	Obtient le format de sortie de synthèse vocale. Ajouté dans la version 1.11.0.
speechSynthesisVoiceName	Obtient la voix du synthétiseur vocal. Ajouté dans la version 1.11.0.
subscriptionKey
targetLanguages	Obtient la langue cible (texte) à traduire.
voiceName	Obtient le nom vocal sélectionné.

Méthodes

addTargetLanguage(string)	Ajoutez une langue cible (texte) à traduire.
close()	Supprimez les ressources associées.
fromAuthorizationToken(string, string)	Instance statique de SpeechTranslationConfig retournée en transmettant un jeton d’autorisation et une région de 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 définissant l’autorisation de propriétéToken avec un nouveau jeton valide. Sinon, tous les modules de reconnaissance créés par cette instance SpeechTranslationConfig rencontrent des erreurs lors de la reconnaissance. 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.
fromEndpoint(URL, string)	Crée une instance de la configuration de traduction vocale avec un point de terminaison et une clé d’abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison de service non standard ou des paramters. Remarque : les propriétés de requête spécifiées dans l’URL du point de terminaison ne sont pas modifiées, même si elles sont définies par d’autres API. Par exemple, si la langue est définie dans l’URI en tant que paramètre de requête « language=de-DE», et également définie par la propriété speechRecognitionLanguage, le paramètre de langue dans l’URI est prioritaire et la langue effective est «de-DE». Seules les propriétés qui ne sont pas spécifiées dans l’URL du point de terminaison peuvent être définies par d’autres API. Remarque : Pour utiliser le jeton d’autorisation avec fromEndpoint, transmettez une chaîne vide à l’abonnementKey dans la méthode fromEndpoint, puis définissez authorizationToken="token » sur l’instance SpeechConfig créée pour utiliser le jeton d’autorisation.
fromHost(URL, string)	Crée une instance de la configuration vocale avec l’hôte et la clé d’abonnement spécifiées. 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 d’accès de ressource non standard ou aucun chemin d’accès, 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(URL), puis définissez la propriété AuthorizationToken sur l’instance SpeechConfig créée. Remarque : ajoutée à la version 1.9.0.
fromSubscription(string, string)	Instance statique de SpeechTranslationConfig retournée en passant une clé d’abonnement et une région de service.
setProperty(string | PropertyId, string)	Définit une propriété nommée comme valeur

Méthodes héritées

enableAudioLogging()	Activez la journalisation audio dans le service. 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). Les journaux seront supprimés après 30 jours. Ajouté dans la version 1.7.0.
enableDictation()	Activez la dictée. Uniquement pris en charge dans la reconnaissance vocale continue. Ajouté dans la version 1.7.0.
getProperty(string, string)	Retourne la valeur actuelle d’une propriété arbitraire.
requestWordLevelTimestamps()	Inclut les horodatages au niveau du mot. Ajouté dans la version 1.7.0.
setProfanity(ProfanityOption)	Définit l’option de profanité. Ajouté dans la version 1.7.0.
setProxy(string, number)	Définit la configuration du proxy. Uniquement pertinent dans les environnements Node.js. Ajouté dans la version 1.4.0.
setProxy(string, number, string, string)	Définit la configuration du proxy. Uniquement pertinent dans les environnements Node.js. Ajouté dans la version 1.4.0.
setServiceProperty(string, string, UriQueryParameter)	Définit une valeur de propriété qui sera transmise au service à l’aide du canal spécifié. Ajouté dans la version 1.7.0.

Détails de la propriété

authorizationToken

Obtient/Définit le jeton d’autorisation. 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.

void authorizationToken

Valeur de propriété

void

endpointId

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

string endpointId

Valeur de propriété

string

ID de point de terminaison

outputFormat

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.speechSynthesisOutputFormat] pour obtenir le format de sortie audio synthétisé.

OutputFormat outputFormat

Valeur de propriété

OutputFormat

Retourne le format de sortie.

region

string region

Valeur de propriété

string

Région définie sur la configuration.

speechRecognitionLanguage

Obtient/Définit la langue de reconnaissance vocale.

void speechRecognitionLanguage

Valeur de propriété

void

speechSynthesisLanguage

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

string speechSynthesisLanguage

Valeur de propriété

string

Retourne le langage de synthèse vocale.

speechSynthesisOutputFormat

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

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Valeur de propriété

SpeechSynthesisOutputFormat

Retourne le format de sortie de synthèse vocale

speechSynthesisVoiceName

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

string speechSynthesisVoiceName

Valeur de propriété

string

Retourne la voix de synthèse vocale.

subscriptionKey

string subscriptionKey

Valeur de propriété

string

Clé d’abonnement définie sur la configuration.

targetLanguages

Obtient la langue cible (texte) à traduire.

string[] targetLanguages

Valeur de propriété

string[]

voiceName

Obtient le nom vocal sélectionné.

string voiceName

Valeur de propriété

string

Nom de la voix.

Détails de la méthode

addTargetLanguage(string)

Ajoutez une langue cible (texte) à traduire.

function addTargetLanguage(value: string)

Paramètres

value

string

Langue telle que de-DE

close()

Supprimez les ressources associées.

function close()

fromAuthorizationToken(string, string)

Instance statique de SpeechTranslationConfig retournée en transmettant un jeton d’autorisation et une région de 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 définissant l’autorisation de propriétéToken avec un nouveau jeton valide. Sinon, tous les modules de reconnaissance créés par cette instance SpeechTranslationConfig rencontrent des erreurs lors de la reconnaissance. 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.

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

Paramètres

authorizationToken

string

Jeton d’autorisation.

region

string

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

Retours

SpeechTranslationConfig

Configuration de la traduction vocale.

fromEndpoint(URL, string)

Crée une instance de la configuration de traduction vocale avec un point de terminaison et une clé d’abonnement spécifiés. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un point de terminaison de service non standard ou des paramters. Remarque : les propriétés de requête spécifiées dans l’URL du point de terminaison ne sont pas modifiées, même si elles sont définies par d’autres API. Par exemple, si la langue est définie dans l’URI en tant que paramètre de requête « language=de-DE», et également définie par la propriété speechRecognitionLanguage, le paramètre de langue dans l’URI est prioritaire et la langue effective est «de-DE». Seules les propriétés qui ne sont pas spécifiées dans l’URL du point de terminaison peuvent être définies par d’autres API. Remarque : Pour utiliser le jeton d’autorisation avec fromEndpoint, transmettez une chaîne vide à l’abonnementKey dans la méthode fromEndpoint, puis définissez authorizationToken="token » sur l’instance SpeechConfig créée pour utiliser le jeton d’autorisation.

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

Paramètres

endpoint

URL

Point de terminaison de service auquel se connecter.

subscriptionKey

string

Clé d’abonnement.

Retours

SpeechTranslationConfig

Instance de configuration vocale.

fromHost(URL, string)

Crée une instance de la configuration vocale avec l’hôte et la clé d’abonnement spécifiées. 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 d’accès de ressource non standard ou aucun chemin d’accès, 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(URL), puis définissez la propriété AuthorizationToken sur l’instance SpeechConfig créée. Remarque : ajoutée à la version 1.9.0.

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

Paramètres

hostName

URL

subscriptionKey

string

Clé d’abonnement. Si aucune clé d’abonnement n’est spécifiée, un jeton d’autorisation doit être défini.

Retours

SpeechConfig

Instance de la fabrique de reconnaissance vocale.

fromSubscription(string, string)

Instance statique de SpeechTranslationConfig retournée en passant une clé d’abonnement et une région de service.

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

Paramètres

subscriptionKey

string

Clé d’abonnement.

region

string

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

Retours

SpeechTranslationConfig

Configuration de la traduction vocale.

setProperty(string | PropertyId, string)

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

function setProperty(name: string | PropertyId, value: string)

Paramètres

name

string | PropertyId

Nom de la propriété à définir.

value

string

Nouvelle valeur de la propriété.

Détails de la méthode héritée

enableAudioLogging()

Activez la journalisation audio dans le service. 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). Les journaux seront supprimés après 30 jours. Ajouté dans la version 1.7.0.

function enableAudioLogging()

héritée deSpeechConfig.enableAudioLogging

enableDictation()

Activez la dictée. Uniquement pris en charge dans la reconnaissance vocale continue. Ajouté dans la version 1.7.0.

function enableDictation()

héritée deSpeechConfig.enableDictation

getProperty(string, string)

Retourne la valeur actuelle d’une propriété arbitraire.

function getProperty(name: string, def?: string): string

Paramètres

name

string

Nom de la propriété à interroger.

def

string

Valeur à retourner si la propriété n’est pas connue.

Retours

string

Valeur actuelle ou valeur par défaut fournie de la propriété donnée.

héritée deSpeechConfig.getProperty

requestWordLevelTimestamps()

Inclut les horodatages au niveau du mot. Ajouté dans la version 1.7.0.

function requestWordLevelTimestamps()

héritée deSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Paramètres

profanity

ProfanityOption

héritée deSpeechConfig.setProfanity

setProxy(string, number)

Définit la configuration du proxy. Uniquement pertinent dans les environnements Node.js. Ajouté dans la version 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number)

Paramètres

proxyHostName

string

Nom d’hôte du serveur proxy.

proxyPort

number

Numéro de port du serveur proxy.

héritée deSpeechConfig.setProxy

setProxy(string, number, string, string)

Définit la configuration du proxy. Uniquement pertinent dans les environnements Node.js. Ajouté dans la version 1.4.0.

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

Paramètres

proxyHostName

string

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

proxyPort

number

Numéro de port du serveur proxy.

proxyUserName

string

Nom d’utilisateur du serveur proxy.

proxyPassword

string

Mot de passe du serveur proxy.

héritée deSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

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

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

Paramètres

name

string

value

string

channel

UriQueryParameter

héritée deSpeechConfig.setServiceProperty