DialogServiceConnector Kelas

Objek yang berkomunikasi dengan sistem dialog yang mendukung ucapan menggunakan Kerangka Kerja Bot atau Perintah Kustom. Jenis ini menerima hasil ucapan ke teks dan juga memfasilitasi pengiriman asinkron dan penerimaan data aktivitas dialog non-ucapan.

Warisan

builtins.object

DialogServiceConnector

Konstruktor

DialogServiceConnector(dialog_service_config: DialogServiceConfig, audio_config: AudioConfig | None = None)

Parameter

Nama	Deskripsi
dialog_service_config Diperlukan	Konfigurasi untuk layanan dialog, baik untuk kerangka kerja bot atau perintah kustom.
audio_config	Konfigurasi untuk input audio. nilai default: None

Metode

connect	Secara sinkron membuat koneksi dengan layanan. Koneksi secara otomatis dilakukan ketika diperlukan, tetapi panggilan manual ini dapat berguna untuk memastikan koneksi aktif sebelum penggunaan pertamanya untuk membantu mengurangi latensi awal. Saat kembali, koneksi mungkin belum siap. Silakan berlangganan peristiwa yang terhubung dari instans Koneksi untuk diberi tahu ketika koneksi ke layanan dibuat. Silakan gunakan Connection untuk mengambil instans dengan menggunakan from_dialog_service_connector metode .
connect_async	Secara asinkron membangun koneksi dengan layanan. Koneksi secara otomatis dilakukan ketika diperlukan, tetapi panggilan manual ini dapat berguna untuk memastikan koneksi aktif sebelum penggunaan pertamanya untuk membantu mengurangi latensi awal.
disconnect	Secara sinkron terputus dari layanan. Panggilan berikutnya yang memerlukan koneksi masih akan secara otomatis terhubung kembali setelah pemutusan sambungan manual.
disconnect_async	Secara asinkron terputus dari layanan. Panggilan berikutnya yang memerlukan koneksi masih akan secara otomatis terhubung kembali setelah pemutusan sambungan manual.
listen_once	Secara sinkron memulai interaksi ucapan ke teks dengan konektor ini dan memblokir hingga satu hasil akhir ucapan ke teks diterima. Hasil ucapan ke teks yang diterima juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas.
listen_once_async	Secara asinkron memulai interaksi ucapan ke teks dengan konektor ini dan memblokir hingga satu hasil akhir ucapan ke teks diterima. Hasil ucapan ke teks yang diterima juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas.
send_activity	Secara sinkron mengirim payload data ke layanan backend dialog yang tersambung dengan instans DialogServiceConnector ini. Ini biasanya merupakan dokumen JSON dengan skemanya yang ditentukan oleh implementasi dialog dalam layanan dan konten aktivitas terkirim harus diisi dengan pengetahuan tentang format dan harapan konten dari sistem dialog. Aktivitas terkirim tidak terkait dengan interaksi lain dan akan menghasilkan pengidentifikasi interaksi mandiri mereka sendiri ketika diproses oleh layanan. Korelasi percakapan dan interaksi lainnya harus dicapai melalui payload aktivitas itu sendiri menggunakan kemampuan implementasi dialog yang digunakan.
send_activity_async	Secara asinkron mengirim aktivitas ke dialog pendukung, lihat detail deskripsi di send_activity
start_keyword_recognition	Secara sinkron memulai interaksi ucapan ke teks dengan konektor ini menggunakan kata kunci. Interaksi ini akan menggunakan model kata kunci yang disediakan untuk mendengarkan kata kunci tanpa batas waktu, di mana audio tidak dikirim ke layanan ucapan dan semua pemrosesan dilakukan secara lokal. Ketika kata kunci dikenali, DialogServiceConnector akan secara otomatis terhubung ke layanan ucapan dan mulai mengirim data audio tepat sebelum kata kunci seolah-olah listen_once_async dipanggil. Saat diterima, hasil ucapan ke teks dapat diproses oleh penangan hasil yang disediakan atau diambil melalui langganan ke peristiwa yang dikenali. Hasil ucapan ke teks yang dihasilkan oleh operasi ini juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas. Panggil stop_keyword_recognition_async untuk menghentikan pengenalan yang dimulai kata kunci.
start_keyword_recognition_async	Secara asinkron mengonfigurasi konektor layanan dialog dengan model kata kunci yang diberikan. Setelah memanggil metode ini, konektor mendengarkan kata kunci untuk memulai pengenalan. Panggil stop_keyword_recognition_async untuk menghentikan pengenalan yang dimulai kata kunci. Lihat start_keyword_recognition untuk deskripsi terperinci tentang fungsionalitas.
stop_keyword_recognition	Secara sinkron menghentikan pengenalan yang dimulai kata kunci.
stop_keyword_recognition_async	Secara asinkron menghentikan pengenalan yang dimulai kata kunci.
stop_listening	Meminta penghentian segera ke operasi mendengarkan aktif apa pun. Ini dapat mengganggu interaksi ucapan ke teks yang sedang berlangsung dan hasil ucapan ke teks apa pun yang diterima dapat mewakili input ucapan yang tidak lengkap. Metode sinkron tidak boleh dipanggil saat menangani peristiwa. Gunakan stop_listening_async jika penghentian diinginkan sebagai respons terhadap suatu peristiwa.
stop_listening_async	Meminta penghentian segera ke operasi mendengarkan aktif apa pun. Ini dapat mengganggu interaksi ucapan ke teks yang sedang berlangsung dan hasil ucapan ke teks apa pun yang diterima dapat mewakili input ucapan yang tidak lengkap.

