SpeechConfig class

Paket:

microsoft-cognitiveservices-speech-sdk

Konuşma yapılandırması.

Özellikler

authorizationToken	Yetkilendirme belirtecini alır.
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	Yapılandırılan dili döndürür.
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

Yöntemler

close()	Yapılandırmayı kapatır.
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.
fromAuthorizationToken(string, string)	Belirtilen ilk yetkilendirme belirteci ve bölgesi ile konuşma fabrikasının bir örneğini oluşturur. 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. Not: Intent tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızdan türetilmiş bir belirteç kullanın. 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ılara uygulanmaz. 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, string)	Belirtilen uç nokta ve abonelik anahtarıyla konuşma 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: Amaç tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızı kullanın. Not: Uç nokta URL'sinde belirtilen sorgu parametreleri, 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 speechConfig.speechRecognitionLanguage = "en-US" tarafından ayarlanırsa, uri'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen parametreler 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 oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini yetkilendirme belirtecini kullanacak şekilde 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ç yolu olmayan 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'da eklendi.
fromSubscription(string, string)	SubscriptionKey ve hizmet bölgesi geçirilerek döndürülen SpeechConfig'in statik örneği. Not: Amaç tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızı kullanın.
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.
setProperty(string | PropertyId, string)	Rastgele bir özellik ayarlar.
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ı 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.

string authorizationToken

Özellik Değeri

string

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

Yapılandırılan dili döndürür.

string speechRecognitionLanguage

Özellik Değeri

string

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ı.

Yöntem Ayrıntıları

close()

Yapılandırmayı kapatır.

function close()

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()

enableDictation()

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

function enableDictation()

fromAuthorizationToken(string, string)

Belirtilen ilk yetkilendirme belirteci ve bölgesi ile konuşma fabrikasının bir örneğini oluşturur. 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. Not: Intent tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızdan türetilmiş bir belirteç kullanın. 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ılara uygulanmaz. 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): SpeechConfig

Parametreler

authorizationToken

string

İlk yetkilendirme belirteci.

region

string

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

Döndürülenler

SpeechConfig

Konuşma fabrikası örneği.

fromEndpoint(URL, string)

Belirtilen uç nokta ve abonelik anahtarıyla konuşma 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: Amaç tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızı kullanın. Not: Uç nokta URL'sinde belirtilen sorgu parametreleri, 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 speechConfig.speechRecognitionLanguage = "en-US" tarafından ayarlanırsa, uri'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Yalnızca uç nokta URL'sinde belirtilmeyen parametreler 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 oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini yetkilendirme belirtecini kullanacak şekilde ayarlayın.

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

Parametreler

endpoint

URL

Bağlanacak hizmet uç noktası.

subscriptionKey

string

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

Döndürülenler

SpeechConfig

Konuşma fabrikası ö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ç yolu olmayan 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'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)

SubscriptionKey ve hizmet bölgesi geçirilerek döndürülen SpeechConfig'in statik örneği. Not: Amaç tanıyıcısını kullanmak istemeniz durumunda lütfen LanguageUnderstanding abonelik anahtarınızı kullanın.

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

Parametreler

subscriptionKey

string

Abonelik anahtarı.

region

string

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

Döndürülenler

SpeechConfig

Konuşma fabrikası

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.

requestWordLevelTimestamps()

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

function 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

setProperty(string | PropertyId, string)

Rastgele bir özellik ayarlar.

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

Parametreler

name

string | PropertyId

Ayarlanacak özelliğin adı.

value

string

Özelliğin yeni değeri.

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

Proxy sunucusunun ana bilgisayar adı.

proxyPort

number

Ara sunucunun bağlantı noktası numarası.

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

Proxy sunucusunun kullanıcı adı.

proxyPassword

string

Proxy sunucusunun parolası.

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