třída SpeechConfig

  • Článek

Třída, která definuje konfigurace pro rozpoznávání řeči/ záměru nebo syntézu řeči.

Členové

EmbeddedSpeechConfig

Syntaxe: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Syntaxe: public friend HybridSpeechConfig;

operátor SPXSPEECHCONFIGHANDLE

Syntaxe: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Interní operátor použitý k získání podkladové hodnoty popisovače.

Návraty

Úchyt.

SetSpeechRecognitionLanguage

Syntaxe: public inline void SetSpeechRecognitionLanguage ( const std::string & lang );

Nastavte jazyk zadávání na rozpoznávání řeči.

Parametry

  • lang Určuje název mluveného jazyka, který se má rozpoznat ve formátu BCP-47.

GetSpeechRecognitionLanguage

Syntaxe: public inline std::string GetSpeechRecognitionLanguage ( ) const;

Získá jazyk zadávání do rozpoznávání řeči. Jazyk je určen ve formátu BCP-47.

Návraty

Jazyk rozpoznávání řeči.

SetSpeechSynthesisLanguage

Syntaxe: public inline void SetSpeechSynthesisLanguage ( const std::string & lang );

Nastaví jazyk syntezátoru řeči. Přidáno ve verzi 1.4.0.

Parametry

  • lang Určuje název jazyka (např. en-US).

GetSpeechSynthesisLanguage

Syntaxe: public inline std::string GetSpeechSynthesisLanguage ( ) const;

Získá jazyk syntezátoru řeči. Přidáno ve verzi 1.4.0.

Návraty

Jazyk syntézy řeči.

SetSpeechSynthesisVoiceName

Syntaxe: public inline void SetSpeechSynthesisVoiceName ( const std::string & voiceName );

Nastavte hlas syntezátoru řeči. Přidáno ve verzi 1.4.0.

Parametry

  • voiceName Určuje název hlasu.

GetSpeechSynthesisVoiceName

Syntaxe: public inline std::string GetSpeechSynthesisVoiceName ( ) const;

Získá hlas syntezátoru řeči. Přidáno ve verzi 1.4.0.

Návraty

Název hlasu syntézy řeči.

SetSpeechSynthesisOutputFormat

Syntaxe: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Nastaví výstupní formát syntézy řeči (např. Riff16Khz16BitMonoPcm). Přidáno ve verzi 1.4.0.

Parametry

  • formatId Určuje ID výstupního formátu.

GetSpeechSynthesisOutputFormat

Syntaxe: public inline std::string GetSpeechSynthesisOutputFormat ( ) const;

Získá výstupní formát syntézy řeči. Přidáno ve verzi 1.4.0.

Návraty

Výstupní formát syntézy řeči

SetEndpointId

Syntaxe: public inline void SetEndpointId ( const std::string & endpointId );

Nastaví ID koncového bodu služby Custom Speech nebo Custom Voice.

Parametry

  • endpointId ID koncového bodu.

GetEndpointId

Syntaxe: public inline std::string GetEndpointId ( ) const;

Získá ID koncového bodu Custom Speech nebo Custom Voice.

Návraty

ID koncového bodu.

SetAuthorizationToken

Syntaxe: public inline void SetAuthorizationToken ( const std::string & token );

Nastaví autorizační token pro připojení ke službě. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat zavoláním tohoto setteru s novým platným tokenem. Vzhledem k tomu, že se hodnoty konfigurace kopírují při vytváření nového rozpoznávání, nebude nová hodnota tokenu platit pro rozpoznávání, které už byly vytvořeny. Pro rozpoznávání, které byly vytvořeny dříve, musíte nastavit autorizační token odpovídajícího rozpoznávatele, aby se token aktualizoval. V opačném případě dojde při rozpoznávání k chybám.

Parametry

  • token Autorizační token.

GetAuthorizationToken

Syntaxe: public inline std::string GetAuthorizationToken ( ) const;

Získá autorizační token pro připojení ke službě.

Návraty

Autorizační token.

GetSubscriptionKey

Syntaxe: public inline std::string GetSubscriptionKey ( ) const;

Získá klíč předplatného, který se používá k vytvoření rozpoznávání řeči nebo rozpoznávání záměru nebo rozpoznávání překladu nebo syntezátoru řeči.

Návraty

Klíč předplatného.

Získat oblast

Syntaxe: public inline std::string GetRegion ( ) const;

Získá klíč oblasti, který se používá k vytvoření rozpoznávání řeči nebo rozpoznávání záměru nebo rozpoznávání překladu nebo syntezátoru řeči.

Návraty

Oblasti.

GetOutputFormat

Syntaxe: public inline OutputFormat GetOutputFormat ( ) const;

Získá výstupní formát rozpoznávání řeči (jednoduchý nebo podrobný). Poznámka: Tento výstupní formát je určený pro výsledek rozpoznávání řeči. K získání syntetizovaného výstupního formátu zvuku použijte SpeechConfig::GetSpeechSynthesisOutputFormat .

Návraty

Výstupní formát rozpoznávání řeči.