connect

Secara sinkron membuat koneksi dengan layanan. Koneksi secara otomatis dilakukan ketika diperlukan, tetapi panggilan manual ini dapat berguna untuk memastikan koneksi aktif sebelum penggunaan pertamanya untuk membantu mengurangi latensi awal.

Saat kembali, koneksi mungkin belum siap. Silakan berlangganan peristiwa yang terhubung dari instans Koneksi untuk diberi tahu ketika koneksi ke layanan dibuat. Silakan gunakan Connection untuk mengambil instans dengan menggunakan from_dialog_service_connector metode .

connect()

connect_async

Secara asinkron membangun koneksi dengan layanan. Koneksi secara otomatis dilakukan ketika diperlukan, tetapi panggilan manual ini dapat berguna untuk memastikan koneksi aktif sebelum penggunaan pertamanya untuk membantu mengurangi latensi awal.

connect_async()

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi setelah koneksi diinisialisasi.

disconnect

Secara sinkron terputus dari layanan. Panggilan berikutnya yang memerlukan koneksi masih akan secara otomatis terhubung kembali setelah pemutusan sambungan manual.

disconnect()

disconnect_async

Secara asinkron terputus dari layanan. Panggilan berikutnya yang memerlukan koneksi masih akan secara otomatis terhubung kembali setelah pemutusan sambungan manual.

disconnect_async()

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi ketika terputus.

listen_once

Secara sinkron memulai interaksi ucapan ke teks dengan konektor ini dan memblokir hingga satu hasil akhir ucapan ke teks diterima. Hasil ucapan ke teks yang diterima juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas.

listen_once() -> SpeechRecognitionResult

Mengembalikan

Jenis	Deskripsi
	hasil ucapan ke teks dari pengenalan ucapan.

listen_once_async

Secara asinkron memulai interaksi ucapan ke teks dengan konektor ini dan memblokir hingga satu hasil akhir ucapan ke teks diterima. Hasil ucapan ke teks yang diterima juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas.

listen_once_async() -> ResultFuture

Mengembalikan

Jenis	Deskripsi
	Masa depan yang berisi nilai hasil ucapan ke teks dari pengenalan asinkron.

