class SpeechConfig

  • Artikel

Kelas yang menentukan konfigurasi untuk pengenalan ucapan/niat, atau sintesis ucapan.

Anggota

EmbeddedSpeechConfig

Sitnaksis: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sitnaksis: public friend HybridSpeechConfig;

operator SPXSPEECHCONFIGHANDLE

Sitnaksis: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Operator internal digunakan untuk mendapatkan nilai handel yang mendasar.

Mengembalikan

Sebuah handel.

SetSpeechRecognitionLanguage

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

Atur bahasa input ke pengenal ucapan.

Parameter

  • lang Menentukan nama bahasa lisan yang akan dikenali dalam format BCP-47.

GetSpeechRecognitionLanguage

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

Mendapatkan bahasa input ke pengenalan ucapan. Bahasa ditentukan dalam format BCP-47.

Mengembalikan

Bahasa pengenalan ucapan.

SetSpeechSynthesisLanguage

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

Mengatur bahasa penyintesis ucapan. Ditambahkan dalam versi 1.4.0.

Parameter

  • lang Menentukan nama bahasa (misalnya en-US)

GetSpeechSynthesisLanguage

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

Mendapatkan bahasa synthesizer ucapan. Ditambahkan dalam versi 1.4.0.

Mengembalikan

Bahasa sintesis ucapan.

SetSpeechSynthesisVoiceName

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

Atur suara synthesizer ucapan. Ditambahkan dalam versi 1.4.0.

Parameter

  • voiceName Menentukan nama suara

GetSpeechSynthesisVoiceName

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

Mendapatkan suara synthesizer ucapan. Ditambahkan dalam versi 1.4.0.

Mengembalikan

Nama suara sintesis ucapan.

SetSpeechSynthesisOutputFormat

Sitnaksis: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

Mengatur format output sintesis ucapan (misalnya Riff16Khz16BitMonoPcm). Ditambahkan dalam versi 1.4.0.

Parameter

  • formatId Menentukan ID format output

GetSpeechSynthesisOutputFormat

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

Mendapatkan format output sintesis ucapan. Ditambahkan dalam versi 1.4.0.

Mengembalikan

Format output sintesis ucapan.

SetEndpointId

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

Mengatur ID titik akhir Ucapan Kustom atau Suara Kustom.

Parameter

  • endpointId ID Titik Akhir.

GetEndpointId

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

Mendapatkan ID titik akhir Ucapan Kustom atau Suara Kustom.

Mengembalikan

ID Titik Akhir.

SetAuthorizationToken

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

Mengatur token otorisasi untuk menyambungkan ke layanan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid. Karena nilai konfigurasi disalin saat membuat pengenal baru, nilai token baru tidak akan berlaku untuk pengenal yang telah dibuat. Untuk pengenal yang telah dibuat sebelumnya, Anda perlu mengatur token otorisasi pengenal yang sesuai untuk menyegarkan token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

Parameter

  • token Token otorisasi.

GetAuthorizationToken

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

Mendapatkan token otorisasi untuk terhubung ke layanan.

Mengembalikan

Token otorisasi.

GetSubscriptionKey

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

Mendapatkan kunci langganan yang digunakan untuk membuat Pengenal Ucapan atau Pengenal Niat atau Pengenal Terjemahan atau Speech Synthesizer.

Mengembalikan

Kunci langganan.

GetRegion

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

Mendapatkan kunci wilayah yang digunakan untuk membuat Pengenal Ucapan atau Pengenal Niat atau Pengenal Terjemahan atau Synthesizer ucapan.

Mengembalikan

Wilayah.

GetOutputFormat

Sitnaksis: public inline OutputFormat GetOutputFormat ( ) const;

Mendapatkan format output pengenalan ucapan (sederhana atau terperinci). Catatan: Format output ini untuk hasil pengenalan ucapan, gunakan SpeechConfig::GetSpeechSynthesisOutputFormat untuk mendapatkan format output audio yang disintesis.

Mengembalikan

Format output pengenalan ucapan.

SetOutputFormat

Sitnaksis: public inline void SetOutputFormat ( OutputFormat format );

Mengatur format output pengenalan ucapan (sederhana atau terperinci). Catatan: Format output ini untuk hasil pengenalan ucapan, gunakan SpeechConfig::SetSpeechSynthesisOutputFormat untuk mengatur format output audio yang disintesis.

