SpeechConfig class
Konuşma yapılandırması.
Özellikler
authorization |
Yetkilendirme belirtecini alır. |
endpoint |
Konuşma tanıma için kullanılan özelleştirilmiş bir konuşma modelinin uç nokta kimliğini alır. |
output |
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 | |
speech |
Yapılandırılan dili döndürür. |
speech |
Konuşma sentezleyicisinin dilini alır. Sürüm 1.11.0'da eklendi. |
speech |
Konuşma sentezi çıkış biçimini alır. Sürüm 1.11.0'da eklendi. |
speech |
Konuşma sentezleyicisinin sesini alır. Sürüm 1.11.0'da eklendi. |
subscription |
Yöntemler
close() | Yapılandırmayı kapatır. |
enable |
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. |
enable |
Dikteyi etkinleştirin. Yalnızca konuşma sürekli tanımada desteklenir. Sürüm 1.7.0'da eklendi. |
from |
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. |
from |
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. |
from |
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. |
from |
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. |
get |
Rastgele bir özelliğin geçerli değerini döndürür. |
request |
Sözcük düzeyi zaman damgaları içerir. Sürüm 1.7.0'da eklendi. |
set |
Küfür seçeneğini ayarlar. Sürüm 1.7.0'da eklendi. |
set |
Rastgele bir özellik ayarlar. |
set |
Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'da eklendi. |
set |
Ara sunucu yapılandırmasını ayarlar. Yalnızca Node.js ortamlarda geçerlidir. Sürüm 1.4.0'da eklendi. |
set |
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
Çı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
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
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
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
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
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