SpeechTranslationConfig Classe

Classe che definisce le configurazioni per la traduzione con input vocale.

La configurazione può essere inizializzata in modi diversi:

  • dalla sottoscrizione: passare una chiave di sottoscrizione e un'area

  • dall'endpoint: passare una chiave di sottoscrizione e un endpoint

  • dall'host: passare una chiave di sottoscrizione e un indirizzo host

  • dal token di autorizzazione: passare un token di autorizzazione e un'area

Ereditarietà
SpeechTranslationConfig

Costruttore

SpeechTranslationConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, target_languages: Iterable[str] = None, voice_name: str = '', speech_recognition_language: str = '')

Parametri

Nome Descrizione
subscription

Chiave di sottoscrizione.

valore predefinito: None
region

Nome dell'area (vedere la pagina dell'area).

valore predefinito: None
endpoint

Endpoint del servizio a cui connettersi.

valore predefinito: None
host

Host del servizio a cui connettersi. Si presuppone il percorso della risorsa standard. Il formato è "protocol://host:port" dove ":p ort" è facoltativo.

valore predefinito: None
auth_token

Token di autorizzazione.

valore predefinito: None
speech_recognition_language
Necessario

Lingua di input per il riconoscimento vocale. La lingua viene specificata in formato BCP-47.

target_languages

Lingue di destinazione per la traduzione.

valore predefinito: None
voice_name
Necessario

Voce da usare per l'output sintetizzato.

Metodi

add_target_language

Aggiungere la lingua all'elenco delle lingue di destinazione per la traduzione.

enable_audio_logging

