SpeechTranslationConfig class

套件:

microsoft-cognitiveservices-speech-sdk

語音翻譯組態。

Extends

SpeechConfig

屬性

authorizationToken	取得/設定授權權杖。 注意：呼叫端必須確定授權權杖有效。 授權權杖到期之前，呼叫端必須使用新的有效權杖呼叫這個 setter 來重新整理它。
endpointId	取得用於語音辨識之自訂語音模型的端點識別碼。
outputFormat	取得 (簡單或詳細) 的語音辨識輸出格式。 注意：此輸出格式適用于語音辨識結果，請使用 [SpeechConfig.speechSynthesisOutputFormat] 來取得合成的音訊輸出格式。
region
speechRecognitionLanguage	取得/設定語音辨識語言。
speechSynthesisLanguage	取得語音合成器的語言。 已在 1.11.0 版中新增。
speechSynthesisOutputFormat	取得語音合成輸出格式。 已在 1.11.0 版中新增。
speechSynthesisVoiceName	取得語音合成器的語音。 已在 1.11.0 版中新增。
subscriptionKey
targetLanguages	取得要翻譯的目的語言 (文字) 。
voiceName	取得選取的語音名稱。

方法

addTargetLanguage(string)	新增 (文字) 要翻譯的目的語言。
close()	處置相關聯的資源。
fromAuthorizationToken(string, string)	傳遞授權權杖和服務區域所傳回的 SpeechTranslationConfig 靜態實例。 注意：呼叫端必須確定授權權杖有效。 在授權權杖到期之前，呼叫端必須以新的有效權杖設定屬性 authorizationToken 來重新整理它。 否則，這個 SpeechTranslationConfig 實例所建立的所有辨識器都會在辨識期間發生錯誤。 當建立新的辨識器時複製組態值時，新的權杖值將不會套用至已建立的辨識器。 針對先前建立的辨識器，您必須設定對應辨識器的授權權杖以重新整理權杖。 否則，辨識器會在辨識期間發生錯誤。
fromEndpoint(URL, string)	使用指定的端點和訂用帳戶金鑰，建立語音翻譯設定的實例。 這個方法僅適用于使用非標準服務端點或參數的使用者。 注意：端點 URL 中指定的查詢屬性不會變更，即使它們是由任何其他 API 設定也一樣。 例如，如果語言在 uri 中定義為查詢參數 「language=de-DE」，而且也會由 speechRecognitionLanguage 屬性設定，則 uri 中的語言設定優先，且有效語言為 「de-DE」。 其他 API 只能設定未在端點 URL 中指定的屬性。 注意：若要搭配 fromEndpoint 使用授權權杖，請將空字串傳遞至 fromEndpoint 方法中的 subscriptionKey，然後在建立的 SpeechConfig 實例上設定 authorizationToken=「token」 以使用授權權杖。
fromHost(URL, string)	使用指定的主機和訂用帳戶金鑰，建立語音設定的實例。 這個方法僅適用于使用非預設服務主機的使用者。 將會假設標準資源路徑。 對於具有非標準資源路徑或完全沒有路徑的服務，請改用 fromEndpoint。 注意：主機 URI 中不允許查詢參數，而且必須由其他 API 設定。 注意：若要搭配 fromHost 使用授權權杖，請使用 fromHost (URL) ，然後在建立的 SpeechConfig 實例上設定 AuthorizationToken 屬性。 注意：已在 1.9.0 版中新增。
fromSubscription(string, string)	傳遞訂用帳戶金鑰和服務區域所傳回的 SpeechTranslationConfig 靜態實例。
setProperty(string | PropertyId, string)	將具名屬性設定為值

繼承的方法

enableAudioLogging()	在服務中啟用音訊記錄。 音訊和內容記錄會儲存在 Microsoft 擁有的儲存體，或連結到認知服務訂用帳戶的儲存體帳戶中， (自備儲存體 (BYOS) 啟用語音資源) 。 記錄會在 30 天后移除。 已在 1.7.0 版中新增。
enableDictation()	啟用聽寫。 只有在語音辨識中才支援。 已在 1.7.0 版中新增。
getProperty(string, string)	傳回任意屬性的目前值。
requestWordLevelTimestamps()	包含文字層級時間戳記。 已在 1.7.0 版中新增。
setProfanity(ProfanityOption)	設定不雅內容選項。 已在 1.7.0 版中新增。
setProxy(string, number)	設定 Proxy 組態。 僅適用于 Node.js 環境。 已在 1.4.0 版中新增。
setProxy(string, number, string, string)	設定 Proxy 組態。 僅適用于 Node.js 環境。 已在 1.4.0 版中新增。
setServiceProperty(string, string, UriQueryParameter)	設定將使用指定通道傳遞至服務的屬性值。 已在 1.7.0 版中新增。