Parameter

  • format Format output pengenalan ucapan

SetProfanity

Sitnaksis: public inline void SetProfanity ( ProfanityOption profanity );

Mengatur opsi kata-kata kosan. Ditambahkan dalam versi 1.5.0.

Parameter

  • profanity Nilai opsi kata-kata kosan.

EnableAudioLogging

Sitnaksis: public inline void EnableAudioLogging ( );

Mengaktifkan pengelogan audio dalam layanan. Ditambahkan dalam versi 1.5.0.

Log audio dan konten disimpan baik di penyimpanan milik Microsoft, atau di akun penyimpanan Anda sendiri yang ditautkan ke langganan Cognitive Services Anda (Bring Your Own Storage (BYOS) yang diaktifkan sumber daya Ucapan).

RequestWordLevelTimestamps

Sitnaksis: public inline void RequestWordLevelTimestamps ( );

Menyertakan tanda waktu tingkat kata dalam hasil respons. Ditambahkan dalam versi 1.5.0.

AktifkanDictation

Sitnaksis: public inline void EnableDictation ( );

Mengaktifkan mode dikte. Hanya didukung dalam pengenalan berkelanjutan ucapan. Ditambahkan dalam versi 1.5.0.

SetProxy

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

Mengatur konfigurasi proksi Ditambahkan dalam versi 1.1.0.

Catatan: Fungsionalitas proksi tidak tersedia di macOS. Fungsi ini tidak akan berpengaruh pada platform ini.

