Connection Kelas

Kelas proksi untuk mengelola koneksi ke layanan ucapan dari yang ditentukan Recognizer.

Secara default, secara Recognizer otonom mengelola koneksi ke layanan saat diperlukan. Kelas ini Connection menyediakan metode tambahan bagi pengguna untuk secara eksplisit membuka atau menutup koneksi dan berlangganan perubahan status koneksi. Penggunaan Connection bersifat opsional. Ini ditujukan untuk skenario di mana penyetelan perilaku aplikasi berdasarkan status koneksi diperlukan. Pengguna dapat secara opsional memanggil open untuk memulai koneksi layanan secara manual sebelum memulai pengenalan pada yang Recognizer terkait dengan ini Connection. Setelah memulai pengenalan open , panggilan 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 connected/disconnected ini, peristiwa akan menunjukkan perubahan status koneksi.

Catatan

Diperbarui dalam versi 1.17.0.

Konstruktor untuk penggunaan internal.

Warisan

builtins.object

Connection

Konstruktor

Connection(handle: c_void_p)

Parameter

Nama	Deskripsi
handle Diperlukan

Metode

close	Menutup koneksi layanan. Pengguna dapat secara opsional memanggil close untuk mematikan koneksi yang terkait Recognizersecara manual. Panggilan mungkin gagal, tergantung pada status Recognizerproses . Tetapi kegagalan tidak memengaruhi status yang terkait Recognizer.
from_dialog_service_connector	Mendapatkan instans Connection dari konektor layanan dialog yang ditentukan.
from_recognizer	Mendapatkan instans Connection dari recognizer yang ditentukan.
from_speech_synthesizer	Mendapatkan instans Connection dari penyintesis ucapan yang ditentukan. Catatan Ditambahkan dalam versi 1.17.0.
open	Mulai menyetel koneksi ke layanan. Pengguna dapat secara opsional memanggil open untuk menyiapkan koneksi secara manual terlebih dahulu sebelum memulai pengenalan pada yang Recognizer terkait dengan ini Connection. Setelah memulai pengenalan open, panggilan ) mungkin gagal, tergantung pada status Recognizerproses . Tetapi kegagalan tidak memengaruhi status yang terkait Recognizer. Catatan Saat kembali, koneksi mungkin belum siap. Silakan berlangganan peristiwa tersambung untuk diberi tahu ketika koneksi dibuat.
set_message_property	Menambahkan parameter dalam pesan ke layanan. Catatan Metode ini tidak berfungsi untuk koneksi SpeechSynthesizer.

close

Menutup koneksi layanan. Pengguna dapat secara opsional memanggil close untuk mematikan koneksi yang terkait Recognizersecara manual. Panggilan mungkin gagal, tergantung pada status Recognizerproses . Tetapi kegagalan tidak memengaruhi status yang terkait Recognizer.

close()

from_dialog_service_connector

Mendapatkan instans Connection dari konektor layanan dialog yang ditentukan.

from_dialog_service_connector(dialog_service_connector: DialogServiceConnector) -> Connection

Parameter

Nama	Deskripsi
dialog_service_connector Diperlukan

from_recognizer

Mendapatkan instans Connection dari recognizer yang ditentukan.

from_recognizer(recognizer: Recognizer) -> Connection

Parameter

Nama	Deskripsi
recognizer Diperlukan

from_speech_synthesizer

Mendapatkan instans Connection dari penyintesis ucapan yang ditentukan.

Catatan

Ditambahkan dalam versi 1.17.0.

from_speech_synthesizer(speech_synthesizer: SpeechSynthesizer) -> Connection

Parameter

Nama	Deskripsi
speech_synthesizer Diperlukan

open

Mulai menyetel koneksi ke layanan. Pengguna dapat secara opsional memanggil open untuk menyiapkan koneksi secara manual terlebih dahulu sebelum memulai pengenalan pada yang Recognizer terkait dengan ini Connection. Setelah memulai pengenalan open, panggilan ) mungkin gagal, tergantung pada status Recognizerproses . Tetapi kegagalan tidak memengaruhi status yang terkait Recognizer.

Catatan

Saat kembali, koneksi mungkin belum siap. Silakan berlangganan

peristiwa tersambung untuk diberi tahu ketika koneksi dibuat.

open(for_continuous_recognition: bool)

Parameter

Nama	Deskripsi
forContinuousRecognition Diperlukan	menunjukkan apakah koneksi digunakan untuk pengenalan berkelanjutan atau pengenalan satu bidikan. Tidak berpengaruh jika koneksi berasal dari SpeechSynthsizer.
for_continuous_recognition Diperlukan

set_message_property

Menambahkan parameter dalam pesan ke layanan.

Catatan

Metode ini tidak berfungsi untuk koneksi SpeechSynthesizer.

set_message_property(path: str, property_name: str, property_value: str)

Parameter

Nama	Deskripsi
path Diperlukan	Jalur pesan.
property_name Diperlukan	Nama properti yang ingin Anda atur.
property_value Diperlukan	Nilai properti yang ingin Anda atur.

Atribut

connected

Peristiwa Tersambung untuk menunjukkan bahwa recognizer terhubung ke layanan.

disconnected

Peristiwa Terputus untuk menunjukkan bahwa pengenal terputus dari layanan.