class SpeechConfig
Konuşma/amaç tanıma veya konuşma sentezi yapılandırmalarını tanımlayan sınıf.
Üyeler
EmbeddedSpeechConfig
Söz dizimi: public friend EmbeddedSpeechConfig;
HybridSpeechConfig
Söz dizimi: public friend HybridSpeechConfig;
işleç SPXSPEECHCONFIGHANDLE
Söz dizimi: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;
Temel alınan tanıtıcı değerini almak için kullanılan iç işleç.
Döndürülenler
Bir tutamaç.
SetSpeechRecognitionLanguage
Söz dizimi: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );
Giriş dilini konuşma tanıyıcı olarak ayarlayın.
Parametreler
lang
BCP-47 biçiminde tanınacak konuşulan dilin adını belirtir.
GetSpeechRecognitionLanguage
Söz dizimi: public inline std::string GetSpeechRecognitionLanguage ( ) const;
Konuşma tanımaya giriş dilini alır. Dil BCP-47 biçiminde belirtilir.
Döndürülenler
Konuşma tanıma dili.
SetSpeechSynthesisLanguage
Söz dizimi: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );
Konuşma sentezleyicisinin dilini ayarlar. Sürüm 1.4.0'da eklendi.
Parametreler
lang
Dilin adını belirtir (ör. en-US)
GetSpeechSynthesisLanguage
Söz dizimi: public inline std::string GetSpeechSynthesisLanguage ( ) const;
Konuşma sentezleyicisinin dilini alır. Sürüm 1.4.0'da eklendi.
Döndürülenler
Konuşma sentezi dili.
SetSpeechSynthesisVoiceName
Söz dizimi: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );
Konuşma sentezleyicisinin sesini ayarlayın. Sürüm 1.4.0'da eklendi.
Parametreler
voiceName
Sesin adını belirtir
GetSpeechSynthesisVoiceName
Söz dizimi: public inline std::string GetSpeechSynthesisVoiceName ( ) const;
Konuşma sentezleyicisinin sesini alır. Sürüm 1.4.0'da eklendi.
Döndürülenler
Konuşma sentezi ses adı.
SetSpeechSynthesisOutputFormat
Söz dizimi: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );
Konuşma sentezi çıkış biçimini ayarlar (örn. Riff16Khz16BitMonoPcm). Sürüm 1.4.0'da eklendi.
Parametreler
formatId
Çıkış biçimi kimliğini belirtir
GetSpeechSynthesisOutputFormat
Söz dizimi: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;
Konuşma sentezi çıkış biçimini alır. Sürüm 1.4.0'da eklendi.
Döndürülenler
Konuşma sentezi çıkış biçimi.
SetEndpointId
Söz dizimi: public inline void SetEndpointId ( const std::string & endpointId );
Özel Konuşma veya Özel Ses uç nokta kimliğini ayarlar.
Parametreler
endpointId
Uç nokta kimliği.
GetEndpointId
Söz dizimi: public inline std::string GetEndpointId ( ) const;
Özel Konuşma veya Özel Ses uç nokta kimliğini alır.
Döndürülenler
Uç nokta kimliği.
SetAuthorizationToken
Söz dizimi: public inline void SetAuthorizationToken ( const std::string & token );
Hizmete bağlanmak için yetkilendirme belirtecini 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. 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.
Parametreler
token
Yetkilendirme belirteci.
GetAuthorizationToken
Söz dizimi: public inline std::string GetAuthorizationToken ( ) const;
Hizmete bağlanmak için yetkilendirme belirtecini alır.
Döndürülenler
Yetkilendirme belirteci.
GetSubscriptionKey
Söz dizimi: public inline std::string GetSubscriptionKey ( ) const;
Konuşma Tanıma veya Amaç Tanıma ya da Çeviri Tanıma ya da Konuşma Sentezleyicisi oluşturmak için kullanılan abonelik anahtarını alır.
Döndürülenler
Abonelik anahtarı.
GetRegion
Söz dizimi: public inline std::string GetRegion ( ) const;
Konuşma Tanıma veya Amaç Tanıma ya da Çeviri Tanıma ya da konuşma Sentezleyici oluşturmak için kullanılan bölge anahtarını alır.
Döndürülenler
Bölge.
GetOutputFormat
Söz dizimi: public inline OutputFormat GetOutputFormat ( ) const;
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::GetSpeechSynthesisOutputFormat kullanın.
Döndürülenler
Konuşma tanıma çıkış biçimi.
SetOutputFormat
Söz dizimi: public inline void SetOutputFormat ( OutputFormat format );
Konuşma tanıma çıkış biçimini ayarlar (basit veya ayrıntılı). Not: Bu çıkış biçimi konuşma tanıma sonucuna yöneliktir, sentezlenmiş ses çıkış biçimini ayarlamak için SpeechConfig::SetSpeechSynthesisOutputFormat kullanın.
Parametreler
format
Konuşma tanıma çıkış biçimi
SetProfanity
Söz dizimi: public inline void SetProfanity ( ProfanityOption profanity );
Küfür seçeneğini ayarlar. Sürüm 1.5.0'da eklendi.
Parametreler
profanity
Küfür seçeneği değeri.
EnableAudioLogging
Söz dizimi: public inline void EnableAudioLogging ( );
Hizmette ses günlüğünü etkinleştirir. Sürüm 1.5.0'da eklendi.
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.
RequestWordLevelTimestamps
Söz dizimi: public inline void RequestWordLevelTimestamps ( );
Yanıt sonucuna sözcük düzeyi zaman damgaları ekler. Sürüm 1.5.0'da eklendi.
EnableDictation
Söz dizimi: public inline void EnableDictation ( );
Dikte modunu etkinleştirir. Yalnızca konuşma sürekli tanımada desteklenir. Sürüm 1.5.0'da eklendi.
SetProxy
Söz dizimi: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );
Proxy yapılandırmasını ayarlar Sürüm 1.1.0'da eklendi.
Not: Ara sunucu işlevselliği macOS'ta kullanılamaz. Bu işlevin bu platform üzerinde hiçbir etkisi olmayacaktır.
Parametreler
proxyHostName
Protokol şeması olmadan ara sunucunun ana bilgisayar adı ([http://](http://)
)proxyPort
Ara sunucunun bağlantı noktası numarasıproxyUserName
Ara sunucunun kullanıcı adıproxyPassword
Ara sunucunun parolası
SetProperty
Söz dizimi: public inline void SetProperty ( const std::string & name , const std::string & value );
Ada göre bir özellik değeri ayarlar.
Parametreler
name
Özellik adı.value
Özellik değeri.
GetProperty
Söz dizimi: public inline std::string GetProperty ( const std::string & name ) const;
Ada göre bir özellik değeri alır.
Parametreler
name
Parametre adı.
Döndürülenler
Özellik değeri.
GetProperty
Söz dizimi: public inline std::string GetProperty ( PropertyId id ) const;
Kimliğine göre bir özellik değeri alır.
Parametreler
id
Parametre kimliği.
Döndürülenler
Özellik değeri.
SetProperty
Söz dizimi: public inline void SetProperty ( PropertyId id , const std::string & value );
Kimlik değerine göre bir özellik değeri ayarlar.
Parametreler
id
Özellik kimliği.value
Özellik değeri.
SetServiceProperty
Söz dizimi: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );
Belirtilen kanal kullanılarak hizmete geçirilecek bir özellik değeri ayarlar. Sürüm 1.5.0'da eklendi.
Parametreler
name
Özellik adı.value
Özellik değeri.channel
Belirtilen özelliği hizmete geçirmek için kullanılan kanal.
~SpeechConfig
Söz dizimi: public inline virtual ~SpeechConfig ( );
Nesneyi yok eder.
Abonelikten
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );
Belirtilen abonelik anahtarı ve bölgesi ile konuşma yapılandırmasının bir örneğini oluşturur.
Parametreler
subscription
Abonelik anahtarı.region
Bölge adı ( bölge sayfasına bakın).
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.
FromAuthorizationToken
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );
Belirtilen yetkilendirme belirteci ve bölgesi ile konuşma yapılandırması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. 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.
Parametreler
authToken
Yetkilendirme belirteci.region
Bölge adı ( bölge sayfasına bakın).
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.
FromEndpoint
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );
Belirtilen uç nokta ve abonelikle konuşma yapılandırmasının bir örneğini oluşturur. Bu yöntem yalnızca standart olmayan bir hizmet uç noktası kullanan kullanıcılara yöneliktir. Not: Uç nokta URI'sinde belirtilen sorgu parametreleri, diğer API'ler tarafından ayarlansalar bile değiştirilmez. Örneğin, tanıma dili URI'de "language=de-DE" sorgu parametresi olarak tanımlanırsa ve setSpeechRecognitionLanguage("en-US") tarafından ayarlanırsa, URI'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Yalnızca uç nokta URI'sinde belirtilmeyen parametreler diğer API'ler tarafından ayarlanabilir. Not: FromEndpoint ile yetkilendirme belirteci kullanmak için FromEndpoint(const SPXSTRING&) kullanın ve ardından oluşturulan SpeechConfig örneğinde SetAuthorizationToken() öğesini çağırın.
Parametreler
endpoint
Bağlanacak hizmet uç noktası.subscription
Abonelik anahtarı.
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.
FromEndpoint
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );
Belirtilen uç noktaya sahip bir SpeechConfig örneği oluşturur. Bu yöntem yalnızca standart olmayan bir hizmet uç noktası kullanan kullanıcılara yöneliktir. Not: Uç nokta URI'sinde belirtilen sorgu parametreleri, diğer API'ler tarafından ayarlansalar bile değiştirilmez. Belirli bir sorgu parametresinin desteklenip desteklenmediği uç noktaya ve senaryoya bağlıdır. Örneğin, tanıma dili URI'de "language=de-DE" sorgu parametresi olarak tanımlanırsa ve setSpeechRecognitionLanguage("en-US") tarafından ayarlanırsa, URI'deki dil ayarı önceliklidir ve etkili dil "de-DE" olur. Örnek yalnızca uç nokta ve senaryo bileşimi sorgu parametresi olarak dili desteklediğinde geçerlidir. Yalnızca uç nokta URI'sinde belirtilmeyen parametreler diğer API'ler tarafından ayarlanabilir. Not: Uç nokta kimlik doğrulaması için abonelik anahtarı gerektiriyorsa, abonelik anahtarını parametre olarak geçirmek için FromEndpoint(const SPXSTRING&, const SPXSTRING&) kullanın. FromEndpoint ile yetkilendirme belirteci kullanmak için bu yöntemi kullanarak bir SpeechConfig örneği oluşturun ve ardından oluşturulan SpeechConfig örneğinde SetAuthorizationToken() öğesini çağırın. Not: Sürüm 1.5.0'a eklendi.
Parametreler
endpoint
Bağlanacak hizmet uç noktası URI'si.
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.
FromHost
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );
Belirtilen konak ve abonelikle 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(const SPXSTRING&) kullanın ve ardından oluşturulan SpeechConfig örneğinde SetAuthorizationToken() öğesini çağırın. Not: Sürüm 1.8.0'da eklendi.
Parametreler
host
Bağlanacak hizmet konağı. Biçim "protocol://host:port" şeklindedir; burada ":p ort" isteğe bağlıdır.subscription
Abonelik anahtarı.
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.
FromHost
Söz dizimi: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );
Belirtilen konağa sahip bir SpeechConfig örneği 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: Konak kimlik doğrulaması için abonelik anahtarı gerektiriyorsa, abonelik anahtarını parametre olarak geçirmek için FromHost(const SPXSTRING&, const SPXSTRING&) kullanın. FromHost ile yetkilendirme belirteci kullanmak için bu yöntemi kullanarak bir SpeechConfig örneği oluşturun ve ardından oluşturulan SpeechConfig örneğinde SetAuthorizationToken() öğesini çağırın. Not: Sürüm 1.8.0'da eklendi.
Parametreler
host
Bağlanacak hizmet ana bilgisayar URI'si. Biçim "protocol://host:port" şeklindedir; burada ":p ort" isteğe bağlıdır.
Döndürülenler
Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.