Parameter

  • proxyHostName Nama host server proksi, tanpa skema protokol ([http://](http://))

  • proxyPort Nomor port server proksi

  • proxyUserName Nama pengguna server proksi

  • proxyPassword Kata sandi server proksi

SetProperty

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

Mengatur nilai properti menurut nama.

Parameter

  • name Nama properti.

  • value Nilai properti.

Getproperty

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

Mendapatkan nilai properti berdasarkan nama.

Parameter

  • name Nama parameter.

Mengembalikan

Nilai properti.

Getproperty

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

Mendapatkan nilai properti menurut ID.

Parameter

  • id Id parameter.

Mengembalikan

Nilai properti.

SetProperty

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

Mengatur nilai properti menurut ID.

Parameter

  • id Id properti.

  • value Nilai properti.

SetServiceProperty

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

Mengatur nilai properti yang akan diteruskan ke layanan menggunakan saluran yang ditentukan. Ditambahkan dalam versi 1.5.0.

Parameter

  • name Nama properti.

  • value Nilai properti.

  • channel Saluran yang digunakan untuk meneruskan properti yang ditentukan ke layanan.

~SpeechConfig

Sitnaksis: public inline virtual ~SpeechConfig ( );

Merusak objek.

FromSubscription

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

Membuat instans konfigurasi ucapan dengan kunci dan wilayah langganan yang ditentukan.

Parameter

  • subscription Kunci langganan.

  • region Nama wilayah (lihat halaman wilayah).

Mengembalikan

Penunjuk bersama ke instans konfigurasi ucapan baru.

FromAuthorizationToken

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

Membuat instans konfigurasi ucapan dengan token dan wilayah otorisasi yang ditentukan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid. Karena nilai konfigurasi disalin saat membuat pengenal baru, nilai token baru tidak akan berlaku untuk pengenal yang telah dibuat. Untuk pengenal yang telah dibuat sebelumnya, Anda perlu mengatur token otorisasi pengenal yang sesuai untuk menyegarkan token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

Parameter

Mengembalikan

Penunjuk bersama ke instans konfigurasi ucapan baru.

FromEndpoint

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

Membuat instans konfigurasi ucapan dengan titik akhir dan langganan yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan titik akhir layanan non-standar. Catatan: Parameter kueri yang ditentukan dalam URI titik akhir tidak diubah, meskipun diatur oleh API lain. Misalnya, jika bahasa pengenalan didefinisikan dalam URI sebagai parameter kueri "language=de-DE", dan juga diatur oleh SetSpeechRecognitionLanguage("en-US"), pengaturan bahasa dalam URI lebih diutamakan, dan bahasa yang efektif adalah "de-DE". Hanya parameter yang tidak ditentukan dalam URI titik akhir yang dapat diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan FromEndpoint, gunakan FromEndpoint(const SPXSTRING&), lalu panggil SetAuthorizationToken() pada instans SpeechConfig yang dibuat.

Parameter

  • endpoint Titik akhir layanan yang akan disambungkan.

  • subscription Kunci langganan.

Mengembalikan

Pointer bersama ke instans konfigurasi ucapan baru.

FromEndpoint

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

Membuat instans SpeechConfig dengan titik akhir yang ditentukan. Metode ini hanya ditujukan untuk pengguna yang menggunakan titik akhir layanan non-standar. Catatan: Parameter kueri yang ditentukan dalam URI titik akhir tidak diubah, meskipun diatur oleh API lain. Apakah parameter kueri tertentu didukung atau tidak, bergantung pada titik akhir dan skenario. Misalnya, jika bahasa pengenalan didefinisikan dalam URI sebagai parameter kueri "language=de-DE", dan juga diatur oleh SetSpeechRecognitionLanguage("en-US"), pengaturan bahasa dalam URI lebih diutamakan, dan bahasa yang efektif adalah "de-DE". Contoh hanya berlaku saat kombinasi titik akhir dan skenario mendukung bahasa sebagai parameter kueri. Hanya parameter yang tidak ditentukan dalam URI titik akhir yang dapat diatur oleh API lain. Catatan: Jika titik akhir memerlukan kunci langganan untuk autentikasi, gunakan FromEndpoint(const SPXSTRING&, const SPXSTRING&) untuk meneruskan kunci langganan sebagai parameter. Untuk menggunakan token otorisasi dengan FromEndpoint, gunakan metode ini untuk membuat instans SpeechConfig, lalu panggil SetAuthorizationToken() pada instans SpeechConfig yang dibuat. Catatan: Ditambahkan dalam versi 1.5.0.

Parameter

  • endpoint URI titik akhir layanan untuk disambungkan.

Mengembalikan

Pointer bersama ke instans konfigurasi ucapan baru.

FromHost

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

Membuat instans konfigurasi ucapan dengan host dan langganan tertentu. Metode ini hanya ditujukan untuk pengguna yang menggunakan host layanan non-default. Jalur sumber daya standar akan diasumsikan. Untuk layanan dengan jalur sumber daya non-standar atau tidak ada jalur sama sekali, gunakan FromEndpoint sebagai gantinya. Catatan: Parameter kueri tidak diizinkan di URI host dan harus diatur oleh API lain. Catatan: Untuk menggunakan token otorisasi dengan FromHost, gunakan FromHost(const SPXSTRING&), lalu panggil SetAuthorizationToken() pada instans SpeechConfig yang dibuat. Catatan: Ditambahkan dalam versi 1.8.0.

Parameter

  • host Host layanan yang akan disambungkan. Formatnya adalah "protocol://host:port" di mana ":p ort" bersifat opsional.

  • subscription Kunci langganan.

Mengembalikan

Pointer bersama ke instans konfigurasi ucapan baru.

FromHost

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

Membuat instans SpeechConfig dengan host tertentu. Metode ini hanya ditujukan untuk pengguna yang menggunakan host layanan non-default. Jalur sumber daya standar akan diasumsikan. Untuk layanan dengan jalur sumber daya non-standar atau tidak ada jalur sama sekali, gunakan FromEndpoint sebagai gantinya. Catatan: Parameter kueri tidak diizinkan di URI host dan harus diatur oleh API lain. Catatan: Jika host memerlukan kunci langganan untuk autentikasi, gunakan FromHost(const SPXSTRING&, const SPXSTRING&) untuk meneruskan kunci langganan sebagai parameter. Untuk menggunakan token otorisasi dengan FromHost, gunakan metode ini untuk membuat instans SpeechConfig, lalu panggil SetAuthorizationToken() pada instans SpeechConfig yang dibuat. Catatan: Ditambahkan dalam versi 1.8.0.

Parameter

  • host URI host layanan untuk disambungkan. Formatnya adalah "protocol://host:port" di mana ":p ort" bersifat opsional.

Mengembalikan

Pointer bersama ke instans konfigurasi ucapan baru.