SpeechTranslationConfig class

Paquete:

microsoft-cognitiveservices-speech-sdk

Configuración de traducción de voz.

Extends

SpeechConfig

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.
endpointId	Obtiene el identificador de punto de conexión de un modelo de voz personalizado que se usa para el reconocimiento de voz.
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.
region
speechRecognitionLanguage	Obtiene o establece el idioma de reconocimiento de voz.
speechSynthesisLanguage	Obtiene el idioma del sintetizador de voz. Se agregó en la versión 1.11.0.
speechSynthesisOutputFormat	Obtiene el formato de salida de síntesis de voz. Se agregó en la versión 1.11.0.
speechSynthesisVoiceName	Obtiene la voz del sintetizador de voz. Se agregó en la versión 1.11.0.
subscriptionKey
targetLanguages	Obtiene el idioma de destino (texto) en el que se va a traducir.
voiceName	Obtiene el nombre de voz seleccionado.

Métodos

addTargetLanguage(string)	Agregue un idioma de destino (texto) al que se va a traducir.
close()	Elimine los recursos asociados.
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.
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.
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.
fromSubscription(string, string)	Instancia estática de SpeechTranslationConfig devuelta pasando una clave de suscripción y una región de servicio.
setProperty(string | PropertyId, string)	Establece una propiedad con nombre como valor

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.
enableDictation()	Habilite el dictado. Solo se admite en el reconocimiento continuo de voz. Se agregó en la versión 1.7.0.
getProperty(string, string)	Devuelve el valor actual de una propiedad arbitraria.
requestWordLevelTimestamps()	Incluye marcas de tiempo de nivel de palabra. Se agregó en la versión 1.7.0.
setProfanity(ProfanityOption)	Establece la opción soeces. Se agregó en la versión 1.7.0.
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.
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.
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.

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

OutputFormat

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

SpeechSynthesisOutputFormat

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

SpeechTranslationConfig

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

SpeechTranslationConfig

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

SpeechConfig

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

SpeechTranslationConfig

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