Sdílet prostřednictvím

třída SpeechConfig

  • Článek

Třída, která definuje konfigurace pro rozpoznávání řeči nebo 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 zadán 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 syntetizá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 syntetizá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 syntetizá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 syntetizá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 služby 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. Než vyprší platnost autorizačního tokenu, volající ho musí aktualizovat zavoláním tohoto setteru s novým platným tokenem. Při vytváření nového rozpoznávatele se hodnoty konfigurace zkopírují, ale nová hodnota tokenu se nepoužije 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 pro aktualizaci tokenu. V opačném případě se při rozpoznávání budou narazit na chyby.

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 překladu nebo syntetizátoru řeči.

Návraty

Klíč předplatného.

GetRegion

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 překladu rozpoznávání nebo syntetizátoru řeči.

Návraty

Oblast.

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, použijte SpeechConfig::GetSpeechSynthesisOutputFormat k získání syntetizovaného formátu výstupu zvuku.

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, použijte SpeechConfig::SetSpeechSynthesisOutputFormat k nastavení syntetizovaného formátu výstupu zvuku.

Parametry

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

SetProfanity

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ď v úložišti vlastněné Microsoftem, nebo ve vašem vlastním účtu úložiště propojeném s vaším předplatným služeb Cognitive Services (byOS) s povoleným prostředkem služby Speech (Bring Your Own Storage).

RequestWordLevelTimestamps

Syntaxe: public inline void RequestWordLevelTimestamps ( );

Obsahuje časové razítka na úrovni slova ve 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í. Podporuje se pouze v průběžném rozpoznávání řeči. Přidáno ve verzi 1.5.0.

SetProxy

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 není v systému macOS dostupná. 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á se předá 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 předplatného a oblastí.

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. Než vyprší platnost autorizačního tokenu, volající ho musí aktualizovat zavoláním tohoto setteru s novým platným tokenem. Při vytváření nového rozpoznávatele se hodnoty konfigurace zkopírují, ale nová hodnota tokenu se nepoužije 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 pro aktualizaci tokenu. V opačném případě se při rozpoznávání budou narazit na chyby.

Parametry

  • authToken Autorizační token.

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

Návraty

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

ZEndpointu

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á pouze 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í, i když jsou nastavené jinými rozhraními API. Pokud je například jazyk rozpoznávání definován v identifikátoru URI jako parametr dotazu "language=de-DE", a také nastavený setSpeechRecognitionLanguage("en-US"), nastavení jazyka v identifikátoru URI má přednost a efektivní jazyk je "de-DE". Jiné rozhraní API můžou nastavit pouze parametry, které nejsou zadané v identifikátoru URI koncového bodu. Poznámka: Chcete-li použít autorizační token s FromEndpoint, použijte FromEndpoint(const SPXSTRING&) a potom volání 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.

ZEndpointu

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á pouze 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í, i když jsou nastavené jinými rozhraními API. To, jestli se konkrétní parametr dotazu podporuje nebo ne, závisí na koncovém bodu a scénáři. Pokud je například jazyk rozpoznávání definován v identifikátoru URI jako parametr dotazu "language=de-DE", a také nastavený setSpeechRecognitionLanguage("en-US"), nastavení jazyka v identifikátoru URI má přednost a efektivní jazyk je "de-DE". Příklad platí jenom v případě, že kombinace koncového bodu a scénáře podporuje jazyk jako parametr dotazu. Jiné rozhraní API můžou nastavit pouze parametry, které nejsou zadané v identifikátoru URI koncového bodu. Poznámka: Pokud koncový bod k ověřování vyžaduje klíč předplatného, použijte fromEndpoint(const SPXSTRING&, const SPXSTRING&) k předání klíče předplatného jako parametru. Chcete-li použít autorizační token s FromEndpoint, použijte tuto metodu k vytvoření instance SpeechConfig a potom volání SetAuthorizationToken() ve vytvořené instanci SpeechConfig. Poznámka: Přidáno ve verzi 1.5.0.

Parametry

  • endpoint identifikátor URI koncového bodu služby pro připojení.

Návraty

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

FromHost

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čená pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta prostředku. Pro služby s nestandardní cestou prostředku nebo žádnou cestou vůbec použijte FromEndpoint. Poznámka: Parametry dotazu nejsou povoleny v identifikátoru URI hostitele a musí být nastaveny jinými rozhraními API. Poznámka: Chcete-li použít autorizační token s FromHost, použijte FromHost(const SPXSTRING&) a potom volání SetAuthorizationToken() u vytvořené instance SpeechConfig. Poznámka: Přidáno ve verzi 1.8.0.

Parametry

  • host Hostitel služby, ke kterému se chcete 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.

FromHost

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

Vytvoří instanci speechConfig se zadaným hostitelem. Tato metoda je určená pouze pro uživatele, kteří používají jiného než výchozího hostitele služby. Předpokládá se standardní cesta prostředku. Pro služby s nestandardní cestou prostředku nebo žádnou cestou vůbec použijte FromEndpoint. Poznámka: Parametry dotazu nejsou povoleny v identifikátoru URI hostitele a musí být nastaveny jinými rozhraními API. Poznámka: Pokud hostitel k ověřování vyžaduje klíč předplatného, použijte FromHost(const SPXSTRING&, const SPXSTRING&) k předání klíče předplatného jako parametru. Chcete-li použít autorizační token s FromHost, použijte tuto metodu k vytvoření instance SpeechConfig a potom volání SetAuthorizationToken() ve 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.