SpeechTranslationConfig class

Paket:

microsoft-cognitiveservices-speech-sdk

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

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 bir geçerli 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 hedef dili (metin) alır.
voiceName	Seçili ses adını alır.

Yöntemler

addTargetLanguage(string)	Çevrilecek bir (metin) hedef dili ekleyin.
close()	İlişkili kaynakları at.
fromAuthorizationToken(string, string)	Yetkilendirme belirteci ve hizmet bölgesi geçirilerek döndürülen SpeechTranslationConfig'in statik ö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 bu 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ş olan 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, 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 parametre kullanan kullanıcılara yöneliktir. Not: Uç nokta URL'sinde belirtilen sorgu özellikleri, diğer API'ler tarafından ayarlansalar bile değiştirilmez. Örneğin, dil uri'de "language=de-DE" sorgu parametresi olarak tanımlanırsa ve speechRecognitionLanguage özelliği tarafından ayarlanırsa, uri'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen özellikler diğer API'ler tarafından ayarlanabilir. Not: fromEndpoint ile yetkilendirme belirteci kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve 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 ayarlanması gerekir. 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'da eklendi.
fromSubscription(string, string)	Bir abonelik anahtarı ve hizmet bölgesi geçirilerek döndürülen SpeechTranslationConfig'in statik örneği.
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 (Kendi DepolamaNızı Getir (BYOS) özellikli Konuşma kaynağınıza bağlı kendi depolama hesabı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'da 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'da eklendi.
setServiceProperty(string, string, UriQueryParameter)	Belirtilen kanal kullanılarak 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 bir geçerli 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 hedef dili (metin) alır.

string[] targetLanguages

Özellik Değeri

string[]

voiceName

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

string voiceName

Özellik Değeri

string

Ses adı.

Yöntem Ayrıntıları

addTargetLanguage(string)

Çevrilecek bir (metin) hedef dili 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 SpeechTranslationConfig'in statik ö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 bu 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ş olan 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, 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 parametre kullanan kullanıcılara yöneliktir. Not: Uç nokta URL'sinde belirtilen sorgu özellikleri, diğer API'ler tarafından ayarlansalar bile değiştirilmez. Örneğin, dil uri'de "language=de-DE" sorgu parametresi olarak tanımlanırsa ve speechRecognitionLanguage özelliği tarafından ayarlanırsa, uri'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen özellikler diğer API'ler tarafından ayarlanabilir. Not: fromEndpoint ile yetkilendirme belirteci kullanmak için fromEndpoint yönteminde subscriptionKey'e boş bir dize geçirin ve 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 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 ayarlanması gerekir. 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'da eklendi.

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

Parametreler

hostName

URL

subscriptionKey

string

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

Döndürülenler

SpeechConfig

Konuşma fabrikası örneği.

fromSubscription(string, string)

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

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

Ayarlanacak özelliğin adı.

value

string

Özelliğin 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 (Kendi DepolamaNızı Getir (BYOS) özellikli Konuşma kaynağınıza bağlı kendi depolama hesabı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()

SpeechConfig.enableAudioLogging'denDevralındı

enableDictation()

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

function enableDictation()

SpeechConfig.enableDictation'danDevralındı

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ğer.

SpeechConfig.getProperty'denDevralındı

requestWordLevelTimestamps()

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

function requestWordLevelTimestamps()

SpeechConfig.requestWordLevelTimestamps'tanDevralındı

setProfanity(ProfanityOption)

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

function setProfanity(profanity: ProfanityOption)

Parametreler

profanity

ProfanityOption

SpeechConfig.setProfanity'denDevralındı

setProxy(string, number)

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

function setProxy(proxyHostName: string, proxyPort: number)

Parametreler

proxyHostName

string

Ara sunucunun ana bilgisayar adı.

proxyPort

number

Ara sunucunun bağlantı noktası numarası.

SpeechConfig.setProxy'denDevralındı

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'da 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

Ara sunucunun kullanıcı adı.

proxyPassword

string

Ara sunucunun parolası.

SpeechConfig.setProxy'denDevralındı

setServiceProperty(string, string, UriQueryParameter)

Belirtilen kanal kullanılarak 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

SpeechConfig.setServiceProperty'denDevralındı