SpeechTranslationConfig class

Paket:

microsoft-cognitiveservices-speech-sdk

Konuşma çevirisi yapılandırması. SpeechTranslationConfig

Extends

SpeechConfig

Özellikler

authorizationToken	Yetkilendirme belirtecini alır/ayarlar. Not: Çağıranın yetkilendirme belirtecinin geçerli olduğundan emin olması gerekir. Yetkilendirme belirtecinin süresi dolmadan önce çağıranın bu ayarlayıcıyı yeni geçerli bir belirteçle çağırarak yenilemesi gerekir.
endpointId	Konuşma tanıma için kullanılan özelleştirilmiş bir konuşma modelinin uç nokta kimliğini alır.
outputFormat	Konuşma tanıma çıkış biçimini alır (basit veya ayrıntılı). Not: Bu çıkış biçimi konuşma tanıma sonucuna yöneliktir, sentezlenmiş ses çıkış biçimini almak için [SpeechConfig.speechSynthesisOutputFormat] kullanın.
region
speechRecognitionLanguage	Konuşma tanıma dilini alır/ayarlar.
speechSynthesisLanguage	Konuşma sentezleyicisinin dilini alır. Sürüm 1.11.0'da eklendi.
speechSynthesisOutputFormat	Konuşma sentezi çıkış biçimini alır. Sürüm 1.11.0'da eklendi.
speechSynthesisVoiceName	Konuşma sentezleyicisinin sesini alır. Sürüm 1.11.0'da eklendi.
subscriptionKey
targetLanguages	Çevrilecek (metin) hedef dili alır.
tokenCredential	Yapılandırılmışsa TokenCredential örneğini alır. Yalnızca TokenCredential aracılığıyla AAD tabanlı kimlik doğrulaması kullanılıyorsa kullanılabilir.
voiceName	Seçilen ses adını alır.

Yöntemler

