Metode Putar (Fitur Lingkungan Windows Warisan)

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

Deskripsi

Memutar animasi yang ditentukan untuk karakter yang ditentukan.

Sintaks

agen**. Karakter ("CharacterID "). Putar** "AnimationName"

Bagian	Deskripsi
AnimationName	Diperlukan. String yang menentukan nama urutan animasi.

 

Komentar

Nama animasi didefinisikan ketika karakter dikompilasi dengan Editor Karakter Agen Microsoft. Sebelum memutar animasi yang ditentukan, server mencoba memutar animasi Return untuk animasi sebelumnya, jika telah ditetapkan.

Saat mengakses animasi karakter menggunakan protokol file konvensional, Anda cukup menggunakan metode Play yang menentukan nama animasi. Namun, jika Anda menggunakan protokol HTTP untuk mengakses data animasi karakter, gunakan metode Get untuk memuat animasi sebelum memanggil metode Play.

Untuk informasi selengkapnya, lihat metode Dapatkan.

Untuk menyederhanakan sintaksis, Anda dapat mendeklarasikan referensi objek dan mengaturnya untuk mereferensikan objekKarakterdalam koleksi Karakter dan menggunakan referensi sebagai bagian dari pernyataan Play Anda:

   Dim Genie   
   Agent1.Characters.Load "Genie", "https://agent.microsoft.com/characters/v2/genie/genie.acf"

   Set Genie = Agent1.Characters ("Genie")
   
   Genie.Get "state", "Showing"
   Genie.Show

   Genie.Get "animation", "Greet, GreetReturn"
   Genie.Play "Greet"
   Genie.Speak "Hello."

Jika Anda mendeklarasikan referensi objek dan mengaturnya ke metode ini, referensi akan mengembalikan objekPermintaan. Selain itu, jika Anda menentukan animasi yang tidak dimuat atau jika karakter belum berhasil dimuat, server mengatur propertiStatusobjek Permintaan ke "gagal" dengan nomor kesalahan yang sesuai. Namun, jika animasi tidak ada dan data karakter telah berhasil dimuat, server akan menimbulkan kesalahan.

Metode Play tidak membuat karakter terlihat. Jika karakter tidak terlihat, server memutar animasi secara kasat mata, dan mengatur propertiStatusdari objekPermintaan.