send_activity

Secara sinkron mengirim payload data ke layanan backend dialog yang tersambung dengan instans DialogServiceConnector ini. Ini biasanya merupakan dokumen JSON dengan skemanya yang ditentukan oleh implementasi dialog dalam layanan dan konten aktivitas terkirim harus diisi dengan pengetahuan tentang format dan harapan konten dari sistem dialog. Aktivitas terkirim tidak terkait dengan interaksi lain dan akan menghasilkan pengidentifikasi interaksi mandiri mereka sendiri ketika diproses oleh layanan. Korelasi percakapan dan interaksi lainnya harus dicapai melalui payload aktivitas itu sendiri menggunakan kemampuan implementasi dialog yang digunakan.

send_activity(activity: str) -> str

Parameter

Nama	Deskripsi
activity Diperlukan	payload berseri aktivitas yang akan dikirim.

Mengembalikan

Jenis

Deskripsi

pengidentifikasi interaksi yang diperoleh ketika aktivitas diakui oleh layanan. Ini dapat terjadi sebelum aktivitas diproses dan dievaluasi oleh implementasi dialog dan penerimaan pengidentifikasi interaksi tidak menunjukkan keberhasilan atau kegagalan dalam memproses aktivitas. Informasi tentang keberhasilan atau kegagalan dapat diperoleh melalui aktivitas respons dengan data korelasi atau dengan peristiwa TurnStatusReceived yang berkorelasi dengan pengidentifikasi interaksi ini.

send_activity_async

Secara asinkron mengirim aktivitas ke dialog pendukung, lihat detail deskripsi di send_activity

send_activity_async(activity: str) -> ResultFuture

Parameter

Nama	Deskripsi
activity Diperlukan	payload berseri aktivitas yang akan dikirim.

Mengembalikan

Jenis	Deskripsi
	Masa depan yang berisi nilai hasil operasi pengiriman aktivitas asinkron.

start_keyword_recognition

Secara sinkron memulai interaksi ucapan ke teks dengan konektor ini menggunakan kata kunci. Interaksi ini akan menggunakan model kata kunci yang disediakan untuk mendengarkan kata kunci tanpa batas waktu, di mana audio tidak dikirim ke layanan ucapan dan semua pemrosesan dilakukan secara lokal. Ketika kata kunci dikenali, DialogServiceConnector akan secara otomatis terhubung ke layanan ucapan dan mulai mengirim data audio tepat sebelum kata kunci seolah-olah listen_once_async dipanggil. Saat diterima, hasil ucapan ke teks dapat diproses oleh penangan hasil yang disediakan atau diambil melalui langganan ke peristiwa yang dikenali. Hasil ucapan ke teks yang dihasilkan oleh operasi ini juga disediakan untuk implementasi dialog yang dikonfigurasi dan sistem dialog tersebut dapat menghasilkan sejumlah payload aktivitas sebagai respons terhadap interaksi ucapan. Interaksi ucapan dapat berkorelasi dengan aktivitas melalui data khusus dialog dalam payload aktivitas.

Panggil stop_keyword_recognition_async untuk menghentikan pengenalan yang dimulai kata kunci.

start_keyword_recognition(model: KeywordRecognitionModel)

Parameter

Nama	Deskripsi
model Diperlukan	model pengenalan kata kunci yang menentukan kata kunci yang akan dikenali.

start_keyword_recognition_async

Secara asinkron mengonfigurasi konektor layanan dialog dengan model kata kunci yang diberikan. Setelah memanggil metode ini, konektor mendengarkan kata kunci untuk memulai pengenalan. Panggil stop_keyword_recognition_async untuk menghentikan pengenalan yang dimulai kata kunci.

Lihat start_keyword_recognition untuk deskripsi terperinci tentang fungsionalitas.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parameter

