classe SpeechConfig

  • Articolo

Classe che definisce le configurazioni per il riconoscimento vocale/finalità o la sintesi vocale.

Membri

EmbeddedSpeechConfig

Sintassi: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sintassi: public friend HybridSpeechConfig;

operatore SPXSPEECHCONFIGHANDLE

Sintassi: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Operatore interno usato per ottenere il valore di handle sottostante.

Restituisce

Handle.

SetSpeechRecognitionLanguage

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

Impostare la lingua di input sul riconoscimento vocale.

Parametri

  • lang Specifica il nome della lingua parlata da riconoscere in formato BCP-47.

GetSpeechRecognitionLanguage

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

Ottiene la lingua di input per il riconoscimento vocale. La lingua è specificata in formato BCP-47.

Restituisce

Lingua di riconoscimento vocale.

SetSpeechSynthesisLanguage

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

Imposta la lingua del sintetizzatore vocale. Aggiunta nella versione 1.4.0.

Parametri

  • lang Specifica il nome della lingua (ad esempio en-US)

GetSpeechSynthesisLanguage

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

Ottiene la lingua del sintetizzatore vocale. Aggiunta nella versione 1.4.0.

Restituisce

Linguaggio di sintesi vocale.

SetSpeechSynthesisVoiceName

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

Impostare la voce del sintetizzatore vocale. Aggiunta nella versione 1.4.0.

Parametri

  • voiceName Specifica il nome della voce

GetSpeechSynthesisVoiceName

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

Ottiene la voce del sintetizzatore vocale. Aggiunta nella versione 1.4.0.

Restituisce

Nome voce sintesi vocale.

SetSpeechSynthesisOutputFormat

Sintassi: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Imposta il formato di output della sintesi vocale, ad esempio Riff16Khz16BitMonoPcm. Aggiunta nella versione 1.4.0.

Parametri

  • formatId Specifica l'ID del formato di output

GetSpeechSynthesisOutputFormat

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

Ottiene il formato di output della sintesi vocale. Aggiunta nella versione 1.4.0.

Restituisce

Formato di output della sintesi vocale.

SetEndpointId

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

Imposta l'ID endpoint di Voce personalizzata o voce personalizzata.

Parametri

  • endpointId ID endpoint.

GetEndpointId

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

Ottiene l'ID endpoint di Voce personalizzata o voce personalizzata.

Restituisce

ID endpoint.

SetAuthorizationToken

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

Imposta il token di autorizzazione per connettersi al servizio. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido. Man mano che i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscimento, il nuovo valore del token non verrà applicato ai riconoscimento già creati. Per i riconoscimento creati prima, è necessario impostare il token di autorizzazione del riconoscimento corrispondente per aggiornare il token. In caso contrario, i riconoscimento riscontrano errori durante il riconoscimento.

Parametri

  • token Token di autorizzazione.

GetAuthorizationToken

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

Ottiene il token di autorizzazione per connettersi al servizio.

Restituisce

Token di autorizzazione.

GetSubscriptionKey

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

Ottiene la chiave di sottoscrizione usata per creare Riconoscimento vocale o Riconoscimento finalità o Riconoscimento vocale o Riconoscimento vocale o Riconoscimento vocale.

Restituisce

Chiave di sottoscrizione.

GetRegion

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

Ottiene la chiave dell'area usata per creare riconoscimento vocale o riconoscimento finalità o riconoscimento vocale o riconoscimento vocale.

Restituisce

Area geografica

GetOutputFormat

Sintassi: public inline OutputFormat GetOutputFormat ( ) const;

Ottiene il formato di output del riconoscimento vocale (semplice o dettagliato). Nota: questo formato di output è per il risultato del riconoscimento vocale, usare SpeechConfig::GetSpeechSynthesisOutputFormat per ottenere il formato di output audio sintetizzato.

Restituisce

Formato di output del riconoscimento vocale.

SetOutputFormat

Sintassi: public inline void SetOutputFormat ( OutputFormat format );