Abilita la registrazione audio nel servizio. I log audio e di contenuto vengono archiviati nella risorsa di archiviazione di proprietà di Microsoft o nel proprio account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (risorsa Di archiviazione personalizzata (BYOS) abilitata per il riconoscimento vocale.

Nota

Aggiunta nella versione 1.5.0.

enable_dictation

Abilita la dettatura. Supportato solo nel riconoscimento vocale continuo.

Nota

Aggiunta nella versione 1.5.0.

get_property

Ottenere una proprietà in base all'ID.

get_property_by_name

Ottenere una proprietà in base al nome.

remove_target_language

Rimuovere la lingua dall'elenco delle lingue di destinazione per la traduzione.

Nota

Aggiunta nella versione 1.7.0.

request_word_level_timestamps

Include timestamp a livello di parola nel risultato della risposta.

Nota

Aggiunta nella versione 1.5.0.

set_profanity

Impostare l'opzione volgarity.

Nota

Aggiunta nella versione 1.5.0.

set_properties

Impostare più proprietà in base all'ID.

set_properties_by_name

Impostare più proprietà in base al nome.

set_property

Impostare una proprietà in base all'ID.

set_property_by_name

Impostare una proprietà in base al nome.

set_proxy

Impostare le informazioni sul proxy.

Nota

La funzionalità proxy non è disponibile in macOS. Questa funzione non avrà alcun effetto su

questa piattaforma.

set_service_property

Imposta un valore della proprietà che verrà passato al servizio usando il canale specificato.

Nota

Aggiunta nella versione 1.5.0.

set_speech_synthesis_output_format

Impostare il formato audio di output della sintesi vocale.

add_target_language

Aggiungere la lingua all'elenco delle lingue di destinazione per la traduzione.

add_target_language(language: str)

Parametri

Nome Descrizione
language
Necessario

Codice linguistico da aggiungere.

enable_audio_logging

Abilita la registrazione audio nel servizio. I log audio e di contenuto vengono archiviati nella risorsa di archiviazione di proprietà di Microsoft o nel proprio account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (risorsa Di archiviazione personalizzata (BYOS) abilitata per il riconoscimento vocale.

Nota

Aggiunta nella versione 1.5.0.

enable_audio_logging()

enable_dictation

Abilita la dettatura. Supportato solo nel riconoscimento vocale continuo.

Nota

Aggiunta nella versione 1.5.0.

enable_dictation()

get_property

Ottenere una proprietà in base all'ID.

get_property(property_id: PropertyId) -> str

Parametri

Nome Descrizione
property_id
Necessario

ID della proprietà da recuperare.

Restituisce

Tipo Descrizione

Valore della proprietà.

get_property_by_name

Ottenere una proprietà in base al nome.

get_property_by_name(property_name: str) -> str

Parametri

Nome Descrizione
property_name
Necessario

Nome della proprietà da recuperare.

Restituisce

Tipo Descrizione

Valore della proprietà.

remove_target_language

Rimuovere la lingua dall'elenco delle lingue di destinazione per la traduzione.

Nota

Aggiunta nella versione 1.7.0.

remove_target_language(language: str)

Parametri

Nome Descrizione
language
Necessario

Codice linguistico da rimuovere.

request_word_level_timestamps

Include timestamp a livello di parola nel risultato della risposta.

Nota

Aggiunta nella versione 1.5.0.

request_word_level_timestamps()

set_profanity

Impostare l'opzione volgarity.

Nota

Aggiunta nella versione 1.5.0.

set_profanity(profanity_option: ProfanityOption) -> None

Parametri

Nome Descrizione
profanity_option
Necessario

Livello di contenuto volgare da impostare.

set_properties

Impostare più proprietà in base all'ID.

set_properties(properties: Dict[PropertyId, str])

Parametri

Nome Descrizione
properties
Necessario

Id proprietà di mapping ai valori da impostare.

set_properties_by_name

Impostare più proprietà in base al nome.

set_properties_by_name(properties: Dict[str, str])

Parametri

Nome Descrizione
properties
Necessario

Id proprietà di mapping ai valori da impostare.

set_property

Impostare una proprietà in base all'ID.

set_property(property_id: PropertyId, value: str)

Parametri

Nome Descrizione
property_id
Necessario

ID della proprietà da impostare.

value
Necessario

Valore da impostare per la proprietà .

set_property_by_name

Impostare una proprietà in base al nome.

set_property_by_name(property_name: str, value: str)

Parametri

Nome Descrizione
property_name
Necessario

Nome della proprietà da impostare.

value
Necessario

Valore da impostare per la proprietà .

set_proxy

Impostare le informazioni sul proxy.

Nota

La funzionalità proxy non è disponibile in macOS. Questa funzione non avrà alcun effetto su

questa piattaforma.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

Parametri

Nome Descrizione
hostname
Necessario

Nome host del server proxy. Non aggiungere informazioni sul protocollo (http) al nome host.

port
Necessario

Numero di porta del server proxy.

username

Nome utente del server proxy.

valore predefinito: None
password

Password del server proxy.

valore predefinito: None

set_service_property

Imposta un valore della proprietà che verrà passato al servizio usando il canale specificato.

Nota

Aggiunta nella versione 1.5.0.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

Parametri

Nome Descrizione
name
Necessario

Nome della proprietà.

value
Necessario

Valore della proprietà.

channel
Necessario

Canale utilizzato per passare la proprietà specificata al servizio.

set_speech_synthesis_output_format

Impostare il formato audio di output della sintesi vocale.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Parametri

Nome Descrizione
format_id
Necessario

ID del formato audio, ad esempio Riff16Khz16BitMonoPcm.

Attributi

authorization_token

Token di autorizzazione che verrà usato per la connessione al servizio.

Nota

Il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della

il token di autorizzazione scade, il chiamante deve aggiornarlo chiamando questo setter con un

nuovo token valido. Man mano che i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscitore,

il nuovo valore del token non verrà applicato ai riconoscitori che sono già stati creati. For

riconoscitori creati in precedenza, è necessario impostare il token di autorizzazione del

riconoscitore corrispondente per aggiornare il token. In caso contrario, i riconoscitori incontreranno

errori durante il riconoscimento.

endpoint_id

ID endpoint.

output_format

Formato di output (semplice o dettagliato) del risultato del riconoscimento vocale.

region

Chiave dell'area usata per creare il sistema di riconoscimento.

speech_recognition_language

Nome della lingua parlata da riconoscere in formato BCP-47.

speech_synthesis_language

Ottenere il linguaggio di sintesi vocale.

speech_synthesis_output_format_string

Ottenere la stringa di formato audio per l'output della sintesi vocale.

speech_synthesis_voice_name

Ottenere il nome della voce di sintesi vocale.

subscription_key

Chiave di sottoscrizione usata per creare Il riconoscimento.

target_languages

Lingue di destinazione per la traduzione.

voice_name

Voce da usare per l'output sintetizzato.