SpeechTranslationConfig 類別
類別，定義使用語音輸入進行翻譯的組態。
組態可以透過不同的方式初始化：
從訂用帳戶：傳遞訂用帳戶金鑰和區域
從端點：傳遞訂用帳戶金鑰和端點
從主機：傳遞訂用帳戶金鑰和主機位址
從授權權杖：傳遞授權權杖和區域
- 繼承
-
SpeechTranslationConfig
建構函式
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 = '')參數
| 名稱 | Description |
|---|---|
|
subscription
|
訂用帳戶金鑰。 預設值: None
|
|
region
|
區功能變數名稱稱 (請參閱 區域頁面) 。 預設值: None
|
|
endpoint
|
要連線的服務端點。 預設值: None
|
|
host
|
要連線的服務主機。 系統會假設標準資源路徑。 格式為 「protocol：//host：port」，其中 「:p ort」 是選擇性的。 預設值: None
|
|
auth_token
|
授權權杖。 預設值: None
|
|
speech_recognition_language
必要
|
語音辨識的輸入語言。 語言是以 BCP-47 格式指定。 |
|
target_languages
|
翻譯的目的語言。 預設值: None
|
|
voice_name
必要
|
要用於合成輸出的語音。 |
方法
| add_target_language |
將 語言 新增至翻譯的目的語言清單。 |
| enable_audio_logging |
啟用服務中的音訊記錄。 音訊和內容記錄會儲存在 Microsoft 擁有的儲存體，或連結到認知服務訂用帳戶的儲存體帳戶中， (自備儲存體 (BYOS) 啟用語音資源) 。 注意 已在 1.5.0 版中新增。 |
| enable_dictation |
啟用聽寫。 只有語音辨識支援。 注意 已在 1.5.0 版中新增。 |
| get_property |
依識別碼取得屬性。 |
| get_property_by_name |
依名稱取得屬性。 |
| remove_target_language |
從翻譯的目的語言清單中移除 語言 。 注意 已在 1.7.0 版中新增。 |
| request_word_level_timestamps |
在回應結果中包含字組層級時間戳記。 注意 已在 1.5.0 版中新增。 |
| set_profanity |
設定粗話選項。 注意 已在 1.5.0 版中新增。 |
| set_properties |
依識別碼設定多個屬性。 |
| set_properties_by_name |
依名稱設定多個屬性。 |
| set_property |
依識別碼設定屬性。 |
| set_property_by_name |
依名稱設定屬性。 |
| set_proxy |
設定 Proxy 資訊。 注意 macOS 上無法使用 Proxy 功能。 此函式不會影響 此平臺。 |
| set_service_property |
設定將使用指定通道傳遞至服務的屬性值。 注意 已在 1.5.0 版中新增。 |
| set_speech_synthesis_output_format |
設定語音合成輸出音訊格式。 |
add_target_language
將 語言 新增至翻譯的目的語言清單。
add_target_language(language: str)參數
| 名稱 | Description |
|---|---|
|
language
必要
|
要加入的語言代碼。 |
enable_audio_logging
啟用服務中的音訊記錄。 音訊和內容記錄會儲存在 Microsoft 擁有的儲存體，或連結到認知服務訂用帳戶的儲存體帳戶中， (自備儲存體 (BYOS) 啟用語音資源) 。
注意
已在 1.5.0 版中新增。
enable_audio_logging()enable_dictation
啟用聽寫。 只有語音辨識支援。
注意
已在 1.5.0 版中新增。
enable_dictation()get_property
依識別碼取得屬性。
get_property(property_id: PropertyId) -> str參數
| 名稱 | Description |
|---|---|
|
property_id
必要
|
要擷取之屬性的識別碼。 |
傳回
| 類型 | Description |
|---|---|
|
屬性的值。 |
get_property_by_name
依名稱取得屬性。
get_property_by_name(property_name: str) -> str參數
| 名稱 | Description |
|---|---|
|
property_name
必要
|
要擷取的屬性名稱。 |
傳回
| 類型 | Description |
|---|---|
|
屬性的值。 |
remove_target_language
從翻譯的目的語言清單中移除 語言 。
注意
已在 1.7.0 版中新增。
remove_target_language(language: str)參數
| 名稱 | Description |
|---|---|
|
language
必要
|
要移除的語言代碼。 |
request_word_level_timestamps
在回應結果中包含字組層級時間戳記。
注意
已在 1.5.0 版中新增。
request_word_level_timestamps()set_profanity
設定粗話選項。
注意
已在 1.5.0 版中新增。
set_profanity(profanity_option: ProfanityOption) -> None參數
| 名稱 | Description |
|---|---|
|
profanity_option
必要
|
要設定的不雅內容層級。 |
set_properties
依識別碼設定多個屬性。
set_properties(properties: Dict[PropertyId, str])參數
| 名稱 | Description |
|---|---|
|
properties
必要
|
要設定之值的聽寫對應屬性識別碼。 |
set_properties_by_name
依名稱設定多個屬性。
set_properties_by_name(properties: Dict[str, str])參數
| 名稱 | Description |
|---|---|
|
properties
必要
|
要設定之值的聽寫對應屬性識別碼。 |
set_property
依識別碼設定屬性。
set_property(property_id: PropertyId, value: str)參數
| 名稱 | Description |
|---|---|
|
property_id
必要
|
要設定之屬性的識別碼。 |
|
value
必要
|
要為 屬性設定的值。 |
set_property_by_name
依名稱設定屬性。
set_property_by_name(property_name: str, value: str)參數
| 名稱 | Description |
|---|---|
|
property_name
必要
|
要設定的屬性名稱。 |
|
value
必要
|
要為 屬性設定的值。 |
set_proxy
設定 Proxy 資訊。
注意
macOS 上無法使用 Proxy 功能。 此函式不會影響
此平臺。
set_proxy(hostname: str, port: int, username: str = None, password: str = None)參數
| 名稱 | Description |
|---|---|
|
hostname
必要
|
Proxy 伺服器的主機名稱。 請勿將通訊協定資訊 (HTTP) 新增至主機名稱。 |
|
port
必要
|
Proxy 伺服器的埠號碼。 |
|
username
|
Proxy 伺服器的使用者名稱。 預設值: None
|
|
password
|
Proxy 伺服器的密碼。 預設值: None
|
set_service_property
設定將使用指定通道傳遞至服務的屬性值。
注意
已在 1.5.0 版中新增。
set_service_property(name: str, value: str, channel: ServicePropertyChannel)參數
| 名稱 | Description |
|---|---|
|
name
必要
|
屬性名稱。 |
|
value
必要
|
屬性值。 |
|
channel
必要
|
用來將指定屬性傳遞至服務的通道。 |
set_speech_synthesis_output_format
設定語音合成輸出音訊格式。
set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)參數
| 名稱 | Description |
|---|---|
|
format_id
必要
|
音訊格式識別碼，例如 Riff16Khz16BitMonoPcm。 |
屬性
authorization_token
將用於連線至服務的授權權杖。
注意
呼叫端必須確定授權權杖有效。 在 之前
授權權杖到期，呼叫端必須使用 呼叫這個 setter 來重新整理它
新的有效權杖。 在建立新的辨識器時複製組態值時，
新的權杖值不會套用至已建立的辨識器。 For
之前已建立的辨識器，您必須設定 的授權權杖
要重新整理權杖的對應辨識器。 否則，辨識器將會遇到
辨識期間發生錯誤。
endpoint_id
端點識別碼。
output_format
輸出格式 (語音辨識結果的簡單或詳細) 。
region
用來建立辨識器的區域索引鍵。
speech_recognition_language
要以 BCP-47 格式辨識的口語名稱。
speech_synthesis_language
取得語音合成語言。
speech_synthesis_output_format_string
取得語音合成輸出音訊格式字串。
speech_synthesis_voice_name
取得語音合成語音名稱。
subscription_key
用來建立辨識器的訂用帳戶金鑰。
target_languages
翻譯的目的語言。
voice_name
要用於合成輸出的語音。
