Bagikan melalui

IAgentCharacterEx::Listen

  • Artikel

[Microsoft Agent tidak digunakan lagi pada Windows 7, dan mungkin tidak tersedia dalam versi Windows berikutnya.]

HRESULT Listen(
   long bListen  // listening mode flag
);

Mengaktifkan atau menonaktifkan mode Mendengarkan (input pengenalan ucapan).

  • Mengembalikan S_OK untuk menunjukkan operasi berhasil.

bListen

Bendera mode mendengarkan. Jika parameter ini True, mode Mendengarkan diaktifkan; jika False, mode Mendengarkan dinonaktifkan.

Mengatur metode ini ke True memungkinkan mode Mendengarkan (mengaktifkan pengenalan ucapan) untuk jangka waktu tetap. Meskipun Anda tidak dapat mengatur nilai waktu habis, Anda dapat menonaktifkan mode Mendengarkan sebelum waktu habis berakhir. Selain itu, jika mode Mendengarkan sudah aktif karena Anda (atau klien lain) berhasil mengatur metode ke True sebelum waktu habis berakhir, metode berhasil dan mengatur ulang waktu habis. Namun, jika mode Mendengarkan sudah aktif karena pengguna menekan tombol Mendengarkan, metode berhasil, tetapi waktu habis diabaikan dan mode Mendengarkan berakhir berdasarkan interaksi pengguna dengan tombol Mendengarkan.

Metode ini hanya akan berhasil ketika dipanggil oleh klien input-active. Oleh karena itu, metode akan gagal jika klien Anda bukan klien aktif dari karakter paling atas. Metode ini juga akan gagal jika Anda mencoba mengatur metode ke False dan pengguna menekan tombol Mendengarkan. Ini juga dapat gagal jika tidak ada mesin ucapan yang kompatibel yang cocok dengan pengaturan ID bahasa karakter atau pengguna telah menonaktifkan input ucapan menggunakan lembar properti Agen Microsoft. Namun, metode tidak akan gagal jika perangkat audio sibuk.

Ketika Anda berhasil mengatur metode ini ke True, server memicu peristiwaIAgentNotifySinkEx::ListeningState. Server juga mengirim IAgentNotifySinkEx::ListeningState saat batas waktu mode Mendengarkan selesai atau saat Anda mengatur IAgentCharacterEx::Dengarkan ke False.

Metode ini tidak secara otomatis memanggil IAgentCharacter::StopAll dan memutar animasi status Mendengarkan karakter seperti yang terjadi ketika pengguna menekan tombol Mendengarkan. Ini memungkinkan Anda menggunakan peristiwa IAgentNotifySinkEx::ListeningState untuk menentukan apakah Anda ingin menghentikan animasi saat ini dan memutar animasi yang sesuai. Namun, setelah ucapan pengguna terdeteksi, server secara otomatis memanggil IAgentCharacter::StopAll dan memutar animasi status Pendengaran.

Lihat Juga

IAgentNotifySinkEx::ListeningState, IAgentSpeechInputProperties::GetEnabled