SpeechTranslationConfig class
Configuration de la traduction vocale.
- Extends
Propriétés
authorization |
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. |
endpoint |
Obtient l’ID de point de terminaison d’un modèle vocal personnalisé utilisé pour la reconnaissance vocale. |
output |
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 | |
speech |
Obtient/Définit la langue de reconnaissance vocale. |
speech |
Obtient la langue du synthétiseur vocal. Ajouté dans la version 1.11.0. |
speech |
Obtient le format de sortie de synthèse vocale. Ajouté dans la version 1.11.0. |
speech |
Obtient la voix du synthétiseur vocal. Ajouté dans la version 1.11.0. |
subscription |
|
target |
Obtient la langue cible (texte) dans laquelle traduire. |
voice |
Obtient le nom de la voix sélectionnée. |
Méthodes
add |
Ajoutez une langue cible (texte) dans laquelle traduire. |
close() | Supprimer les ressources associées. |
from |
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. |
from |
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. |
from |
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. |
from |
Instance statique de SpeechTranslationConfig retournés en transmettant une clé d’abonnement et une région de service. |
set |
Définit une propriété nommée comme valeur |
Méthodes héritées
enable |
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. |
enable |
Activez la dictée. Prise en charge uniquement dans la reconnaissance vocale continue. Ajout dans la version 1.7.0. |
get |
Retourne la valeur actuelle d’une propriété arbitraire. |
request |
Inclut des horodatages au niveau du mot. Ajout dans la version 1.7.0. |
set |
Définit l’option de grossièreté. Ajout dans la version 1.7.0. |
set |
Définit la configuration du proxy. Applicable uniquement dans les environnements Node.js. Ajouté dans la version 1.4.0. |
set |
Définit la configuration du proxy. Applicable uniquement dans les environnements Node.js. Ajouté dans la version 1.4.0. |
set |
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é
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é
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
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
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
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
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()
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