Metode Bicara

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

Deskripsi

Mengucapkan teks atau file suara yang ditentukan untuk karakter yang ditentukan.

Sintaks

agen**. Karakter ("CharacterID"). Bicara** [Teks], [Url]

Bagian	Deskripsi
Teks	Pilihan. String yang menentukan apa yang dikatakan karakter.
Url	Pilihan. Ekspresi string yang menentukan lokasi file audio (. WAV atau . Format LWV). Lokasi dapat ditentukan sebagai file (termasuk spesifikasi jalur UNC) atau URL (ketika data animasi karakter juga diambil melalui protokol HTTP).

 

Keterangan

Meskipun parameter Teks dan Url bersifat opsional, salah satunya harus disediakan. Untuk menggunakan metode ini dengan karakter yang dikonfigurasi untuk berbicara hanya dalam balon katanya atau menggunakan mesin teks ke ucapan (TTS), cukup berikan parameter Teks . Sertakan spasi antar kata untuk menentukan pemisah kata yang sesuai dalam kata balon, bahkan untuk bahasa yang secara tradisional tidak menyertakan spasi.

Anda juga dapat menyertakan karakter batang vertikal (|) dalam parameter Teks untuk menunjuk string alternatif, sehingga server secara acak memilih string yang berbeda setiap kali memproses metode.

Dukungan karakter output TTS ditentukan ketika karakter dikompilasi menggunakan Editor Karakter Agen Microsoft. Untuk menghasilkan output TTS, mesin TTS yang kompatibel harus sudah diinstal sebelum memanggil metode ini. Untuk informasi selengkapnya, lihat Mengakses Layanan Ucapan.

Jika Anda menggunakan file suara yang direkam (. WAV atau . Output format LWV saja) untuk karakter, tentukan lokasi file di parameter Url . Spesifikasi file ini dapat mencakup jalur lokal (absolut atau relatif) atau konvensi penamaan universal (UNC). Nama file tidak dapat menyertakan karakter apa pun yang tidak disertakan dalam halaman kode AS 1252. Namun, jika Anda menggunakan protokol HTTP untuk mengakses data animasi karakter, gunakan metode Dapatkan untuk memuat animasi sebelum memanggil metode Bicara . Lihat Menggunakan Alat Pengeditan Suara Informasi Linguistik Microsoft untuk informasi tentang materi iklan . File LWV.

Saat menggunakan output file suara yang direkam, Anda masih dapat menggunakan parameter Teks untuk menentukan kata-kata yang muncul di balon kata karakter. Namun, jika Anda menentukan file suara yang ditingkatkan secara linguistik (. LWV) untuk parameter Url dan tidak menentukan teks untuk balon kata, parameter Teks menggunakan teks yang disimpan dalam file.

Anda juga dapat memvariasikan parameter output ucapan dengan tag khusus yang Anda sertakan dalam parameter Teks . Untuk informasi selengkapnya, lihat Tag Output Ucapan Agen Microsoft.

Jika Anda mendeklarasikan referensi objek dan mengaturnya ke metode ini, itu mengembalikan objek Permintaan . Anda dapat menggunakan ini untuk menyinkronkan bagian lain dari kode Anda dengan output lisan karakter, seperti dalam contoh berikut:

   Dim SpeakRequest as Object
...
   Set SpeakRequest = Genie.Speak ("And here it is.")
...
   Sub Agent1_RequestComplete (ByVal Request as Object)
   ' Make certain the request exists
   If SpeakRequest Not Nothing Then
      ' See if it was this request
      If Request = SpeakRequest Then
         ' Display the message box 
         Msgbox "Ta da!"
      End If
   End If
   End Sub

Anda juga dapat menggunakan objek Permintaan untuk memeriksa kondisi kesalahan tertentu. Misalnya, jika Anda menggunakan metode Bicara untuk berbicara dan tidak memiliki mesin TTS yang kompatibel terinstal, server mengatur properti Status objek Permintaan menjadi "gagal" dengan properti Deskripsi ke "Kelas tidak terdaftar" atau "Kesalahan yang dikembalikan tidak diketahui atau objek". Untuk menentukan apakah Anda memiliki mesin TTS yang terinstal, gunakan properti TTSModeID .

Demikian pula, jika Anda memiliki karakter yang mencoba mengucapkan file suara, dan jika file belum dimuat atau ada masalah dengan perangkat audio, server juga mengatur properti Status objek Permintaan menjadi "gagal" dengan nomor kode kesalahan yang sesuai.

Anda juga dapat menyertakan tag ucapan bookmark dalam teks Bicara untuk menyinkronkan kode Anda:

   Dim SpeakRequest as Object
...
   Set SpeakRequest = Genie.Speak ("And here \mrk=100\it is.")
...
   Sub Agent1_Bookmark (ByVal BookmarkID As Long)
   If BookmarkID = 100 Then
      ' Display the message box 
         Msgbox "Tada!"
      End If
   End Sub

Untuk informasi selengkapnya tentang tag ucapan marka buku, lihat Tag Output Ucapan.

Metode Bicara menggunakan tindakan terakhir yang diputar untuk menentukan animasi berbicara mana yang akan diputar. Misalnya, jika Anda mendahului perintah Bicara dengan Putar "GestureRight", server akan memainkan GestureRight dan kemudian animasi berbicara GestureRight . Jika animasi terakhir yang diputar tidak memiliki animasi berbicara, Agen memutar animasi yang ditetapkan ke status Berbicara karakter.

Jika Anda memanggil Bicara dan saluran audio sibuk, output audio karakter tidak akan terdengar, tetapi teks akan ditampilkan dalam kata balon.

Pemecahan kata otomatis agen dalam kata balon memecah kata menggunakan karakter spasi putih (misalnya, Spasi atau Tab). Namun, jika tidak bisa, itu dapat mematahkan kata agar pas dengan balon. Dalam bahasa seperti Jepang, Tionghoa, dan Thailand, di mana spasi tidak digunakan untuk memecah kata, sisipkan karakter spasi lebar nol Unicode (0x200B) di antara karakter untuk menentukan pemisah kata logis.

Catatan

Properti balon kata yang Diaktifkan juga harus True agar teks ditampilkan.

 

Catatan

Atur ID bahasa karakter (dengan mengatur LanguageID karakter sebelum menggunakan metode Bicara untuk memastikan tampilan teks yang sesuai dalam balon kata.

 

Lihat juga

Peristiwa marka buku, peristiwa RequestStart, peristiwa RequestComplete