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 "). Speak** [Text], [Url]

Bagian	Deskripsi
Teks	Fakultatif. String yang menentukan apa yang dikatakan karakter.
Url	Fakultatif. 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).

 

Komentar

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

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

Dukungan karakter output TTS didefinisikan saat 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 konvensi penamaan lokal (absolut atau relatif) atau 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 Text untuk menentukan 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 bervariasi parameter output ucapan dengan tag khusus yang Anda sertakan dalam parameter Text. Untuk informasi selengkapnya, lihat Tag Output Ucapan Agen Microsoft.

Jika Anda mendeklarasikan referensi objek dan mengaturnya ke metode ini, referensi akan mengembalikan objekPermintaan. 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 objekPermintaanuntuk memeriksa kondisi kesalahan tertentu. Misalnya, jika Anda menggunakan metode Bicara untuk berbicara dan tidak memiliki mesin TTS yang kompatibel terinstal, server mengatur properti MintaStatus objek ke "gagal" dengan propertiDeskripsike "Kelas tidak terdaftar" atau "Kesalahan yang tidak diketahui atau dikembalikan objek". Untuk menentukan apakah Anda memiliki mesin TTS yang terinstal, gunakan properti TTSModeID.

Demikian pula, jika Anda memiliki karakter yang mencoba berbicara file suara, dan jika file belum dimuat atau ada masalah dengan perangkat audio, server juga mengatur properti Permintaan objek Status ke "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 bookmark, lihat Tag Output Ucapan.

Metode Speak menggunakan tindakan terakhir yang dimainkan untuk menentukan animasi berbicara mana yang akan diputar. Misalnya, jika Anda mendahului perintah Bicara dengan Play "GestureRight", server akan memainkan GestureRight dan kemudian animasi GestureRight berbicara. 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 didengar, tetapi teks akan ditampilkan dalam balon kata.

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, Cina, dan Thailand, di mana spasi tidak digunakan untuk memecah kata, masukkan karakter spasi lebar nol Unicode (0x200B) di antara karakter untuk menentukan pemisah kata logis.

Nota

Propertiyang diaktifkanbalon kata juga harus True agar teks ditampilkan.

 

Nota

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

 

Lihat Juga

peristiwa Bookmark, peristiwa RequestStartperistiwa , RequestComplete