class SpeechConfig

Konuşma tanıma veya konuşma sentezi için yapılandırmaları tanımlayan sınıf.

Üyeler

EmbeddedSpeechConfig

Sözdizimi: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sözdizimi: public friend HybridSpeechConfig;

SPXSPEECHCONFIGHANDLE işleci

Sözdizimi: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Temel tanıtıcı değerini almak için kullanılan iç işleç.

İade

Bir tutamaç.

SetSpeechRecognitionLanguage

Sözdizimi: 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özdizimi: public inline std::string GetSpeechRecognitionLanguage ( ) const;

Konuşma tanımaya giriş dilini alır. Dil BCP-47 biçiminde belirtilir.

İade

Konuşma tanıma dili.

SetSpeechSynthesisLanguage

Sözdizimi: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

Konuşma sentezleyicisinin dilini ayarlar. Sürüm 1.4.0'a eklendi.

Parametreler

  • lang Dilin adını belirtir (örneğin, en-US)

GetSpeechSynthesisLanguage

Sözdizimi: public inline std::string GetSpeechSynthesisLanguage ( ) const;

Konuşma sentezleyicisinin dilini alır. Sürüm 1.4.0'a eklendi.

İade

Konuşma sentezi dili.

SetSpeechSynthesisVoiceName

Sözdizimi: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

Konuşma sentezleyicisinin sesini ayarlayın. Sürüm 1.4.0'a eklendi.

Parametreler

  • voiceName Sesin adını belirtir

GetSpeechSynthesisVoiceName

Sözdizimi: public inline std::string GetSpeechSynthesisVoiceName ( ) const;

Konuşma sentezleyicisinin sesini alır. Sürüm 1.4.0'a eklendi.

İade

Konuşma sentezi ses adı.

SetSpeechSynthesisOutputFormat

Sözdizimi: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Konuşma sentezi çıkış biçimini ayarlar (örn. Riff16Khz16BitMonoPcm). Sürüm 1.4.0'a eklendi.

Parametreler

  • formatId Çıktı biçimi kimliğini belirtir

GetSpeechSynthesisOutputFormat

Sözdizimi: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

Konuşma sentezi çıkış biçimini alır. Sürüm 1.4.0'a eklendi.

İade

Konuşma sentezi çıkış biçimi.

SetEndpointId

Sözdizimi: public inline void SetEndpointId ( const std::string & endpointId );

Özel Konuşma veya Özel Ses uç nokta kimliğini ayarlar.

Parametreler

  • Uç Nokta Kimliğini endpointId.

GetEndpointId

Sözdizimi: public inline std::string GetEndpointId ( ) const;

Özel Konuşma veya Özel Ses uç nokta kimliğini alır.

İade

Uç nokta kimliği.

SetAuthorizationToken

Sözdizimi: 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 geçerli bir 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ş 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

  • yetkilendirme belirtecini token.

GetAuthorizationToken

Sözdizimi: public inline std::string GetAuthorizationToken ( ) const;

Hizmete bağlanmak için yetkilendirme belirtecini alır.

İade

Yetkilendirme belirteci.

GetSubscriptionKey

Sözdizimi: public inline std::string GetSubscriptionKey ( ) const;

Konuşma Tanıyıcı, Çeviri Tanıyıcı veya Konuşma Sentezleyicisi oluşturmak için kullanılan abonelik anahtarını alır.

İade

Abonelik anahtarı.

GetRegion

Sözdizimi: public inline std::string GetRegion ( ) const;

Konuşma Tanıyıcı, Çeviri Tanıyıcı veya konuşma Sentezleyicisi oluşturmak için kullanılan bölge anahtarını alır.

İade

Bölge.

GetOutputFormat

Sözdizimi: 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.

İade

Konuşma tanıma çıkış biçimi.

SetOutputFormat

Sözdizimi: 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

  • Konuşma tanıma çıkış biçimini format

SetProfanity

Sözdizimi: public inline void SetProfanity ( ProfanityOption profanity );

Küfür seçeneğini ayarlar. Sürüm 1.5.0'a eklendi.

Parametreler

  • Küfür seçeneği değerini profanity.

EnableAudioLogging

Sözdizimi: public inline void EnableAudioLogging ( );

Hizmette ses günlüğünü etkinleştirir. Sürüm 1.5.0'a eklendi.

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.

RequestWordLevelTimestamps

Sözdizimi: public inline void RequestWordLevelTimestamps ( );

Yanıt sonucuna sözcük düzeyi zaman damgaları ekler. Sürüm 1.5.0'a eklendi.

EnableDictation

Sözdizimi: public inline void EnableDictation ( );

Dikte modunu etkinleştirir. Yalnızca konuşma sürekli tanımada desteklenir. Sürüm 1.5.0'a eklendi.

SetProxy

Sözdizimi: 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özdizimi: public inline void SetProperty ( const std::string & name , const std::string & value );

Ada göre bir özellik değeri ayarlar.

Parametreler

  • name Özellik adı.

  • özellik değerini value.

GetProperty

Sözdizimi: public inline std::string GetProperty ( const std::string & name ) const;

Ada göre bir özellik değeri alır.

Parametreler

  • parametre adını name.

İade

Özellik değeri.

GetProperty

Sözdizimi: public inline std::string GetProperty ( PropertyId id ) const;

Kimliğine göre bir özellik değeri alır.

Parametreler

  • parametre kimliğini id.

İade

Özellik değeri.

SetProperty

Sözdizimi: 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.

  • özellik değerini value.

SetServiceProperty

Sözdizimi: public inline void SetServiceProperty ( const std::string & name , const std::string & value , ServicePropertyChannel channel );

Belirtilen kanalı kullanarak hizmete geçirilecek bir özellik değeri ayarlar. Sürüm 1.5.0'a eklendi.

Parametreler

  • name Özellik adı.

  • özellik değerini value.

  • channel Belirtilen özelliği hizmete geçirmek için kullanılan kanal.

~SpeechConfig

Sözdizimi: public inline virtual ~SpeechConfig ( );

Nesneyi yok eder.

FromSubscription

Sözdizimi: 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

  • Abonelik anahtarını subscription.

  • region Bölge adı (bkz. bölge sayfası).

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.

FromAuthorizationToken

Sözdizimi: 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 geçerli bir 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ş 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

  • yetkilendirme belirtecini authToken.

  • region Bölge adı (bkz. bölge sayfası).

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.

FromEndpoint

Sözdizimi: 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 ayarlansa bile değiştirilmez. Örneğin, tanıma dili URI'de "language=de-DE" sorgu parametresi olarak tanımlanırsa ve ayrıca 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ı.

  • Abonelik anahtarını subscription.

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.

FromEndpoint

Sözdizimi: 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 ayarlansa 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 ayrıca 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

  • bağlanacak hizmet uç noktası URI'sini endpoint.

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.

FromHost

Sözdizimi: 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 ayarlanmalıdır. 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'a eklendi.

Parametreler

  • host Bağlanacak hizmet konağı. Biçim , "protocol://host:port" şeklindedir; burada ":p ort" isteğe bağlıdır.

  • Abonelik anahtarını subscription.

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.

FromHost

Sözdizimi: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host );

Belirtilen ana bilgisayarla SpeechConfig ö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: Konak kimlik doğrulaması için bir 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'a eklendi.

Parametreler

  • Bağlanacak hizmet ana bilgisayar URI'sini host. Biçim , "protocol://host:port" şeklindedir; burada ":p ort" isteğe bağlıdır.

İade

Yeni konuşma yapılandırma örneğinin paylaşılan işaretçisi.