屬性詳細資料

authorizationToken

取得/設定授權權杖。 注意：呼叫端必須確定授權權杖有效。 授權權杖到期之前，呼叫端必須使用新的有效權杖呼叫這個 setter 來重新整理它。

void authorizationToken

屬性值

void

endpointId

取得用於語音辨識之自訂語音模型的端點識別碼。

string endpointId

屬性值

string

端點識別碼

outputFormat

取得 (簡單或詳細) 的語音辨識輸出格式。 注意：此輸出格式適用于語音辨識結果，請使用 [SpeechConfig.speechSynthesisOutputFormat] 來取得合成的音訊輸出格式。

OutputFormat outputFormat

屬性值

OutputFormat

傳回輸出格式。

region

string region

屬性值

string

設定上設定的區域。

speechRecognitionLanguage

取得/設定語音辨識語言。

void speechRecognitionLanguage

屬性值

void

speechSynthesisLanguage

取得語音合成器的語言。 已在 1.11.0 版中新增。

string speechSynthesisLanguage

屬性值

string

傳回語音合成語言。

speechSynthesisOutputFormat

取得語音合成輸出格式。 已在 1.11.0 版中新增。

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

屬性值

SpeechSynthesisOutputFormat

傳回語音合成輸出格式

speechSynthesisVoiceName

取得語音合成器的語音。 已在 1.11.0 版中新增。

string speechSynthesisVoiceName

屬性值

string

傳回語音合成語音。

subscriptionKey

string subscriptionKey

屬性值

string

在組態上設定的訂用帳戶金鑰。

targetLanguages

取得要翻譯的目的語言 (文字) 。

string[] targetLanguages

屬性值

string[]

voiceName

取得選取的語音名稱。

string voiceName

屬性值

string

語音名稱。

方法詳細資料

addTargetLanguage(string)

新增 (文字) 要翻譯的目的語言。

function addTargetLanguage(value: string)

參數

value

string

de-DE 之類的語言

close()

處置相關聯的資源。

function close()

fromAuthorizationToken(string, string)

傳遞授權權杖和服務區域所傳回的 SpeechTranslationConfig 靜態實例。 注意：呼叫端必須確定授權權杖有效。 在授權權杖到期之前，呼叫端必須以新的有效權杖設定屬性 authorizationToken 來重新整理它。 否則，這個 SpeechTranslationConfig 實例所建立的所有辨識器都會在辨識期間發生錯誤。 當建立新的辨識器時複製組態值時，新的權杖值將不會套用至已建立的辨識器。 針對先前建立的辨識器，您必須設定對應辨識器的授權權杖以重新整理權杖。 否則，辨識器會在辨識期間發生錯誤。

static function fromAuthorizationToken(authorizationToken: string, region: string): SpeechTranslationConfig

參數

authorizationToken

string

授權權杖。

region

string

區功能變數名稱稱 (請參閱 區域頁面) 。

傳回

SpeechTranslationConfig

語音翻譯設定。

fromEndpoint(URL, string)

使用指定的端點和訂用帳戶金鑰，建立語音翻譯設定的實例。 這個方法僅適用于使用非標準服務端點或參數的使用者。 注意：端點 URL 中指定的查詢屬性不會變更，即使它們是由任何其他 API 設定也一樣。 例如，如果語言在 uri 中定義為查詢參數 「language=de-DE」，而且也會由 speechRecognitionLanguage 屬性設定，則 uri 中的語言設定優先，且有效語言為 「de-DE」。 其他 API 只能設定未在端點 URL 中指定的屬性。 注意：若要搭配 fromEndpoint 使用授權權杖，請將空字串傳遞至 fromEndpoint 方法中的 subscriptionKey，然後在建立的 SpeechConfig 實例上設定 authorizationToken=「token」 以使用授權權杖。

