SpeechTranslationConfig class
Configuración de traducción de voz.
- Extends
Propiedades
authorization |
Obtiene o establece el token de autorización. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo llamando a este establecedor con un nuevo token válido. |
endpoint |
Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz. |
output |
Obtiene el formato de salida del reconocimiento de voz (simple o detallado). Nota: Este formato de salida es para el resultado del reconocimiento de voz, use [SpeechConfig.speechSynthesisOutputFormat] para obtener el formato de salida de audio sintetizado. |
region | |
speech |
Obtiene o establece el idioma de reconocimiento de voz. |
speech |
Obtiene el idioma del sintetizador de voz. Se agregó en la versión 1.11.0. |
speech |
Obtiene el formato de salida de síntesis de voz. Se agregó en la versión 1.11.0. |
speech |
Obtiene la voz del sintetizador de voz. Se agregó en la versión 1.11.0. |
subscription |
|
target |
Obtiene el idioma de destino (texto) en el que se va a traducir. |
voice |
Obtiene el nombre de voz seleccionado. |
Métodos
add |
Agregue un idioma de destino (texto) al que se va a traducir. |
close() | Elimine los recursos asociados. |
from |
Instancia estática de SpeechTranslationConfig devuelta pasando el token de autorización y la región del servicio. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo estableciendo la propiedad authorizationToken con un nuevo token válido. De lo contrario, todos los reconocedores creados por esta instancia de SpeechTranslationConfig encontrarán errores durante el reconocimiento. Como los valores de configuración se copian al crear un nuevo reconocedor, el nuevo valor de token no se aplicará a los reconocedores que ya se han creado. Para los reconocedores que se han creado antes, debe establecer el token de autorización del reconocedor correspondiente para actualizar el token. De lo contrario, los reconocedores encontrarán errores durante el reconocimiento. |
from |
Crea una instancia de la configuración de traducción de voz con el punto de conexión y la clave de suscripción especificados. Este método está pensado solo para los usuarios que usan un punto de conexión de servicio no estándar o paramters. Nota: Las propiedades de consulta especificadas en la dirección URL del punto de conexión no se cambian, aunque se establezcan mediante otras API. Por ejemplo, si el idioma se define en el URI como parámetro de consulta "language=de-DE" y también se establece mediante la propiedad speechRecognitionLanguage, el valor de idioma en URI tiene prioridad y el idioma efectivo es "de-DE". Solo otras API pueden establecer las propiedades que no se especifican en la dirección URL del punto de conexión. Nota: Para usar el token de autorización con fromEndpoint, pase una cadena vacía a subscriptionKey en el método fromEndpoint y, a continuación, establezca authorizationToken="token" en la instancia de SpeechConfig creada para usar el token de autorización. |
from |
Crea una instancia de la configuración de voz con el host y la clave de suscripción especificados. Este método está pensado solo para los usuarios que usan un host de servicio no predeterminado. Se presupone la ruta de acceso del recurso estándar. En el caso de los servicios con una ruta de acceso de recursos no estándar o ninguna ruta de acceso, use fromEndpoint en su lugar. Nota: Los parámetros de consulta no se permiten en el URI del host y deben establecerse mediante otras API. Nota: Para usar un token de autorización con fromHost, use fromHost(URL) y establezca la propiedad AuthorizationToken en la instancia de SpeechConfig creada. Nota: Se ha agregado en la versión 1.9.0. |
from |
Instancia estática de SpeechTranslationConfig devuelta pasando una clave de suscripción y una región de servicio. |
set |
Establece una propiedad con nombre como valor |
Métodos heredados
enable |
Habilite el registro de audio en el servicio. Los registros de audio y contenido se almacenan en el almacenamiento propiedad de Microsoft o en su propia cuenta de almacenamiento vinculada a la suscripción de Cognitive Services (Bring Your Own Storage [BYOS]) habilitado para el recurso de voz). Los registros se quitarán después de 30 días. Se agregó en la versión 1.7.0. |
enable |
Habilite el dictado. Solo se admite en el reconocimiento continuo de voz. Se agregó en la versión 1.7.0. |
get |
Devuelve el valor actual de una propiedad arbitraria. |
request |
Incluye marcas de tiempo de nivel de palabra. Se agregó en la versión 1.7.0. |
set |
Establece la opción soeces. Se agregó en la versión 1.7.0. |
set |
Establece la configuración de proxy. Solo es relevante en entornos de Node.js. Se agregó en la versión 1.4.0. |
set |
Establece la configuración de proxy. Solo es relevante en entornos de Node.js. Se agregó en la versión 1.4.0. |
set |
Establece un valor de propiedad que se pasará al servicio mediante el canal especificado. Se agregó en la versión 1.7.0. |
Detalles de las propiedades
authorizationToken
Obtiene o establece el token de autorización. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo llamando a este establecedor con un nuevo token válido.
void authorizationToken
Valor de propiedad
void
endpointId
Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz.
string endpointId
Valor de propiedad
string
El identificador del punto de conexión
outputFormat
Obtiene el formato de salida del reconocimiento de voz (simple o detallado). Nota: Este formato de salida es para el resultado del reconocimiento de voz, use [SpeechConfig.speechSynthesisOutputFormat] para obtener el formato de salida de audio sintetizado.
OutputFormat outputFormat
Valor de propiedad
Devuelve el formato de salida.
region
string region
Valor de propiedad
string
Región establecida en la configuración.
speechRecognitionLanguage
Obtiene o establece el idioma de reconocimiento de voz.
void speechRecognitionLanguage
Valor de propiedad
void
speechSynthesisLanguage
Obtiene el idioma del sintetizador de voz. Se agregó en la versión 1.11.0.
string speechSynthesisLanguage
Valor de propiedad
string
Devuelve el lenguaje de síntesis de voz.
speechSynthesisOutputFormat
Obtiene el formato de salida de síntesis de voz. Se agregó en la versión 1.11.0.
SpeechSynthesisOutputFormat speechSynthesisOutputFormat
Valor de propiedad
Devuelve el formato de salida de síntesis de voz.
speechSynthesisVoiceName
Obtiene la voz del sintetizador de voz. Se agregó en la versión 1.11.0.
string speechSynthesisVoiceName
Valor de propiedad
string
Devuelve la voz de síntesis de voz.
subscriptionKey
string subscriptionKey
Valor de propiedad
string
Clave de suscripción establecida en la configuración.
targetLanguages
Obtiene el idioma de destino (texto) en el que se va a traducir.
string[] targetLanguages
Valor de propiedad
string[]
voiceName
Obtiene el nombre de voz seleccionado.
string voiceName
Valor de propiedad
string
Nombre de voz.
Detalles del método
addTargetLanguage(string)
Agregue un idioma de destino (texto) al que se va a traducir.
function addTargetLanguage(value: string)
Parámetros
- value
-
string
Idioma como de-DE
close()
Elimine los recursos asociados.
function close()
fromAuthorizationToken(string, string)
Instancia estática de SpeechTranslationConfig devuelta pasando el token de autorización y la región del servicio. Nota: El autor de la llamada debe asegurarse de que el token de autorización es válido. Antes de que expire el token de autorización, el autor de la llamada debe actualizarlo estableciendo la propiedad authorizationToken con un nuevo token válido. De lo contrario, todos los reconocedores creados por esta instancia de SpeechTranslationConfig encontrarán errores durante el reconocimiento. Como los valores de configuración se copian al crear un nuevo reconocedor, el nuevo valor de token no se aplicará a los reconocedores que ya se han creado. Para los reconocedores que se han creado antes, debe establecer el token de autorización del reconocedor correspondiente para actualizar el token. De lo contrario, los reconocedores encontrarán errores durante el reconocimiento.
static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig
Parámetros
- authorizationToken
-
string
Token de autorización.
- region
-
string
El nombre de la región (consulte la página región).
Devoluciones
Configuración de traducción de voz.
fromEndpoint(URL, string)
Crea una instancia de la configuración de traducción de voz con el punto de conexión y la clave de suscripción especificados. Este método está pensado solo para los usuarios que usan un punto de conexión de servicio no estándar o paramters. Nota: Las propiedades de consulta especificadas en la dirección URL del punto de conexión no se cambian, aunque se establezcan mediante otras API. Por ejemplo, si el idioma se define en el URI como parámetro de consulta "language=de-DE" y también se establece mediante la propiedad speechRecognitionLanguage, el valor de idioma en URI tiene prioridad y el idioma efectivo es "de-DE". Solo otras API pueden establecer las propiedades que no se especifican en la dirección URL del punto de conexión. Nota: Para usar el token de autorización con fromEndpoint, pase una cadena vacía a subscriptionKey en el método fromEndpoint y, a continuación, establezca authorizationToken="token" en la instancia de SpeechConfig creada para usar el token de autorización.
static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig
Parámetros
- endpoint
-
URL
Punto de conexión de servicio al que se va a conectar.
- subscriptionKey
-
string
Clave de suscripción.
Devoluciones
Una instancia de configuración de voz.
fromHost(URL, string)
Crea una instancia de la configuración de voz con el host y la clave de suscripción especificados. Este método está pensado solo para los usuarios que usan un host de servicio no predeterminado. Se presupone la ruta de acceso del recurso estándar. En el caso de los servicios con una ruta de acceso de recursos no estándar o ninguna ruta de acceso, use fromEndpoint en su lugar. Nota: Los parámetros de consulta no se permiten en el URI del host y deben establecerse mediante otras API. Nota: Para usar un token de autorización con fromHost, use fromHost(URL) y establezca la propiedad AuthorizationToken en la instancia de SpeechConfig creada. Nota: Se ha agregado en la versión 1.9.0.
static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig
Parámetros
- hostName
-
URL
- subscriptionKey
-
string
Clave de suscripción. Si no se especifica una clave de suscripción, se debe establecer un token de autorización.
Devoluciones
Una instancia de la factoría de voz.
fromSubscription(string, string)
Instancia estática de SpeechTranslationConfig devuelta pasando una clave de suscripción y una región de servicio.
static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig
Parámetros
- subscriptionKey
-
string
Clave de suscripción.
- region
-
string
El nombre de la región (consulte la página región).
Devoluciones
Configuración de traducción de voz.
setProperty(string | PropertyId, string)
Establece una propiedad con nombre como valor
function setProperty(name: string | PropertyId, value: string)
Parámetros
- name
-
string | PropertyId
Nombre de la propiedad que se va a establecer.
- value
-
string
Nuevo valor de la propiedad.
Detalles de los métodos heredados
enableAudioLogging()
Habilite el registro de audio en el servicio. Los registros de audio y contenido se almacenan en el almacenamiento propiedad de Microsoft o en su propia cuenta de almacenamiento vinculada a la suscripción de Cognitive Services (Bring Your Own Storage [BYOS]) habilitado para el recurso de voz). Los registros se quitarán después de 30 días. Se agregó en la versión 1.7.0.
function enableAudioLogging()
Heredado deSpeechConfig.enableAudioLogging
enableDictation()
Habilite el dictado. Solo se admite en el reconocimiento continuo de voz. Se agregó en la versión 1.7.0.
function enableDictation()
Heredado deSpeechConfig.enableDictation
getProperty(string, string)
Devuelve el valor actual de una propiedad arbitraria.
function getProperty(name: string, def?: string): string
Parámetros
- name
-
string
Nombre de la propiedad que se va a consultar.
- def
-
string
El valor que se va a devolver en caso de que no se conozca la propiedad .
Devoluciones
string
Valor actual, o valor predeterminado proporcionado, de la propiedad especificada.
Heredado deSpeechConfig.getProperty
requestWordLevelTimestamps()
Incluye marcas de tiempo de nivel de palabra. Se agregó en la versión 1.7.0.
function requestWordLevelTimestamps()
Heredado deSpeechConfig.requestWordLevelTimestamps
setProfanity(ProfanityOption)
Establece la opción soeces. Se agregó en la versión 1.7.0.
function setProfanity(profanity: ProfanityOption)
Parámetros
- profanity
- ProfanityOption
Heredado deSpeechConfig.setProfanity
setProxy(string, number)
Establece la configuración de proxy. Solo es relevante en entornos de Node.js. Se agregó en la versión 1.4.0.
function setProxy(proxyHostName: string, proxyPort: number)
Parámetros
- proxyHostName
-
string
Nombre de host del servidor proxy.
- proxyPort
-
number
Número de puerto del servidor proxy.
Heredado deSpeechConfig.setProxy
setProxy(string, number, string, string)
Establece la configuración de proxy. Solo es relevante en entornos de Node.js. Se agregó en la versión 1.4.0.
function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)
Parámetros
- proxyHostName
-
string
Nombre de host del servidor proxy, sin el esquema de protocolo (http://)
- proxyPort
-
number
Número de puerto del servidor proxy.
- proxyUserName
-
string
Nombre de usuario del servidor proxy.
- proxyPassword
-
string
Contraseña del servidor proxy.
Heredado deSpeechConfig.setProxy
setServiceProperty(string, string, UriQueryParameter)
Establece un valor de propiedad que se pasará al servicio mediante el canal especificado. Se agregó en la versión 1.7.0.
function setServiceProperty(name: string, value: string, channel: UriQueryParameter)
Parámetros
- name
-
string
- value
-
string
- channel
- UriQueryParameter
Heredado deSpeechConfig.setServiceProperty