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」。。 只有端點 URL 中未指定的屬性，才能由其他 API 設定。 注意：若要搭配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」。。 只有端點 URL 中未指定的屬性，才能由其他 API 設定。 注意：若要搭配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