IAgentCharacter::P repare

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

HRESULT Prepare(
   long dwType,     // type of animation data to load
   BSTR bszName,    // name of the animation 
   long bQueue,     // queue the request
   long * pdwReqID  // address of request ID
);

Mengambil data animasi untuk karakter.

• Mengembalikan S_OK untuk menunjukkan operasi berhasil. Saat fungsi kembali, pdwReqID berisi ID permintaan.

dwType

Nilai yang menunjukkan tipe data animasi untuk dimuat yang harus menjadi salah satu dari berikut ini:

Nilai	Deskripsi
const unsigned shortPREPARE_ANIMATION = 0;	Data animasi karakter.
const unsigned shortPREPARE_STATE = 1;	Data status karakter.
const unsigned shortPREPARE_WAVE = 2	File suara karakter (. WAV atau . LWV) untuk output lisan.

bszName

Nama animasi atau status.

Nama animasi didasarkan pada yang ditentukan untuk karakter saat disimpan menggunakan Editor Karakter Agen Microsoft.

Untuk status, nilainya bisa menjadi salah satu hal berikut:

	Deskripsi
"Gesturing"	Untuk mengambil semua animasi status Gesturing .
"GesturingDown"	Untuk mengambil animasi GesturingDown .
"GesturingLeft"	Untuk mengambil animasi GesturingLeft .
"GesturingRight"	Untuk mengambil animasi GesturingRight .
"GesturingUp"	Untuk mengambil animasi GesturingUp .
"Bersembunyi"	Untuk mengambil animasi status Sembunyikan .
"Pendengaran"	Untuk mengambil animasi status Pendengaran .
"Menganggur"	Untuk mengambil semua animasi status Idling .
"IdlingLevel1"	Untuk mengambil semua animasi IdlingLevel1 .
"IdlingLevel2"	Untuk mengambil semua animasi IdlingLevel2 .
"IdlingLevel3"	Untuk mengambil semua animasi IdlingLevel3 .
"Mendengarkan"	Untuk mengambil animasi status Mendengarkan .
"Bergerak"	Untuk mengambil semua animasi status Bergerak .
"MovingDown"	Untuk mengambil semua animasi Bergerak .
"MovingLeft"	Untuk mengambil semua animasi MovingLeft .
"MovingRight"	Untuk mengambil semua animasi MovingRight .
"MovingUp"	Untuk mengambil semua animasi MovingUp .
"Menampilkan"	Untuk mengambil animasi Tampilkan status.
"Berbicara"	Untuk mengambil animasi status Berbicara .

Untuk. File WAV, atur bszName ke URL atau spesifikasi file untuk . File WAV. Jika spesifikasi tidak lengkap, spesifikasi ditafsirkan relatif terhadap spesifikasi yang digunakan dalam metode Muat .

Antrean

Boolean yang menentukan apakah server mengantre permintaan Siapkan . True mengantrekan permintaan dan menyebabkan permintaan animasi apa pun yang mengikutinya menunggu hingga data animasi yang ditentukannya dimuat. False mengambil data animasi secara asinkron.

pdwReqID

Alamat variabel yang menerima ID permintaan Siapkan .

Jika Anda memuat karakter menggunakan protokol HTTP (. File ACF), Anda harus menggunakan metode Siapkan untuk mengambil data animasi sebelum Anda dapat memutar animasi. Anda tidak dapat menggunakan metode ini jika Anda memuat karakter menggunakan protokol UNC (sebuah . File ACS). Anda juga tidak dapat mengambil data HTTP untuk karakter menggunakan Siapkan jika Anda memuat karakter tersebut menggunakan protokol UNC (. File karakter ACS).

Animasi atau data suara yang diambil dengan metode Siapkan disimpan di cache browser. Panggilan berikutnya akan memeriksa cache, dan jika data animasi sudah ada, kontrol memuat data langsung dari cache. Setelah dimuat, animasi atau data suara dapat diputar dengan metode Putar atau Bicara .

Anda dapat menentukan beberapa animasi dan status dengan memisahkannya dengan koma. Namun, Anda tidak dapat mencampur jenis dalam pernyataan Persiapan yang sama.