addTargetLanguage(string)	Çevrilecek bir (metin) hedef dil ekleyin.
close()	İlişkili kaynakları at.
fromAuthorizationToken(string, string)	Yetkilendirme belirteci ve hizmet bölgesi geçirilerek döndürülen statik SpeechTranslationConfig örneği. Not: Çağıranın yetkilendirme belirtecinin geçerli olduğundan emin olması gerekir. Yetkilendirme belirtecinin süresi dolmadan önce, çağıranın authorizationToken özelliğini yeni bir geçerli belirteçle ayarlayarak belirteci yenilemesi gerekir. Aksi takdirde, bu SpeechTranslationConfig örneği tarafından oluşturulan tüm tanıyıcılar tanıma sırasında hatalarla karşılaşır. Yeni bir tanıyıcı oluşturulurken yapılandırma değerleri kopyalandığından, yeni belirteç değeri önceden oluşturulmuş olan tanıyıcılar için geçerli olmaz. Daha önce oluşturulmuş tanıyıcılar için, belirteci yenilemek için ilgili tanıyıcının yetkilendirme belirtecini ayarlamanız gerekir. Aksi takdirde, tanıyıcılar tanıma sırasında hatalarla karşılaşır.
fromEndpoint(URL, KeyCredential | TokenCredential)	Özel bir uç nokta ve kimlik bilgisi ile konuşma çevirisi yapılandırmasının bir örneğini oluşturur. Uç nokta URI'sinde belirtilen sorgu parametreleri, başka bir API çağrısı tarafından ayarlansalar bile değiştirilmez. Örneğin, tanıma dili URI sorgu parametresinde "language=de-DE" olarak tanımlanmışsa ve SpeechRecognitionLanguage özelliği "en-US" olarak ayarlanmışsa, URI'de ayarlanan dil önceliklidir ve "de-DE" beklenen dil olarak kalır. Uç nokta URI'sine dahil edilen parametreler öncelikli olduğundan, yalnızca uç nokta URI'sinde belirtilmeyen parametreler diğer API'ler tarafından ayarlanabilir. Desteklenen kimlik bilgisi türleri: KeyCredential: API anahtarı tabanlı kimlik doğrulaması için. TokenCredential: Azure AD tabanlı kimlik doğrulaması için. Not: Yetkilendirme belirtecini fromEndpoint ile kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve ardından yetkilendirme belirtecini kullanmak için oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini ayarlayın.
fromEndpoint(URL, string)	Belirtilen uç nokta ve abonelik anahtarıyla konuşma çevirisi yapılandırmasının bir örneğini oluşturur. Bu yöntem yalnızca standart olmayan bir hizmet uç noktası veya parametreleri kullanan kullanıcılar için tasarlanmıştır. Not: Uç nokta URL'sinde belirtilen sorgu özellikleri, diğer API'ler tarafından ayarlanmış olsalar bile değiştirilmez. Örneğin, dil uri'de "language=de-DE" sorgu parametresi olarak tanımlanmışsa ve speechRecognitionLanguage özelliği tarafından da ayarlanmışsa, uri'deki dil ayarı önceliklidir ve etkin dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen özellikler diğer API'ler tarafından ayarlanabilir. Not: Yetkilendirme belirtecini fromEndpoint ile kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve ardından yetkilendirme belirtecini kullanmak için oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini ayarlayın.
fromHost(URL, string)	Belirtilen konak ve abonelik anahtarıyla konuşma yapılandırmasının bir örneğini oluşturur. Bu yöntem yalnızca varsayılan olmayan bir hizmet konağı kullanan kullanıcılara yöneliktir. Standart kaynak yolu varsayılır. Standart olmayan kaynak yolu olan veya hiç yol içermeyen hizmetler için bunun yerine fromEndpoint kullanın. Not: Konak URI'sinde sorgu parametrelerine izin verilmez ve diğer API'ler tarafından ayarlanmalıdır. Not: fromHost ile yetkilendirme belirteci kullanmak için fromHost(URL) kullanın ve ardından oluşturulan SpeechConfig örneğinde AuthorizationToken özelliğini ayarlayın. Not: Sürüm 1.9.0'a eklendi.
fromSubscription(string, string)	SpeechTranslationConfig'in statik örneği, bir abonelik anahtarı ve hizmet bölgesi geçirilerek döndürüldü.
setProperty(string | PropertyId, string)	Adlandırılmış özelliği değer olarak ayarlar

Devralınan Yöntemler

enableAudioLogging()	Hizmette ses günlüğünü etkinleştirin. Ses ve içerik günlükleri Microsoft'a ait depolama alanında veya Bilişsel Hizmetler aboneliğinize bağlı kendi depolama hesabınızda (Kendi DepolamaNızı Getir (BYOS) özellikli Konuşma kaynağınızda depolanır. Günlükler 30 gün sonra kaldırılır. Sürüm 1.7.0'da eklendi.
enableDictation()	Dikteyi etkinleştirin. Yalnızca konuşma sürekli tanımada desteklenir. Sürüm 1.7.0'da eklendi.
getProperty(string, string)	Rastgele bir özelliğin geçerli değerini döndürür.
requestWordLevelTimestamps()	Sözcük düzeyi zaman damgaları içerir. Sürüm 1.7.0'da eklendi.
setProfanity(ProfanityOption)	Küfür seçeneğini ayarlar. Sürüm 1.7.0'da eklendi.
setProxy(string, number)	Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'a eklendi.
setProxy(string, number, string, string)	Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'a eklendi.
setServiceProperty(string, string, UriQueryParameter)	Belirtilen kanalı kullanarak hizmete geçirilecek bir özellik değeri ayarlar. Sürüm 1.7.0'da eklendi.

Özellik Ayrıntıları

authorizationToken

