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	Wajib diisi. String yang menentukan nama urutan animasi.

 

Keterangan

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

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

Untuk informasi selengkapnya, lihat metode Get .

Untuk menyederhanakan sintaks, Anda dapat mendeklarasikan referensi objek dan mengaturnya untuk mereferensikan objek Karakter dalam koleksi Karakter dan menggunakan referensi sebagai bagian dari pernyataan Putar 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, itu mengembalikan objek Permintaan . Selain itu, jika Anda menentukan animasi yang tidak dimuat atau jika karakter belum berhasil dimuat, server mengatur properti Status objek Permintaan menjadi "gagal" dengan nomor kesalahan yang sesuai. Namun, jika animasi tidak ada dan data karakter telah berhasil dimuat, server menimbulkan kesalahan.

Metode Putar tidak membuat karakter terlihat. Jika karakter tidak terlihat, server memutar animasi secara kasat mata, dan mengatur properti Status objek Permintaan .