SpeechConfig 類別

類別，定義語音/意圖辨識和語音合成的組態。

組態可以透過不同的方式初始化：

• 來自訂用帳戶：傳遞訂用帳戶金鑰和區域

• 來自端點：傳遞端點。 訂用帳戶金鑰或授權權杖是選擇性的。

• 來自主機：傳遞主機位址。 訂用帳戶金鑰或授權權杖是選擇性的。

• 從授權權杖：傳遞授權權杖和區域

繼承

builtins.object

SpeechConfig

建構函式

SpeechConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, speech_recognition_language: str | None = None)

參數

名稱	Description
subscription	訂用帳戶金鑰。 預設值: None
region	區功能變數名稱稱 (請參閱 區域頁面) 。 預設值: None
endpoint	要連線的服務端點。 預設值: None
host	要連線的服務主機。 系統會假設標準資源路徑。 格式為 「protocol：//host：port」，其中 「:p ort」 是選擇性的。 預設值: None
auth_token	授權權杖。 預設值: None
speech_recognition_language	語音辨識的輸入語言。 語言是以 BCP-47 格式指定。 預設值: None

方法

enable_audio_logging	啟用服務中的音訊記錄。 音訊和內容記錄會儲存在 Microsoft 擁有的儲存體，或連結到認知服務訂用帳戶的儲存體帳戶中， (自備儲存體 (BYOS) 啟用語音資源) 。 注意 已在 1.5.0 版中新增。
enable_dictation	啟用聽寫。 只有語音辨識支援。 注意 已在 1.5.0 版中新增。
get_property	依識別碼取得屬性。
get_property_by_name	依名稱取得屬性。
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	設定語音合成輸出音訊格式。

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
	屬性的值。

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

用來建立辨識器的訂用帳戶金鑰。