Muat Metode

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

Deskripsi

Memuat karakter ke dalam koleksiKarakter.

Sintaks

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

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

Komentar

Anda dapat memuat karakter dari subdirektori Agen dengan menentukan jalur relatif (yang tidak menyertakan karakter garis miring titik dua atau terdepan). 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 metode Load.

   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 baik 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 saat Anda ingin memuat file animasi satu per satu dari situs jarak jauh tempat file tersebut diakses menggunakan protokol HTTP.

Bagi. File ACS, menggunakan metode Load menyediakan akses ke animasi karakter. Bagi. File ACF, Anda juga menggunakan metode Get untuk memuat data animasi. Metode Load 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 Load 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 Load dengan pernyataan yang memeriksa status objekPermintaan.

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 tidak lokal; misalnya, menggunakan protokol HTTP, Anda juga dapat memeriksa kegagalan Load dengan menetapkan objekPermintaanke metode Load. Namun, karena metode pemuatan karakter ini ditangani secara asinkron, periksa statusnya di peristiwaRequestComplete. Teknik ini tidak akan berfungsi memuat karakter menggunakan protokol UNC karena metode Load diproses secara sinkron.