static function fromEndpoint(endpoint: URL, subscriptionKey: string): SpeechTranslationConfig

參數

endpoint

URL

要連線的服務端點。

subscriptionKey

string

訂用帳戶金鑰。

傳回

SpeechTranslationConfig

語音設定實例。

fromHost(URL, string)

使用指定的主機和訂用帳戶金鑰，建立語音設定的實例。 這個方法僅適用于使用非預設服務主機的使用者。 將會假設標準資源路徑。 對於具有非標準資源路徑或完全沒有路徑的服務，請改用 fromEndpoint。 注意：主機 URI 中不允許查詢參數，而且必須由其他 API 設定。 注意：若要搭配 fromHost 使用授權權杖，請使用 fromHost (URL) ，然後在建立的 SpeechConfig 實例上設定 AuthorizationToken 屬性。 注意：已在 1.9.0 版中新增。

static function fromHost(hostName: URL, subscriptionKey?: string): SpeechConfig

參數

hostName

URL

subscriptionKey

string

訂用帳戶金鑰。 如果未指定訂用帳戶金鑰，則必須設定授權權杖。

傳回

SpeechConfig

語音處理站實例。

fromSubscription(string, string)

傳遞訂用帳戶金鑰和服務區域所傳回的 SpeechTranslationConfig 靜態實例。

static function fromSubscription(subscriptionKey: string, region: string): SpeechTranslationConfig

參數

subscriptionKey

string

訂用帳戶金鑰。

region

string

區功能變數名稱稱 (請參閱 區域頁面) 。

傳回

SpeechTranslationConfig

語音翻譯設定。

setProperty(string | PropertyId, string)

將具名屬性設定為值

function setProperty(name: string | PropertyId, value: string)

參數

name

string | PropertyId

所要設定的屬性名稱。

value

string

屬性的新值。

繼承的方法的詳細資料

enableAudioLogging()

在服務中啟用音訊記錄。 音訊和內容記錄會儲存在 Microsoft 擁有的儲存體，或連結到認知服務訂用帳戶的儲存體帳戶中， (自備儲存體 (BYOS) 啟用語音資源) 。 記錄會在 30 天后移除。 已在 1.7.0 版中新增。

function enableAudioLogging()

繼承自SpeechConfig.enableAudioLogging

enableDictation()

啟用聽寫。 只有在語音辨識中才支援。 已在 1.7.0 版中新增。

function enableDictation()

繼承自SpeechConfig.enableDictation

getProperty(string, string)

傳回任意屬性的目前值。

function getProperty(name: string, def?: string): string

參數

name

string

要查詢的屬性名稱。

def

string

如果屬性未知，則傳回的值。

傳回

string

指定屬性的目前值或提供的預設值。

繼承自SpeechConfig.getProperty

requestWordLevelTimestamps()

包含文字層級時間戳記。 已在 1.7.0 版中新增。

function requestWordLevelTimestamps()

繼承自SpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

設定不雅內容選項。 已在 1.7.0 版中新增。

function setProfanity(profanity: ProfanityOption)

參數

profanity

ProfanityOption

繼承自SpeechConfig.setProfanity

setProxy(string, number)

設定 Proxy 組態。 僅適用于 Node.js 環境。 已在 1.4.0 版中新增。

function setProxy(proxyHostName: string, proxyPort: number)

參數

proxyHostName

string

Proxy 伺服器的主機名稱。

proxyPort

number

Proxy 伺服器的埠號碼。

繼承自SpeechConfig.setProxy

setProxy(string, number, string, string)

設定 Proxy 組態。 僅適用于 Node.js 環境。 已在 1.4.0 版中新增。

function setProxy(proxyHostName: string, proxyPort: number, proxyUserName: string, proxyPassword: string)

參數

proxyHostName

string

Proxy 伺服器的主機名稱，不含通訊協定配置 (HTTP：//)

proxyPort

number

Proxy 伺服器的埠號碼。

proxyUserName

string

Proxy 伺服器的使用者名稱。

proxyPassword

string

Proxy 伺服器的密碼。

繼承自SpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

設定將使用指定通道傳遞至服務的屬性值。 已在 1.7.0 版中新增。

function setServiceProperty(name: string, value: string, channel: UriQueryParameter)

參數

name

string

value

string

channel

UriQueryParameter

繼承自SpeechConfig.setServiceProperty