Nama	Deskripsi
model Diperlukan	model pengenalan kata kunci yang menentukan kata kunci yang akan dikenali.

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi setelah pengenalan diinisialisasi.

stop_keyword_recognition

Secara sinkron menghentikan pengenalan yang dimulai kata kunci.

stop_keyword_recognition()

stop_keyword_recognition_async

Secara asinkron menghentikan pengenalan yang dimulai kata kunci.

stop_keyword_recognition_async()

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi setelah pengenalan dihentikan.

stop_listening

Meminta penghentian segera ke operasi mendengarkan aktif apa pun. Ini dapat mengganggu interaksi ucapan ke teks yang sedang berlangsung dan hasil ucapan ke teks apa pun yang diterima dapat mewakili input ucapan yang tidak lengkap.

Metode sinkron tidak boleh dipanggil saat menangani peristiwa. Gunakan stop_listening_async jika penghentian diinginkan sebagai respons terhadap suatu peristiwa.

stop_listening()

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi setelah mendengarkan dihentikan.

stop_listening_async

Meminta penghentian segera ke operasi mendengarkan aktif apa pun. Ini dapat mengganggu interaksi ucapan ke teks yang sedang berlangsung dan hasil ucapan ke teks apa pun yang diterima dapat mewakili input ucapan yang tidak lengkap.

stop_listening_async()

Mengembalikan

Jenis	Deskripsi
	Masa depan yang terpenuhi setelah mendengarkan dihentikan.

Atribut

activity_received

Menandakan bahwa aktivitas diterima dari backend.

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan ActivityReceivedEventArgs, instans sebagai argumen tunggal, tergantung pada jenis pengenal.

authorization_token

Token otorisasi yang akan digunakan 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 baru yang valid. Jika tidak, pengenal akan mengalami kesalahan selama pengenalan.

canceled

Sinyal untuk peristiwa yang berisi hasil pengenalan yang dibatalkan (menunjukkan upaya pengenalan yang dibatalkan sebagai akibatnya atau permintaan pembatalan langsung atau, atau, sebagai alternatif, kegagalan transportasi atau protokol).

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan SpeechRecognitionCanceledEventArgs, instans sebagai argumen tunggal.

recognized

Sinyal untuk peristiwa yang berisi hasil pengenalan akhir (menunjukkan upaya pengenalan yang berhasil).

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan SpeechRecognitionEventArgs, instans sebagai argumen tunggal, tergantung pada jenis pengenal.

recognizing

Sinyal untuk peristiwa yang berisi hasil pengenalan menengah.

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan SpeechRecognitionEventArgs, instans sebagai argumen tunggal.

session_started

Sinyal untuk peristiwa yang menunjukkan dimulainya sesi pengenalan (operasi).

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan SessionEventArgs instans sebagai argumen tunggal.

session_stopped

Sinyal untuk peristiwa yang menunjukkan akhir sesi pengenalan (operasi).

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan SessionEventArgs instans sebagai argumen tunggal.

speech_activity_template

Mendapatkan templat JSON yang akan disediakan untuk layanan ucapan untuk percakapan berikutnya. Layanan akan mencoba menggabungkan templat ini ke dalam semua aktivitas yang dikirim ke backend dialog, apakah berasal dari klien dengan SendActivityAsync atau dihasilkan oleh layanan, seperti halnya dengan hasil ucapan ke teks.

speech_end_detected

Sinyal untuk peristiwa yang menunjukkan akhir ucapan.

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan RecognitionEventArgs instans sebagai argumen tunggal.

speech_start_detected

Sinyal untuk peristiwa yang menunjukkan awal ucapan.

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan RecognitionEventArgs instans sebagai argumen tunggal.

turn_status_received

Menandakan bahwa pembaruan status giliran diterima dari backend.

Panggilan balik yang terhubung ke sinyal ini dipanggil dengan TurnStatusReceivedEventArgs, instans sebagai argumen tunggal.