koneksi kelas

class Connection
  : public std::enable_shared_from_this< Connection >

Koneksi adalah kelas proksi untuk mengelola koneksi ke layanan ucapan dari Recognizer yang ditentukan. Secara default, Recognizer secara otonom mengelola koneksi ke layanan saat diperlukan. Kelas Koneksi menyediakan metode tambahan bagi pengguna untuk secara eksplisit membuka atau menutup koneksi dan berlangganan perubahan status koneksi. Penggunaan Koneksi bersifat opsional. Ini ditujukan untuk skenario di mana penyetelan halus perilaku aplikasi berdasarkan status koneksi diperlukan. Pengguna dapat secara opsional memanggil Open() untuk memulai koneksi layanan secara manual sebelum memulai pengenalan pada Recognizer yang terkait dengan Koneksi ini. Setelah memulai pengenalan, panggilan Open() atau Close() mungkin gagal. Ini tidak akan berdampak pada Recognizer atau pengenalan yang sedang berlangsung. Koneksi mungkin hilang karena berbagai alasan, Recognizer akan selalu mencoba untuk mengganti koneksi sesuai kebutuhan untuk menjamin operasi yang sedang berlangsung. Dalam semua kasus ini peristiwa Tersambung/Terputus akan menunjukkan perubahan status koneksi. Diperbarui dalam versi 1.17.0.

Anggota

Tersambung

Sintaks: public EventSignal< const ConnectionEventArgs & > Connected;

Peristiwa Tersambung untuk menunjukkan bahwa pengenal terhubung ke layanan.

Terputus

Sintaks: public EventSignal< const ConnectionEventArgs & > Disconnected;

Peristiwa Terputus untuk menunjukkan bahwa pengenal terputus dari layanan.

MessageReceived

Sintaks: public EventSignal< const ConnectionMessageEventArgs & > MessageReceived;

Peristiwa MessageReceived untuk menunjukkan bahwa protokol yang mendasar menerima pesan dari layanan. Ditambahkan dalam versi 1.10.0.

Buka

Sintaks: public inline void Open ( bool forContinuousRecognition );

Mulai menyiapkan koneksi ke layanan. Pengguna dapat secara opsional memanggil Open() untuk menyiapkan koneksi secara manual terlebih dahulu sebelum memulai pengenalan/sintesis pada Recognizer/Synthesizer yang terkait dengan Koneksi ini. Setelah memulai pengenalan, panggilan Open() mungkin gagal, tergantung pada status proses Recognizer/Synthesizer. Tetapi kegagalan tidak memengaruhi status Recognizer/Synthesizer terkait. Catatan: Saat kembali, koneksi mungkin belum siap. Silakan berlangganan peristiwa Tersambung untuk diberi tahu ketika koneksi dibuat.

Parameter-parameternya

• forContinuousRecognition Menunjukkan apakah koneksi digunakan untuk pengenalan berkelanjutan atau pengenalan bidikan tunggal. Tidak berpengaruh jika koneksi berasal dari SpeechSynthsizer.

Tutup

Sintaks: public inline void Close ( );

Menutup koneksi layanan. Pengguna dapat secara opsional memanggil Close() untuk mematikan koneksi Recognizer/Synthesizer terkait secara manual. Panggilan mungkin gagal, tergantung pada status proses Recognizer/Synthesizer. Tetapi kegagalan tidak memengaruhi status Recognizer/Synthesizer terkait.

SetMessageProperty

Sintaks: public inline void SetMessageProperty ( const std::string & path , const std::string & propertyName , const std::string & propertyValue );

Menambahkan parameter dalam pesan ke layanan. Ditambahkan dalam versi 1.7.0.

Parameter-parameternya

• path jalur pesan.

• propertyName Nama properti.

• propertyValue Nilai properti. Ini adalah string json.

Pengembalian

kosong.

SendMessageAsync

Sintaks: public inline std::future< void > SendMessageAsync ( const std::string & path , const std::string & payload );

Kirim pesan ke layanan ucapan. Ditambahkan dalam versi 1.7.0.

Parameter-parameternya

• path Jalur pesan.

• payload Payload pesan. Ini adalah string json.

Pengembalian

Masa depan yang kosong.

SendMessageAsync

Sintaks: public inline std::future< void > SendMessageAsync ( const std::string & path , uint8_t * payload , uint32_t size );

Kirim pesan biner ke layanan ucapan. Metode ini tidak berfungsi untuk koneksi SpeechSynthesizer. Ditambahkan dalam versi 1.10.0.

Parameter-parameternya

• path Jalur pesan.

• payload Payload biner pesan.

• size Ukuran payload biner.

Pengembalian

Masa depan yang kosong.

Koneksi

Sintaks: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Konstruktor internal. Membuat instans baru menggunakan handel yang disediakan.

Parameter-parameternya

• handle Handel koneksi.

~Sambungan

Sintaks: public inline ~Connection ( );

Destruktor.

FromRecognizer

Sintaks: public inline static std::shared_ptr< Connection > FromRecognizer ( std::shared_ptr< Recognizer > recognizer );

Mendapatkan instans Koneksi dari pengenal yang ditentukan.

Parameter-parameternya

• recognizer Pengenal yang terkait dengan koneksi.

Pengembalian

Instans koneksi pengenal.

FromConversationTranslator

Sintaks: public inline static std::shared_ptr< Connection > FromConversationTranslator ( std::shared_ptr< Transcription::ConversationTranslator > convTrans );

Mendapatkan instans Koneksi dari penerjemah percakapan yang ditentukan.

Parameter-parameternya

• convTrans Penerjemah percakapan yang terkait dengan koneksi.

Pengembalian

Instans koneksi penerjemah percakapan.

FromDialogServiceConnector

Sintaks: public inline static std::shared_ptr< Connection > FromDialogServiceConnector ( std::shared_ptr< Dialog::DialogServiceConnector > dialogServiceConnector );

Mendapatkan instans Koneksi dari konektor layanan dialog yang ditentukan, digunakan untuk mengamati dan mengelola koneksi dan pemutusan sambungan dari layanan ucapan.

Parameter-parameternya

• dialogServiceConnector Konektor layanan dialog yang terkait dengan koneksi.

Pengembalian

Instans koneksi konektor layanan dialog.

FromSpeechSynthesizer

Sintaks: public inline static std::shared_ptr< Connection > FromSpeechSynthesizer ( std::shared_ptr< SpeechSynthesizer > synthesizer );

Mendapatkan instans Koneksi dari penyintesis ucapan yang ditentukan. Ditambahkan dalam versi 1.17.0.

Parameter-parameternya

• synthesizer Penyintesis ucapan yang terkait dengan koneksi.

Pengembalian

Instans koneksi dari penyintesis ucapan.