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 que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode 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 la 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) dans laquelle traduire.
voiceName	Obtient le nom de la voix sélectionnée.

Méthodes

addTargetLanguage(string)	Ajoutez une langue cible (texte) dans laquelle traduire.
close()	Supprimer les ressources associées.
fromAuthorizationToken(string, string)	Instance statique de SpeechTranslationConfig retourné en passant le jeton d’autorisation et la 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 la propriété authorizationToken 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 générateurs de reconnaissance qui ont déjà été créés. Pour les éléments de reconnaissance qui ont été créés auparavant, vous devez définir le jeton d’autorisation du module de reconnaissance correspondant pour actualiser le jeton. Dans le cas contraire, 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 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 de service ou des analyseurs non standard. 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 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, passez une chaîne vide à l’abonnementKey dans la méthode fromEndpoint, puis définissez authorizationToken="token » sur le instance SpeechConfig créé 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és. Cette méthode est destinée uniquement aux utilisateurs qui utilisent un hôte de service autre que 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, 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 le instance SpeechConfig créé. Remarque : Ajoutée dans la version 1.9.0.
fromSubscription(string, string)	Instance statique de SpeechTranslationConfig retournés en transmettant 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 en service. Les journaux audio et de contenu sont stockés dans un stockage appartenant à Microsoft ou dans votre propre compte de stockage lié à votre abonnement Cognitive Services (Bring Your Own Storage (BYOS) enabled Speech ressource). Les journaux seront supprimés au bout de 30 jours. Ajout dans la version 1.7.0.
enableDictation()	Activez la dictée. Prise en charge uniquement 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 des horodatages au niveau du mot. Ajout dans la version 1.7.0.
setProfanity(ProfanityOption)	Définit l’option de grossièreté. Ajout dans la version 1.7.0.
setProxy(string, number)	Définit la configuration du proxy. Applicable uniquement dans les environnements Node.js. Ajouté dans la version 1.4.0.
setProxy(string, number, string, string)	Définit la configuration du proxy. Applicable uniquement 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 passée 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 que le jeton d’autorisation expire, l’appelant doit l’actualiser en appelant cet méthode 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 la 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 la langue 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 dans la configuration.

targetLanguages

Obtient la langue cible (texte) dans laquelle traduire.

string[] targetLanguages

Valeur de propriété

string[]

voiceName

Obtient le nom de la voix sélectionnée.

string voiceName

Valeur de propriété

string

Nom de la voix.

Détails de la méthode

addTargetLanguage(string)

Ajoutez une langue cible (texte) dans laquelle traduire.

function addTargetLanguage(value: string)

Paramètres

value

string

Langue telle que de-DE

close()

Supprimer les ressources associées.

function close()

fromAuthorizationToken(string, string)

Instance statique de SpeechTranslationConfig retourné en passant le jeton d’autorisation et la 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 la propriété authorizationToken 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 générateurs de reconnaissance qui ont déjà été créés. Pour les éléments de reconnaissance qui ont été créés auparavant, vous devez définir le jeton d’autorisation du module de reconnaissance correspondant pour actualiser le jeton. Dans le cas contraire, 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 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 de service ou des analyseurs non standard. 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 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, passez une chaîne vide à l’abonnementKey dans la méthode fromEndpoint, puis définissez authorizationToken="token » sur le instance SpeechConfig créé 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

Une configuration vocale instance.

fromHost(URL, string)

Crée une instance de la configuration vocale 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 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, 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 le instance SpeechConfig créé. Remarque : Ajoutée dans 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

Une fabrique de parole instance.

fromSubscription(string, string)

Instance statique de SpeechTranslationConfig retournés en transmettant 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 en service. Les journaux audio et de contenu sont stockés dans un stockage appartenant à Microsoft ou dans votre propre compte de stockage lié à votre abonnement Cognitive Services (Bring Your Own Storage (BYOS) enabled Speech ressource). Les journaux seront supprimés au bout de 30 jours. Ajout dans la version 1.7.0.

function enableAudioLogging()

Hérité deSpeechConfig.enableAudioLogging

enableDictation()

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

function enableDictation()

Hérité 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é deSpeechConfig.getProperty

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

Hérité deSpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Paramètres

profanity

ProfanityOption

Hérité deSpeechConfig.setProfanity

setProxy(string, number)

Définit la configuration du proxy. Applicable uniquement 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é deSpeechConfig.setProxy

setProxy(string, number, string, string)

Définit la configuration du proxy. Applicable uniquement 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é deSpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Définit une valeur de propriété qui sera passée 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é deSpeechConfig.setServiceProperty