Condividi tramite

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.

Restituzioni

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.

Restituzioni

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.

Restituzioni

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.

Restituzioni

Nome della voce di sintesi vocale.

SetSpeechSynthesisOutputFormat

Sintassi: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

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

Parametri

  • formatId Specifica l'ID 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.

Restituzioni

Formato di output della sintesi vocale.

SetEndpointId

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

Imposta l'ID endpoint di Riconoscimento vocale personalizzato o Voce personalizzata.

Parametri

  • endpointId ID endpoint.

GetEndpointId

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

Ottiene l'ID endpoint della voce personalizzata o della voce personalizzata.

Restituzioni

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. Poiché i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscitore, il nuovo valore del token non verrà applicato ai riconoscitori che sono già stati creati. Per i riconoscitori creati in precedenza, è necessario impostare il token di autorizzazione del riconoscitore corrispondente per aggiornare il token. In caso contrario, i riconoscitori 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.

Restituzioni

Token di autorizzazione.

GetSubscriptionKey

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

Ottiene la chiave di sottoscrizione utilizzata per creare Riconoscimento vocale o Riconoscimento finalità o Riconoscimento finalità o Riconoscimento traduzione o Sintesi vocale.

Restituzioni

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 traduzione o Sintetizzatore vocale.

Restituzioni

Regione.

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.

Restituzioni

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 Profanity.

EnableAudioLogging

Sintassi: public inline void EnableAudioLogging ( );

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

I log audio e del contenuto vengono archiviati nella risorsa di archiviazione di proprietà di Microsoft o nel proprio account di archiviazione collegato alla sottoscrizione di Servizi cognitivi (risorsa byos bring your own storage (BYOS) abilitata per il riconoscimento vocale.

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à 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 del 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 Il nome host del server proxy, senza lo schema di protocollo ([http://](http://))

  • proxyPort Numero di porta del server proxy

  • proxyUserName Il 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 Il 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.

Restituzioni

Valore della proprietà di .

GetProperty

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

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

Parametri

  • id ID parametro.

Restituzioni

Valore della proprietà di .

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 della proprietà che verrà passato al servizio usando il canale specificato. Aggiunta nella versione 1.5.0.

Parametri

  • name Il nome della proprietà.

  • value Valore della proprietà.

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

~SpeechConfig

Sintassi: public inline virtual ~SpeechConfig ( );

Decostruisce 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 di sottoscrizione e l'area specificate.

Parametri

  • subscription La chiave di sottoscrizione.

  • region Il nome dell'area (vedere la pagina dell'area ).

Restituzioni

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. Poiché i valori di configurazione vengono copiati durante la creazione di un nuovo riconoscitore, il nuovo valore del token non verrà applicato ai riconoscitori che sono già stati creati. Per i riconoscitori creati in precedenza, è necessario impostare il token di autorizzazione del riconoscitore corrispondente per aggiornare il token. In caso contrario, i riconoscitori riscontrano errori durante il riconoscimento.

Parametri

  • authToken Token di autorizzazione.

  • region Il nome dell'area (vedere la pagina dell'area ).

Restituzioni

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 l'endpoint e la 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 L'endpoint del servizio a cui connettersi.

  • subscription La chiave di sottoscrizione.

Restituzioni

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 speechConfig e quindi chiamare SetAuthorizationToken() nell'istanza di SpeechConfig creata. Nota: aggiunta nella versione 1.5.0.

Parametri

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

Restituzioni

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 L'host del servizio a cui connettersi. Il formato è "protocol://host:port" dove ":p ort" è facoltativo.

  • subscription La chiave di sottoscrizione.

Restituzioni

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 L'URI dell'host del servizio a cui connettersi. Il formato è "protocol://host:port" dove ":p ort" è facoltativo.

Restituzioni

Puntatore condiviso alla nuova istanza di configurazione del riconoscimento vocale.