IAgentCharacter::Speak

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

HRESULT Speak(
   BSTR bszText,    // text to speak
   BSTR bszURL,     // URL of a file to speak
   long * pdwReqID  // address of a request ID
);

Mengucapkan teks atau file suara.

• Mengembalikan S_OK untuk menunjukkan operasi berhasil.

bszText

Teks yang akan diucapkan karakter.

bszURL

URL (atau spesifikasi file) dari file suara yang akan digunakan untuk output lisan. Ini bisa menjadi file suara standar (. WAV) atau file suara yang ditingkatkan secara linguistik (. LWV).

pdwReqID

Alamat variabel yang menerima ID permintaan Bicara .

Untuk menggunakan metode ini dengan karakter yang dikonfigurasi untuk berbicara menggunakan mesin teks ke ucapan (TTS) ; cukup berikan parameter bszText . Anda dapat menyertakan karakter batang vertikal (|) dalam parameter bszText untuk menunjuk string alternatif, sehingga setiap kali server memproses metode, server secara acak memilih string yang berbeda. Dukungan output TTS ditentukan ketika karakter dikompilasi menggunakan Editor Karakter Agen Microsoft.

Jika Anda ingin menggunakan output file suara untuk karakter, tentukan lokasi untuk file dalam parameter bszURL . Saat menggunakan protokol HTTP untuk mengunduh file suara, gunakan metode Siapkan untuk memastikan ketersediaan file sebelum menggunakan metode ini. Anda dapat menggunakan parameter bszText untuk menentukan kata-kata yang muncul di balon kata karakter. Jika Anda menentukan file suara yang ditingkatkan secara linguistik (. LWV) untuk parameter bszURL dan tidak menentukan teks, parameter bszText menggunakan teks yang disimpan dalam file.

Metode Bicara menggunakan animasi terakhir yang diputar untuk menentukan animasi berbicara mana yang akan diputar. Misalnya, jika Anda mendahului perintah Bicara dengan IAgentCharacter::P lay "GestureRight", server akan memutar GestureRight dan kemudian animasi berbicara GestureRight . Jika animasi terakhir yang diputar tidak memiliki animasi berbicara, maka Microsoft Agent 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. Properti balon kata yang Diaktifkan juga harus True agar teks ditampilkan.

Pemecahan kata otomatis Agen Microsoft di kata balon, memecah kata menggunakan karakter spasi putih (misalnya, spasi dan tab). Namun, itu dapat mematahkan kata agar pas dengan balon juga. 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

Atur ID bahasa karakter (menggunakan IAgentCharacterEx::SetLanguageID sebelum menggunakan metode Bicara untuk memastikan tampilan teks yang sesuai dalam balon kata.

 

Lihat juga

IAgentCharacter::P lay, IAgentBalloon::GetEnabled, IAgentCharacter::P repare