Koneksi kelas

  • Artikel 
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 penyempurnaan 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, memanggil 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 sebagaimana diperlukan 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

Terhubung

Sitnaksis: public EventSignal< constConnectionEventArgs & > Connected;

Peristiwa Tersambung untuk menunjukkan bahwa pengenal terhubung ke layanan.

Terputus

Sitnaksis: public EventSignal< constConnectionEventArgs & > Disconnected;

Peristiwa Terputus untuk menunjukkan bahwa pengenal terputus dari layanan.

MessageReceived

Sitnaksis: public EventSignal< constConnectionMessageEventArgs & > MessageReceived;

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

Open

Sitnaksis: 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

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

Tutup

Sitnaksis: 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

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

Menambahkan parameter dalam pesan ke layanan. Metode ini tidak berfungsi untuk koneksi SpeechSynthesizer. Ditambahkan dalam versi 1.7.0.

Parameter

  • path jalur pesan.

  • propertyName Nama properti .

  • propertyValue Nilai properti . Ini adalah string json.

Mengembalikan

Kekosongan.

SendMessageAsync

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

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

Parameter

  • path Jalur pesan.

  • payload Payload pesan. Ini adalah string json.

Mengembalikan

Masa depan yang kosong.

SendMessageAsync

Sitnaksis: 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

  • path Jalur pesan.

  • payload Payload biner pesan.

  • size Ukuran payload biner.

Mengembalikan

Masa depan yang kosong.

Koneksi

Sitnaksis: public inline explicit Connection ( SPXCONNECTIONHANDLE handle );

Konstruktor internal. Membuat instans baru menggunakan handel yang disediakan.

Parameter

  • handle Handel koneksi.

~Koneksi

Sitnaksis: public inline ~Connection ( );

Destruktor.

FromRecognizer

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

Mendapatkan instans Koneksi dari pengenal yang ditentukan.

Parameter

  • recognizer Pengenal yang terkait dengan koneksi.

Mengembalikan

Instans koneksi pengenal.

FromConversationTranslator

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

Mendapatkan instans Koneksi dari penerjemah percakapan yang ditentukan.

Parameter

  • convTrans Penerjemah percakapan yang terkait dengan koneksi.

Mengembalikan

Instans koneksi penerjemah percakapan.

FromDialogServiceConnector

Sitnaksis: 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

  • dialogServiceConnector Konektor layanan dialog yang terkait dengan koneksi.

Mengembalikan

Instans Koneksi konektor layanan dialog.

FromSpeechSynthesizer

Sitnaksis: 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

  • synthesizer Penyintesis ucapan yang terkait dengan koneksi.

Mengembalikan

Instans koneksi dari penyintesis ucapan.