Yetkilendirme belirtecini alır/ayarlar. Not: Çağıranın yetkilendirme belirtecinin geçerli olduğundan emin olması gerekir. Yetkilendirme belirtecinin süresi dolmadan önce çağıranın bu ayarlayıcıyı yeni geçerli bir belirteçle çağırarak yenilemesi gerekir.

void authorizationToken

Özellik Değeri

void

endpointId

Konuşma tanıma için kullanılan özelleştirilmiş bir konuşma modelinin uç nokta kimliğini alır.

string endpointId

Özellik Değeri

string

Uç nokta kimliği

outputFormat

Konuşma tanıma çıkış biçimini alır (basit veya ayrıntılı). Not: Bu çıkış biçimi konuşma tanıma sonucuna yöneliktir, sentezlenmiş ses çıkış biçimini almak için [SpeechConfig.speechSynthesisOutputFormat] kullanın.

OutputFormat outputFormat

Özellik Değeri

OutputFormat

Çıkış biçimini döndürür.

region

string region

Özellik Değeri

string

Yapılandırmada ayarlanan bölge.

speechRecognitionLanguage

Konuşma tanıma dilini alır/ayarlar.

void speechRecognitionLanguage

Özellik Değeri

void

speechSynthesisLanguage

Konuşma sentezleyicisinin dilini alır. Sürüm 1.11.0'da eklendi.

string speechSynthesisLanguage

Özellik Değeri

string

Konuşma sentezi dilini döndürür.

speechSynthesisOutputFormat

Konuşma sentezi çıkış biçimini alır. Sürüm 1.11.0'da eklendi.

SpeechSynthesisOutputFormat speechSynthesisOutputFormat

Özellik Değeri

SpeechSynthesisOutputFormat

Konuşma sentezi çıkış biçimini verir

speechSynthesisVoiceName

Konuşma sentezleyicisinin sesini alır. Sürüm 1.11.0'da eklendi.

string speechSynthesisVoiceName

Özellik Değeri

string

Konuşma sentezi sesini döndürür.

subscriptionKey

string subscriptionKey

Özellik Değeri

string

Yapılandırmada ayarlanan abonelik anahtarı.

targetLanguages

Çevrilecek (metin) hedef dili alır.

string[] targetLanguages

Özellik Değeri

string[]

tokenCredential

Yapılandırılmışsa TokenCredential örneğini alır. Yalnızca TokenCredential aracılığıyla AAD tabanlı kimlik doğrulaması kullanılıyorsa kullanılabilir.

TokenCredential | undefined tokenCredential

Özellik Değeri

TokenCredential | undefined

voiceName

Seçilen ses adını alır.

string voiceName

Özellik Değeri

string

Ses adı.

Yöntem Ayrıntıları

addTargetLanguage(string)

Çevrilecek bir (metin) hedef dil ekleyin.

function addTargetLanguage(value: string)

Parametreler

value

string

de-DE gibi bir dil

close()

İlişkili kaynakları at.

function close()

fromAuthorizationToken(string, string)

Yetkilendirme belirteci ve hizmet bölgesi geçirilerek döndürülen statik SpeechTranslationConfig örneği. Not: Çağıranın yetkilendirme belirtecinin geçerli olduğundan emin olması gerekir. Yetkilendirme belirtecinin süresi dolmadan önce, çağıranın authorizationToken özelliğini yeni bir geçerli belirteçle ayarlayarak belirteci yenilemesi gerekir. Aksi takdirde, bu SpeechTranslationConfig örneği tarafından oluşturulan tüm tanıyıcılar tanıma sırasında hatalarla karşılaşır. Yeni bir tanıyıcı oluşturulurken yapılandırma değerleri kopyalandığından, yeni belirteç değeri önceden oluşturulmuş olan tanıyıcılar için geçerli olmaz. Daha önce oluşturulmuş tanıyıcılar için, belirteci yenilemek için ilgili tanıyıcının yetkilendirme belirtecini ayarlamanız gerekir. Aksi takdirde, tanıyıcılar tanıma sırasında hatalarla karşılaşır.

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

