kelas SpeechConfig

Kelas yang menentukan konfigurasi untuk pengenalan ucapan atau sintesis ucapan.

Anggota

EmbeddedSpeechConfig

Sintaks: public friend EmbeddedSpeechConfig;

HybridSpeechConfig

Sintaks: public friend HybridSpeechConfig;

operator SPXSPEECHCONFIGHANDLE

Sintaks: public inline explicit operator SPXSPEECHCONFIGHANDLE ( ) const;

Operator internal digunakan untuk mendapatkan nilai handel yang mendasar.

Pengembalian

Pegangan.

SetSpeechRecognitionLanguage

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

Atur bahasa input ke pengenal ucapan.

Parameter-parameternya

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

GetSpeechRecognitionLanguage

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

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

Pengembalian

Bahasa pengenalan ucapan.

SetSpeechSynthesisLanguage

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

Mengatur bahasa penyintesis ucapan. Ditambahkan dalam versi 1.4.0.

Parameter-parameternya

  • lang Menentukan nama bahasa (misalnya en-US)

GetSpeechSynthesisLanguage

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

Mendapatkan bahasa penyintesis ucapan. Ditambahkan dalam versi 1.4.0.

Pengembalian

Bahasa sintesis ucapan.

SetSpeechSynthesisVoiceName

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

Atur suara penyintesis ucapan. Ditambahkan dalam versi 1.4.0.

Parameter-parameternya

  • voiceName Menentukan nama suara

GetSpeechSynthesisVoiceName

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

Mendapatkan suara penyintesis ucapan. Ditambahkan dalam versi 1.4.0.

Pengembalian

Nama suara sintesis ucapan.

SetSpeechSynthesisOutputFormat

Sintaks: public inline void SetSpeechSynthesisOutputFormat ( SpeechSynthesisOutputFormat formatId );

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

Parameter-parameternya

  • formatId Menentukan ID format output

GetSpeechSynthesisOutputFormat

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

Mendapatkan format output sintesis ucapan. Ditambahkan dalam versi 1.4.0.

Pengembalian

Format output sintesis ucapan.

SetEndpointId

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

Mengatur ID titik akhir Ucapan Kustom atau Suara Kustom.

Parameter-parameternya

  • ID Titik Akhir endpointId.

GetEndpointId

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

Mendapatkan ID titik akhir Ucapan Kustom atau Suara Kustom.

Pengembalian

ID titik akhir.

SetAuthorizationToken

Sintaks: 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 valid baru. 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 me-refresh token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

Parameter-parameternya

  • token Token otorisasi.

GetAuthorizationToken

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

Mendapatkan token otorisasi untuk terhubung ke layanan.

Pengembalian

Token otorisasi.

GetSubscriptionKey

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

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

Pengembalian

Kunci langganan.

GetRegion

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

Mendapatkan kunci wilayah yang digunakan untuk membuat Pengenal Ucapan atau Pengenal Terjemahan atau Sintesis Ucapan.

Pengembalian

Wilayah.

GetOutputFormat

Sintaks: public inline OutputFormat GetOutputFormat ( ) const;

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

Pengembalian

Format output pengenalan ucapan.

SetOutputFormat

Sintaks: public inline void SetOutputFormat ( OutputFormat format );

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

Parameter-parameternya

  • format output pengenalan ucapan format

SetProfanity

Sintaks: public inline void SetProfanity ( ProfanityOption profanity );

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

Parameter-parameternya

  • profanity nilai opsi Kata-kata kokoh.

AktifkanAudioLogging

Sintaks: 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) diaktifkan sumber daya Ucapan).

RequestWordLevelTimestamps

Sintaks: public inline void RequestWordLevelTimestamps ( );

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

AktifkanDictation

Sintaks: public inline void EnableDictation ( );

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

SetProxy

Sintaks: 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-parameternya

  • 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

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

Mengatur nilai properti berdasarkan nama.

Parameter-parameternya

  • name Nama properti.

  • value Nilai properti.

GetProperty

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

Mendapatkan nilai properti berdasarkan nama.

Parameter-parameternya

  • name Nama parameter.

Pengembalian

Nilai properti.

GetProperty

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

Mendapatkan nilai properti menurut ID.

Parameter-parameternya

  • id Id parameter.

Pengembalian

Nilai properti.

SetProperty

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

Mengatur nilai properti menurut ID.

Parameter-parameternya

  • id Id properti.

  • value Nilai properti.

SetServiceProperty

Sintaks: 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-parameternya

  • name Nama properti.

  • value Nilai properti.

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

~SpeechConfig

Sintaks: public inline virtual ~SpeechConfig ( );

Merusak objek.

FromSubscription

Sintaks: 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 tertentu.

Parameter-parameternya

  • subscription Kunci langganan.

  • region Nama wilayah (lihat halaman wilayah ).

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

FromAuthorizationToken

Sintaks: 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 valid baru. 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 me-refresh token. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

Parameter-parameternya

  • authToken Token otorisasi.

  • region Nama wilayah (lihat halaman wilayah ).

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

FromEndpoint

Sintaks: 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 tertentu. 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-parameternya

  • endpoint Titik akhir layanan yang akan disambungkan.

  • subscription Kunci langganan.

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

FromEndpoint

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

Membuat instans SpeechConfig dengan titik akhir tertentu. 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 ketika 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-parameternya

  • endpoint URI titik akhir layanan yang akan disambungkan.

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

FromHost

Sintaks: 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, 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-parameternya

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

  • subscription Kunci langganan.

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

FromHost

Sintaks: 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, 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-parameternya

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

Pengembalian

Pointer bersama ke instans konfigurasi ucapan baru.

  • Last updated on