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.objectConnection
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.
Azure SDK for Python