Parametreler

authorizationToken

string

Yetkilendirme belirteci.

region

string

Bölge adı ( bölge sayfasına bakın).

Döndürülenler

SpeechTranslationConfig

Konuşma çevirisi yapılandırması.

fromEndpoint(URL, KeyCredential | TokenCredential)

Özel bir uç nokta ve kimlik bilgisi ile konuşma çevirisi yapılandırmasının bir örneğini oluşturur. Uç nokta URI'sinde belirtilen sorgu parametreleri, başka bir API çağrısı tarafından ayarlansalar bile değiştirilmez. Örneğin, tanıma dili URI sorgu parametresinde "language=de-DE" olarak tanımlanmışsa ve SpeechRecognitionLanguage özelliği "en-US" olarak ayarlanmışsa, URI'de ayarlanan dil önceliklidir ve "de-DE" beklenen dil olarak kalır. Uç nokta URI'sine dahil edilen parametreler öncelikli olduğundan, yalnızca uç nokta URI'sinde belirtilmeyen parametreler diğer API'ler tarafından ayarlanabilir. Desteklenen kimlik bilgisi türleri:

• KeyCredential: API anahtarı tabanlı kimlik doğrulaması için.
• TokenCredential: Azure AD tabanlı kimlik doğrulaması için. Not: Yetkilendirme belirtecini fromEndpoint ile kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve ardından yetkilendirme belirtecini kullanmak için oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini ayarlayın.

static function fromEndpoint(endpoint: URL, credential: KeyCredential | TokenCredential): SpeechTranslationConfig

Parametreler

endpoint

URL

Bağlanacak hizmet uç noktası.

credential

KeyCredential | TokenCredential

Kimlik doğrulaması için kullanılan kimlik bilgisi.

Döndürülenler

SpeechTranslationConfig

Konuşma fabrikası örneği.

fromEndpoint(URL, string)

Belirtilen uç nokta ve abonelik anahtarıyla konuşma çevirisi yapılandırmasının bir örneğini oluşturur. Bu yöntem yalnızca standart olmayan bir hizmet uç noktası veya parametreleri kullanan kullanıcılar için tasarlanmıştır. Not: Uç nokta URL'sinde belirtilen sorgu özellikleri, diğer API'ler tarafından ayarlanmış olsalar bile değiştirilmez. Örneğin, dil uri'de "language=de-DE" sorgu parametresi olarak tanımlanmışsa ve speechRecognitionLanguage özelliği tarafından da ayarlanmışsa, uri'deki dil ayarı önceliklidir ve etkin dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen özellikler diğer API'ler tarafından ayarlanabilir. Not: Yetkilendirme belirtecini fromEndpoint ile kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve ardından yetkilendirme belirtecini kullanmak için oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini ayarlayın.

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

Parametreler

endpoint

URL

Bağlanacak hizmet uç noktası.

subscriptionKey

string

Abonelik anahtarı.

Döndürülenler

SpeechTranslationConfig

Konuşma çevirisi yapılandırma örneği.

fromHost(URL, string)

Belirtilen konak ve abonelik anahtarıyla konuşma yapılandırmasının bir örneğini oluşturur. Bu yöntem yalnızca varsayılan olmayan bir hizmet konağı kullanan kullanıcılara yöneliktir. Standart kaynak yolu varsayılır. Standart olmayan kaynak yolu olan veya hiç yol içermeyen hizmetler için bunun yerine fromEndpoint kullanın. Not: Konak URI'sinde sorgu parametrelerine izin verilmez ve diğer API'ler tarafından ayarlanmalıdır. Not: fromHost ile yetkilendirme belirteci kullanmak için fromHost(URL) kullanın ve ardından oluşturulan SpeechConfig örneğinde AuthorizationToken özelliğini ayarlayın. Not: Sürüm 1.9.0'a eklendi.

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