SetOutputFormat

Syntaxe: public inline void SetOutputFormat ( OutputFormat format );

Nastaví výstupní formát rozpoznávání řeči (jednoduchý nebo podrobný). Poznámka: Tento výstupní formát je určený pro výsledek rozpoznávání řeči. K nastavení formátu syntetizovaného zvukového výstupu použijte SpeechConfig::SetSpeechSynthesisOutputFormat .

Parametry

  • format Formát výstupu rozpoznávání řeči

Nastavitprofanity

Syntaxe: public inline void SetProfanity ( ProfanityOption profanity );

Nastaví možnost vulgárních výrazů. Přidáno ve verzi 1.5.0.

Parametry

  • profanity Hodnota možnosti vulgárních výrazů.

EnableAudioLogging

Syntaxe: public inline void EnableAudioLogging ( );

Povolí protokolování zvuku ve službě. Přidáno ve verzi 1.5.0.

Protokoly zvuku a obsahu se ukládají buď do úložiště vlastněného Microsoftem, nebo do vašeho vlastního účtu úložiště propojeného s vaším předplatným služeb Cognitive Services (přineste si vlastní úložiště (BYOS) s povoleným prostředkem Speech.

RequestWordLevelTimestamps

Syntaxe: public inline void RequestWordLevelTimestamps ( );

Zahrne časová razítka na úrovni slov do výsledku odpovědi. Přidáno ve verzi 1.5.0.

Povolit diktování

Syntaxe: public inline void EnableDictation ( );

Povolí režim diktování. Podporováno pouze v nepřetržitém rozpoznávání řeči. Přidáno ve verzi 1.5.0.

Nastavitproxy

Syntaxe: public inline void SetProxy ( const std::string & proxyHostName , uint32_t proxyPort , const std::string & proxyUserName , const std::string & proxyPassword );

Nastaví konfiguraci proxy serveru přidanou ve verzi 1.1.0.

Poznámka: Funkce proxy serveru nejsou v systému macOS k dispozici. Tato funkce nebude mít na tuto platformu žádný vliv.

Parametry

  • proxyHostName Název hostitele proxy serveru bez schématu protokolu ([http://](http://))

  • proxyPort Číslo portu proxy serveru

  • proxyUserName Uživatelské jméno proxy serveru

  • proxyPassword Heslo proxy serveru

SetProperty

Syntaxe: public inline void SetProperty ( const std::string & name , const std::string & value );

Nastaví hodnotu vlastnosti podle názvu.

Parametry

  • name Název vlastnosti.

  • value Hodnota vlastnosti.

Getproperty

Syntaxe: public inline std::string GetProperty ( const std::string & name ) const;

Získá hodnotu vlastnosti podle názvu.

Parametry

  • name Název parametru.

Návraty

Hodnota vlastnosti.

Getproperty

Syntaxe: public inline std::string GetProperty ( PropertyId id ) const;

Získá hodnotu vlastnosti podle ID.

Parametry

  • id ID parametru.

Návraty

Hodnota vlastnosti.

SetProperty

Syntaxe: public inline void SetProperty ( PropertyId id , const std::string & value );

Nastaví hodnotu vlastnosti podle ID.

Parametry

  • id ID vlastnosti.

  • value Hodnota vlastnosti.

SetServiceProperty

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

Nastaví hodnotu vlastnosti, která bude předána službě pomocí zadaného kanálu. Přidáno ve verzi 1.5.0.

Parametry

  • name Název vlastnosti.

  • value Hodnota vlastnosti.

  • channel Kanál použitý k předání zadané vlastnosti službě.

~SpeechConfig

Syntaxe: public inline virtual ~SpeechConfig ( );

Destrukuje objekt.

FromSubscription

Syntaxe: public inline static std::shared_ptr< SpeechConfig > FromSubscription ( const std::string & subscription , const std::string & region );

Vytvoří instanci konfigurace řeči se zadaným klíčem a oblastí předplatného.

Parametry

  • subscription Klíč předplatného.

  • region Název oblasti (viz stránka oblasti).

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.

FromAuthorizationToken

Syntaxe: public inline static std::shared_ptr< SpeechConfig > FromAuthorizationToken ( const std::string & authToken , const std::string & region );

Vytvoří instanci konfigurace řeči se zadaným autorizačním tokenem a oblastí. Poznámka: Volající musí zajistit platnost autorizačního tokenu. Před vypršením platnosti autorizačního tokenu ho volající musí aktualizovat zavoláním tohoto setteru s novým platným tokenem. Vzhledem k tomu, že se hodnoty konfigurace kopírují při vytváření nového rozpoznávání, nebude nová hodnota tokenu platit pro rozpoznávání, které už byly vytvořeny. Pro rozpoznávání, které byly vytvořeny dříve, musíte nastavit autorizační token odpovídajícího rozpoznávatele, aby se token aktualizoval. V opačném případě dojde při rozpoznávání k chybám.

Parametry

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.

Z koncového bodu

Syntaxe: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint , const std::string & subscription );

Vytvoří instanci konfigurace řeči se zadaným koncovým bodem a předplatným. Tato metoda je určená jenom pro uživatele, kteří používají nestandardní koncový bod služby. Poznámka: Parametry dotazu zadané v identifikátoru URI koncového bodu se nezmění, a to ani v případě, že je nastavují jiná rozhraní API. Pokud je například jazyk rozpoznávání definovaný v identifikátoru URI jako parametr dotazu "language=de-DE" a také nastaven setSpeechRecognitionLanguage("en-US"), má přednost nastavení jazyka v identifikátoru URI a efektivní jazyk je "de-DE". Jiná rozhraní API můžou nastavit jenom parametry, které nejsou zadané v identifikátoru URI koncového bodu. Poznámka: Pokud chcete s parametrem FromEndpoint použít autorizační token, použijte FromEndpoint(const SPXSTRING&) a pak zavolejte metodu SetAuthorizationToken() ve vytvořené instanci SpeechConfig.

Parametry

  • endpoint Koncový bod služby, ke kterému se chcete připojit.

  • subscription Klíč předplatného.

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.

Z koncového bodu

Syntaxe: public inline static std::shared_ptr< SpeechConfig > FromEndpoint ( const std::string & endpoint );

Vytvoří instanci SpeechConfig se zadaným koncovým bodem. Tato metoda je určená jenom uživatelům, kteří používají nestandardní koncový bod služby. Poznámka: Parametry dotazu zadané v identifikátoru URI koncového bodu se nezmění, a to ani v případě, že je nastavují jiná rozhraní API. To, jestli se konkrétní parametr dotazu podporuje, závisí na koncovém bodu a scénáři. Pokud je například jazyk rozpoznávání definovaný v identifikátoru URI jako parametr dotazu "language=de-DE" a také nastaven setSpeechRecognitionLanguage("en-US"), má přednost nastavení jazyka v identifikátoru URI a efektivní jazyk je "de-DE". Příklad platí pouze v případě, že kombinace koncového bodu a scénáře podporuje jazyk jako parametr dotazu. Jiná rozhraní API můžou nastavit jenom parametry, které nejsou zadané v identifikátoru URI koncového bodu. Poznámka: Pokud koncový bod vyžaduje klíč předplatného pro ověřování, použijte FromEndpoint (const SPXSTRING&, const SPXSTRING&) a předejte klíč předplatného jako parametr. Chcete-li použít autorizační token s FromEndpoint, použijte tuto metodu k vytvoření instance SpeechConfig a poté volání SetAuthorizationToken() na vytvořené instanci SpeechConfig. Poznámka: Přidáno ve verzi 1.5.0.

Parametry

  • endpoint Identifikátor URI koncového bodu služby, ke kterému se chcete připojit.

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.

Od hostitele

Syntaxe: public inline static std::shared_ptr< SpeechConfig > FromHost ( const std::string & host , const std::string & subscription );

Vytvoří instanci konfigurace řeči se zadaným hostitelem a předplatným. Tato metoda je určena pouze pro uživatele, kteří používají jiné než výchozí hostitele služby. Předpokládá se standardní cesta k prostředku. Pro služby s nestandardní cestou k prostředku nebo žádnou cestou použijte místo toho FromEndpoint. Poznámka: Parametry dotazu nejsou v identifikátoru URI hostitele povoleny a musí být nastaveny jinými rozhraními API. Poznámka: Pokud chcete s Parametrem FromHost použít autorizační token, použijte FromHost(const SPXSTRING&) a pak na vytvořené instanci SpeechConfig volejte SetAuthorizationToken(). Poznámka: Přidáno ve verzi 1.8.0.

Parametry

  • host Hostitel služby, ke kterému se má připojit. Formát je "protocol://host:port", kde ":p ort" je volitelný.

  • subscription Klíč předplatného.

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.

Od hostitele

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

Vytvoří instanci SpeechConfig se zadaným hostitelem. Tato metoda je určena pouze pro uživatele, kteří používají jiné než výchozí hostitele služby. Předpokládá se standardní cesta k prostředku. Pro služby s nestandardní cestou k prostředku nebo žádnou cestou použijte místo toho FromEndpoint. Poznámka: Parametry dotazu nejsou v identifikátoru URI hostitele povoleny a musí být nastaveny jinými rozhraními API. Poznámka: Pokud hostitel vyžaduje klíč předplatného pro ověřování, použijte FromHost(const SPXSTRING&, const SPXSTRING&) a předejte klíč předplatného jako parametr. Pokud chcete použít autorizační token s FromHost, použijte tuto metodu k vytvoření instance SpeechConfig a pak zavolejte SetAuthorizationToken() na vytvořené instanci SpeechConfig. Poznámka: Přidáno ve verzi 1.8.0.

Parametry

  • host Identifikátor URI hostitele služby, ke kterému se chcete připojit. Formát je "protocol://host:port", kde ":p ort" je volitelný.

Návraty

Sdílený ukazatel na novou instanci konfigurace řeči.