class SpeechConfig

  • Makale

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

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

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.