Peristiwa Perintah

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

Keterangan

Terjadi ketika pengguna memilih perintah (klien).

Sintaksis

Subagent_Command(ByValUserInput**)**

Bagian

Deskripsi

UserInput

Mengidentifikasi objek Perintah yang dikembalikan oleh server. Properti berikut ini dapat diakses dari objek Perintah: CHARACTERID Nilai string yang mengidentifikasi nama (ID) karakter yang menerima perintah. Nama Nilai string yang mengidentifikasi nama (ID) perintah. Keyakinan Nilai bilangan bulat panjang yang menunjukkan penilaian keyakinan untuk perintah . Suara Nilai string yang mengidentifikasi teks suara untuk perintah . Alt1Name Nilai string yang mengidentifikasi nama perintah terbaik berikutnya (kedua). Alt1Confidence Nilai bilangan bulat panjang yang menunjukkan penilaian keyakinan untuk perintah terbaik (kedua) berikutnya. Alt1Voice Nilai string yang mengidentifikasi teks suara untuk kecocokan perintah alternatif terbaik berikutnya. Alt2Name Nilai string yang mengidentifikasi nama kecocokan perintah terbaik ketiga. Alt2Confidence Bilangan bulat panjang yang mengidentifikasi penilaian keyakinan untuk kecocokan perintah terbaik ketiga. Alt2Voice Nilai string yang mengidentifikasi teks suara untuk kecocokan perintah terbaik ketiga. Hitung Nilai bilangan bulat panjang yang menunjukkan jumlah alternatif yang dikembalikan.

Keterangan

Server memberi tahu Anda dengan peristiwa ini saat aplikasi Anda aktif-input dan pengguna memilih perintah dengan input lisan atau menu pop-up karakter. Peristiwa meneruskan kembali jumlah perintah yang mungkin cocok dalam Hitungan serta nama, penilaian keyakinan, dan teks suara untuk kecocokan tersebut.

Jika input suara memicu peristiwa ini, server mengembalikan string yang mengidentifikasi kecocokan terbaik dalam parameter Nama , dan kecocokan terbaik kedua dan ketiga di Alt1Name dan Alt2Name . String kosong menunjukkan bahwa input tidak cocok dengan perintah apa pun yang ditentukan aplikasi Anda; misalnya, itu bisa menjadi salah satu perintah server yang ditentukan. Jika perintah dicocokkan dengan perintah Agen; misalnya, Sembunyikan, string kosong akan dikembalikan dalam parameter Nama, tetapi Anda masih akan menerima teks yang didengar di parameter Voice.

Anda mungkin mendapatkan nama perintah yang sama yang dikembalikan dalam lebih dari satu entri. Parameter Confidence, Alt1Confidence , dan Alt2Confidence mengembalikan skor relatif, dalam rentang -100 hingga 100, yang dikembalikan oleh mesin pengenalan ucapan untuk setiap kecocokan masing-masing. Parameter Voice, Alt1Voice , dan Alt2Voice mengembalikan teks suara yang cocok dengan mesin pengenalan ucapan untuk setiap alternatif. Jika Count mengembalikan nol (0), server mendeteksi input lisan, tetapi menentukan bahwa tidak ada perintah yang cocok.

Jika input suara bukan sumber untuk perintah, misalnya, jika pengguna memilih perintah dari menu pop-up karakter, server mengembalikan nama (ID) perintah yang dipilih di properti Nama. Ini juga mengembalikan nilai parameter Confidence sebagai 100, dan nilai parameter Voice sebagai string kosong (""). Alt1Name dan Alt2Name juga mengembalikan string kosong. Alt1Confidence dan Alt2Confidence mengembalikan nol (0), dan Alt1Voice dan Alt2Voice mengembalikan string kosong. Hitungan mengembalikan 1.

Catatan

Tidak semua mesin pengenalan ucapan dapat mengembalikan semua nilai untuk semua parameter peristiwa ini. Tanyakan kepada vendor mesin Anda untuk menentukan apakah mesin mendukung antarmuka Microsoft Speech API untuk mengembalikan alternatif dan skor keyakinan.