Imposta il formato di output del riconoscimento vocale (semplice o dettagliato). Nota: questo formato di output è per il risultato del riconoscimento vocale, usare SpeechConfig::SetSpeechSynthesisOutputFormat per impostare il formato di output audio sintetizzato.

Parametri

  • format Formato di output del riconoscimento vocale

SetProfanity

Sintassi: public inline void SetProfanity ( ProfanityOption profanity );

Imposta l'opzione volgarità. Aggiunta nella versione 1.5.0.

Parametri

  • profanity Valore dell'opzione Volgarity.

EnableAudioLogging

Sintassi: public inline void EnableAudioLogging ( );

Abilita la registrazione audio nel servizio. Aggiunta nella versione 1.5.0.

I log di audio e contenuto vengono archiviati nell'archiviazione di proprietà Microsoft o nell'account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (Bring Your Own Storage (BYOS) abilitata per la risorsa Voce.

RequestWordLevelTimestamps

Sintassi: public inline void RequestWordLevelTimestamps ( );

Include timestamp a livello di parola nel risultato della risposta. Aggiunta nella versione 1.5.0.

EnableDictation

Sintassi: public inline void EnableDictation ( );

Abilita la modalità di dettatura. Supportato solo nel riconoscimento vocale continuo. Aggiunta nella versione 1.5.0.

SetProxy

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

Imposta la configurazione proxy Aggiunta nella versione 1.1.0.

Nota: la funzionalità proxy non è disponibile in macOS. Questa funzione non avrà alcun effetto su questa piattaforma.

Parametri

  • proxyHostName Nome host del server proxy, senza lo schema di protocollo ([http://](http://))

  • proxyPort Numero di porta del server proxy

  • proxyUserName Nome utente del server proxy

  • proxyPassword Password del server proxy

SetProperty

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

Imposta un valore della proprietà in base al nome.

Parametri

  • name Nome della proprietà.

  • value Valore della proprietà.

Getproperty

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

Ottiene un valore della proprietà in base al nome.

Parametri

  • name Nome del parametro.

Restituisce

Valore della proprietà.

Getproperty

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

Ottiene un valore della proprietà in base all'ID.

Parametri

  • id ID parametro.

Restituisce

Valore della proprietà.

SetProperty

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

Imposta un valore della proprietà in base all'ID.

Parametri

  • id ID proprietà.

  • value Valore della proprietà.

SetServiceProperty

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

Imposta un valore di proprietà che verrà passato al servizio usando il canale specificato. Aggiunta nella versione 1.5.0.

Parametri

  • name Nome della proprietà.

  • value Valore della proprietà.

  • channel Canale usato per passare la proprietà specificata al servizio.

~SpeechConfig

Sintassi: public inline virtual ~SpeechConfig ( );

Elimina l'oggetto.

FromSubscription

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

Crea un'istanza della configurazione del riconoscimento vocale con la chiave e l'area di sottoscrizione specificati.

Parametri

  • subscription Chiave di sottoscrizione.

  • region Nome area (vedere la pagina area).

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.

FromAuthorizationToken

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

Crea un'istanza della configurazione del riconoscimento vocale con il token di autorizzazione e l'area specificati. Nota: il chiamante deve assicurarsi che il token di autorizzazione sia valido. Prima della scadenza del token di autorizzazione, il chiamante deve aggiornarlo chiamando questo setter con un nuovo token valido. Man mano che i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscimento, il nuovo valore del token non verrà applicato ai riconoscimento già creati. Per i riconoscimento creati prima, è necessario impostare il token di autorizzazione del riconoscimento corrispondente per aggiornare il token. In caso contrario, i riconoscimento riscontrano errori durante il riconoscimento.

Parametri

  • authToken Token di autorizzazione.

  • region Nome area (vedere la pagina area).

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.

FromEndpoint

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

Crea un'istanza della configurazione del riconoscimento vocale con endpoint e sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un endpoint di servizio non standard. Nota: i parametri di query specificati nell'URI dell'endpoint non vengono modificati, anche se sono impostati da qualsiasi altra API. Ad esempio, se il linguaggio di riconoscimento è definito nell'URI come parametro di query "language=de-DE" e impostato anche da SetSpeechRecognitionLanguage("en-US"), l'impostazione della lingua nell'URI ha la precedenza e la lingua effettiva è "de-DE". Solo i parametri non specificati nell'URI dell'endpoint possono essere impostati da altre API. Nota: per usare un token di autorizzazione con FromEndpoint, usare FromEndpoint(const SPXSTRING&) e quindi chiamare SetAuthorizationToken() nell'istanza di SpeechConfig creata.

Parametri

  • endpoint Endpoint del servizio a cui connettersi.

  • subscription Chiave di sottoscrizione.

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.

FromEndpoint

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

Crea un'istanza di SpeechConfig con l'endpoint specificato. Questo metodo è destinato solo agli utenti che usano un endpoint di servizio non standard. Nota: i parametri di query specificati nell'URI dell'endpoint non vengono modificati, anche se sono impostati da qualsiasi altra API. Se un parametro di query specifico è supportato o meno, dipende dall'endpoint e dallo scenario. Ad esempio, se il linguaggio di riconoscimento è definito nell'URI come parametro di query "language=de-DE" e impostato anche da SetSpeechRecognitionLanguage("en-US"), l'impostazione della lingua nell'URI ha la precedenza e la lingua effettiva è "de-DE". L'esempio si applica solo quando la combinazione di endpoint e scenario supporta il linguaggio come parametro di query. Solo i parametri non specificati nell'URI dell'endpoint possono essere impostati da altre API. Nota: se l'endpoint richiede una chiave di sottoscrizione per l'autenticazione, usare FromEndpoint(const SPXSTRING&, const SPXSTRING&) per passare la chiave di sottoscrizione come parametro. Per usare un token di autorizzazione con FromEndpoint, usare questo metodo per creare un'istanza di SpeechConfig e quindi chiamare SetAuthorizationToken() nell'istanza di SpeechConfig creata. Nota: aggiunta nella versione 1.5.0.

Parametri

  • endpoint URI dell'endpoint di servizio a cui connettersi.

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.

FromHost

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

Crea un'istanza della configurazione del riconoscimento vocale con l'host e la sottoscrizione specificati. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Si presuppone il percorso della risorsa standard. Per i servizi con un percorso di risorsa non standard o nessun percorso, usare invece FromEndpoint. Nota: i parametri di query non sono consentiti nell'URI host e devono essere impostati da altre API. Nota: per usare un token di autorizzazione con FromHost, usare FromHost(const SPXSTRING&) e quindi chiamare SetAuthorizationToken() nell'istanza di SpeechConfig creata. Nota: aggiunta nella versione 1.8.0.

Parametri

  • host Host del servizio a cui connettersi. Il formato è "protocol://host:port" dove ":p ort" è facoltativo.

  • subscription Chiave di sottoscrizione.

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.

FromHost

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

Crea un'istanza di SpeechConfig con l'host specificato. Questo metodo è destinato solo agli utenti che usano un host di servizio non predefinito. Si presuppone il percorso della risorsa standard. Per i servizi con un percorso di risorsa non standard o nessun percorso, usare invece FromEndpoint. Nota: i parametri di query non sono consentiti nell'URI host e devono essere impostati da altre API. Nota: se l'host richiede una chiave di sottoscrizione per l'autenticazione, usare FromHost(const SPXSTRING&, const SPXSTRING&) per passare la chiave di sottoscrizione come parametro. Per usare un token di autorizzazione con FromHost, usare questo metodo per creare un'istanza di SpeechConfig e quindi chiamare SetAuthorizationToken() nell'istanza di SpeechConfig creata. Nota: aggiunta nella versione 1.8.0.

Parametri

  • host URI host del servizio a cui connettersi. Il formato è "protocol://host:port" dove ":p ort" è facoltativo.

Restituisce

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.