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

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 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.
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 geçerli bir belirteçle çağırarak yenilemesi gerekir. Not: Yeni bir tanıyıcı oluşturulurken yapılandırma değerleri kopyalandığından, yeni belirteç değeri önceden oluşturulmuş 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, KeyCredential | TokenCredential)	Özel bir uç nokta ve kimlik bilgisi ile bir SpeechConfig örneği 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 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 parametreleri, diğer API'ler tarafından ayarlansa bile değiştirilmez. Örneğin, dil uri'sinde "language=de-DE" sorgu parametresi olarak tanımlanırsa ve ayrıca 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 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)	SubscriptionKey ve hizmet bölgesi geçirilerek döndürülen SpeechConfig'in statik örneği.
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'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.

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

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.

undefined | TokenCredential tokenCredential

Özellik Değeri

undefined | TokenCredential

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

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 geçerli bir belirteçle çağırarak yenilemesi gerekir. Not: Yeni bir tanıyıcı oluşturulurken yapılandırma değerleri kopyalandığından, yeni belirteç değeri önceden oluşturulmuş 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, KeyCredential | TokenCredential)

Özel bir uç nokta ve kimlik bilgisi ile bir SpeechConfig örneği 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): SpeechConfig

Parametreler

endpoint

URL

Bağlanacak hizmet uç noktası.

credential

KeyCredential | TokenCredential

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

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: Uç nokta URL'sinde belirtilen sorgu parametreleri, diğer API'ler tarafından ayarlansa bile değiştirilmez. Örneğin, dil uri'sinde "language=de-DE" sorgu parametresi olarak tanımlanırsa ve ayrıca 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 yetkilendirme belirtecini kullanmak için oluşturulan SpeechConfig örneğinde authorizationToken="token" değerini 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ç 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): 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.

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

Ayarlanacağı özelliğin adı.

value

string

özelliğinin 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'a eklendi.

function setProxy(proxyHostName: string, proxyPort: number)

Parametreler

proxyHostName

string

Ara sunucunun 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'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ı.

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