Parametreler

hostName

URL

subscriptionKey

string

Abonelik anahtarı. Abonelik anahtarı belirtilmezse yetkilendirme belirteci ayarlanmalıdır.

Döndürülenler

SpeechTranslationConfig

Konuşma fabrikası örneği.

fromSubscription(string, string)

SpeechTranslationConfig'in statik örneği, bir abonelik anahtarı ve hizmet bölgesi geçirilerek döndürüldü.

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

Parametreler

subscriptionKey

string

Abonelik anahtarı.

region

string

Bölge adı ( bölge sayfasına bakın).

Döndürülenler

SpeechTranslationConfig

Konuşma çevirisi yapılandırması.

setProperty(string | PropertyId, string)

Adlandırılmış özelliği değer olarak ayarlar

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

Parametreler

name

string | PropertyId

Ayarlanacağı özelliğin adı.

value

string

özelliğinin yeni değeri.

Devralınan Yöntemin Ayrıntıları

enableAudioLogging()

Hizmette ses günlüğünü etkinleştirin. Ses ve içerik günlükleri Microsoft'a ait depolama alanında veya Bilişsel Hizmetler aboneliğinize bağlı kendi depolama hesabınızda (Kendi DepolamaNızı Getir (BYOS) özellikli Konuşma kaynağınızda depolanır. Günlükler 30 gün sonra kaldırılır. Sürüm 1.7.0'da eklendi.

function enableAudioLogging()

Devralındığı yer:SpeechConfig.enableAudioLogging

enableDictation()

Dikteyi etkinleştirin. Yalnızca konuşma sürekli tanımada desteklenir. Sürüm 1.7.0'da eklendi.

function enableDictation()

Devralındığı yer:SpeechConfig.enableDictation

getProperty(string, string)

Rastgele bir özelliğin geçerli değerini döndürür.

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

Parametreler

name

string

Sorgu için özelliğin adı.

def

string

Özelliğin bilinmemesi durumunda döndürülecek değer.

Döndürülenler

string

Verilen özelliğin geçerli değeri veya sağlanan varsayılan değeri.

Devralındığı yer:SpeechConfig.getProperty

requestWordLevelTimestamps()

Sözcük düzeyi zaman damgaları içerir. Sürüm 1.7.0'da eklendi.

function requestWordLevelTimestamps()

Devralındığı yer:SpeechConfig.requestWordLevelTimestamps

setProfanity(ProfanityOption)

Küfür seçeneğini ayarlar. Sürüm 1.7.0'da eklendi.

function setProfanity(profanity: ProfanityOption)

Parametreler

profanity

ProfanityOption

Devralındığı yer:SpeechConfig.setProfanity

setProxy(string, number)

Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'a eklendi.

function setProxy(proxyHostName: string, proxyPort: number)

Parametreler

proxyHostName

string

Ara sunucunun ana bilgisayar adı.

proxyPort

number

Ara sunucunun bağlantı noktası numarası.

Devralındığı yer:SpeechConfig.setProxy

setProxy(string, number, string, string)

Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'a eklendi.

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

Parametreler

proxyHostName

string

Protokol şeması olmadan ara sunucunun ana bilgisayar adı (http://)

proxyPort

number

Ara sunucunun bağlantı noktası numarası.

proxyUserName

string

Proxy sunucusunun kullanıcı adı.

proxyPassword

string

Proxy sunucusunun parolası.

Devralındığı yer:SpeechConfig.setProxy

setServiceProperty(string, string, UriQueryParameter)

Belirtilen kanalı kullanarak hizmete geçirilecek bir özellik değeri ayarlar. Sürüm 1.7.0'da eklendi.

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

Parametreler

name

string

value

string

channel

UriQueryParameter

Devralındığı yer:SpeechConfig.setServiceProperty