Muat Metode

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

Deskripsi

Memuat karakter ke dalam koleksi Karakter .

Sintaks

agen**. Characters.Load "CharacterID",** Provider

Bagian	Deskripsi
CHARACTERID	Wajib diisi. Nilai string yang akan Anda gunakan untuk merujuk ke data karakter yang akan dimuat.
Penyedia	Wajib diisi. Jenis data varian yang harus merupakan salah satu dari berikut ini: Filespec Lokasi file lokal dari file definisi karakter yang ditentukan. URL Alamat HTTP untuk file definisi karakter.

Keterangan

Anda dapat memuat karakter dari subdirektori Agen dengan menentukan jalur relatif (yang tidak menyertakan karakter garis miring atau titik dua di depannya). Ini mengawali jalur dengan direktori karakter Agen (terletak di direktori Windows\msagent yang dilokalkan). Misalnya, menentukan hal berikut akan memuat Genie.acs dari direktori Chars Agen:

   Agent.Character.Load "genie", "genie.acs"

Anda juga dapat menentukan direktori Anda sendiri di direktori Chars Agen.

   Agent.Character.Load "genie", "MyCharacters\genie.acs"

Anda dapat memuat karakter yang saat ini ditetapkan sebagai karakter default pengguna saat ini dengan tidak menyertakan jalur sebagai parameter kedua dari metode Muat .

   Agent.Character.Load "character"

Anda tidak dapat memuat karakter yang sama (karakter yang memiliki GUID yang sama) lebih dari sekali dari satu instans kontrol. Demikian pula, Anda tidak dapat memuat karakter default dan karakter lain secara bersamaan dari satu instans kontrol karena karakter default bisa sama dengan karakter lainnya. Jika Anda mencoba melakukan ini, server akan menimbulkan kesalahan. Namun, Anda dapat membuat instans lain dari kontrol Agen dan memuat karakter yang sama.

Penyedia Data Agen Microsoft mendukung pemuatan data karakter yang disimpan sebagai satu file terstruktur (. ACS) dengan data karakter dan data animasi bersama-sama atau sebagai data karakter terpisah (. ACF) dan animasi (. ACA) file. Gunakan satu terstruktur . File ACS untuk memuat karakter yang disimpan di disk atau jaringan lokal dan diakses menggunakan protokol file konvensional (seperti nama jalur UNC). Gunakan terpisah . ACF dan . File ACA ketika Anda ingin memuat file animasi satu per satu dari situs jarak jauh tempat file tersebut diakses menggunakan protokol HTTP.

Untuk. File ACS, menggunakan metode Muat menyediakan akses ke animasi karakter. Untuk. File ACF, Anda juga menggunakan metode Get untuk memuat data animasi. Metode Muat tidak mendukung pengunduhan . File ACS dari situs HTTP.

Memuat karakter tidak secara otomatis menampilkan karakter. Gunakan metode Tampilkan terlebih dahulu untuk membuat karakter terlihat.

Jika Anda menggunakan metode Muat untuk memuat file karakter yang disimpan di komputer lokal dan panggilan gagal; misalnya, karena file tidak ditemukan, Agen menimbulkan kesalahan. Anda dapat menggunakan dukungan dalam bahasa pemrograman Anda untuk memberikan rutinitas penanganan kesalahan untuk menangkap dan memproses kesalahan.

   Sub Form_Load
      On Error GoTo ErrorHandler
      Agent1.Characters.Load "mychar", "genie.acs"
      ' Successful load
      . . .
      Exit Sub
      ErrorHandler:
      ' Unsuccessful load
      . . .
      Resume Next
   End Sub

Anda juga dapat menangani kesalahan dengan mengatur RaiseRequestErrors ke False, mendeklarasikan objek, dan menetapkan permintaan Muat ke objek tersebut. Kemudian ikuti panggilan Muat dengan pernyataan yang memeriksa status objek Permintaan .

Dim LoadRequest as Object

   Sub Form_Load
      Agent1.RaiseRequestErrors = False
      Set LoadRequest = Agent1.Characters.Load _
         ("mychar", "c:\some directory\some character.acs")
      If LoadRequest.Status Not 0 Then
         ' Unsuccessful load
         . . .
         Exit Sub
      Else 
         ' Successful load
         . . .
   End Sub

Jika Anda memuat karakter yang bukan lokal; misalnya, menggunakan protokol HTTP, Anda juga dapat memeriksa kegagalan Pemuatan dengan menetapkan objek Permintaan ke metode Muat . Namun, karena metode pemuatan karakter ini ditangani secara asinkron, periksa statusnya di peristiwa RequestComplete . Teknik ini tidak akan berfungsi memuat karakter menggunakan protokol UNC karena metode Muat diproses secara sinkron.