Actor

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Sebuah Actor adalah wadah untuk kode yang dapat dibagi dengan aman menjadi threadnya sendiri menggunakan task.desynchronize() . Ini juga harus berisi instans yang digunakan oleh skripnya.

Untuk mempelajari lebih lanjut tentang menggunakan beberapa Aktor untuk mengoptimalkan pelaksanaanskrip, lihat Luau Paralel .

Rangkuman

Properti

Properti diwarisi dari ModelProperti diwarisi dari PVInstance

Metode

Metode diwarisi dari Model
  • AddPersistentPlayer(playerInstance : Player):void

    Tetapkan model ini menjadi persisten untuk pemain yang ditentukan. Model.ModelStreamingMode harus diatur menjadi PersistenPerPemain untuk perilaku berubah sebagai hasil tambahan.

  • Mengembalikan deskripsi volume yang berisi semua bagian dari Model.

  • Mengembalikan ukuran kotak pembatas terkecil yang berisi semua BaseParts dalam Model, diatur dengan Model.PrimaryPart jika diatur.

  • Mengembalikan semua objek Player yang bertahan untuk model objek ini. Perilaku bervariasi tergantung pada apakah metode ini dianggap dari Script atau LocalScript .

  • Mengembalikan skala kanonik model, yang default ke 1 untuk model baru yang dibuat dan akan berubah saat skalanya melalui Model/ScaleTo .

  • MoveTo(position : Vector3):void

    Pindahkan PrimaryPart ke posisi yang diberikan. Jika bagian utama tidak ditentukan, bagian akar model akan digunakan.

  • RemovePersistentPlayer(playerInstance : Player):void

    Membuat model ini tidak lagi bertahan untuk pemain tertentu. Model.ModelStreamingMode harus diatur menjadi PersistentPerPlayer untuk perilaku berubah sebagai hasil dari penghapusan.

  • ScaleTo(newScaleFactor : number):void

    Tetapkan skala faktor model, menyesuaikan ukuran dan lokasi semua Instans yang turun sehingga mereka memiliki skala faktor relatif terhadap ukuran dan lokasi awal mereka ketika skala faktor adalah 1.

  • TranslateBy(delta : Vector3):void

    Bergeser sebuah Model olehOffset yang diberikan Vector3 , menjaga orientasi model. Jika BasePart atau 1> Class.Terrain1> sudah ada di posisi baru maka 4> Class.Model4> akan menggeser objek yang dikatakan.

Metode diwarisi dari PVInstance

Properti

Metode

BindToMessage

Tulis Paralel

Metode ini digunakan untuk menyambungkan panggilan Luau ke pesan dengan topik yang ditentukan. Saat pesan dikirim (menggunakan SendMessage() ) ke topik yang ditentukan, panggilan callback yang disediakan akan dipanggil dalam konteks eksekusi seri.

Beberapa panggilan Luau mungkin dibindakan ke satu aktor dan bahkan topik pesan tunggal.

Catatan: Hanya skrip yang merupakan turunan dari seorang Actor yang dapat menghubungkan ke pesan-pesannya.


local actor = script:GetActor()
-- Cetak pesan saat pesan sapaan dikirim ke Actor
-- skrip ini adalah turunan dari.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi jenis pesan.

function: function

Memberikan nilai

Objek koneksi ini dapat digunakan untuk melepaskan koneksi Luau dari menerima pesan.

BindToMessageParallel

Tulis Paralel

Metode ini digunakan untuk menyambungkan panggilan Luau ke pesan dengan topik yang ditentukan. Saat pesan dikirim (menggunakan SendMessage() ) ke topik yang ditentukan, panggilan callback yang disediakan akan dipanggil dalam konteks eksekusi paralel.

Beberapa panggilan Luau mungkin dibindakan ke satu aktor dan bahkan topik pesan tunggal.

Catatan: Hanya skrip yang merupakan turunan dari seorang Actor yang dapat menghubungkan ke pesan-pesannya.


local actor = script:GetActor()
-- Cetak pesan saat pesan sapaan dikirim ke Actor
-- skrip ini adalah turunan dari.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi jenis pesan.

function: function

Memberikan nilai

Objek koneksi ini dapat digunakan untuk melepaskan koneksi Luau dari menerima pesan.

SendMessage

void
Tulis Paralel

Mengirim pesan ke Actor. Pesan dikirim secara asinkron, jadi pengirim tidak akan memblokir atau menghasilkan saat menelepon metode SendMessage() .

Karena Actor tunggal mungkin menerima berbagai jenis pesan, topic parameter digunakan untuk membedakan antara berbagai jenis pesan.

Lihat BindToMessage() untuk detail tentang menerima pesan yang dikirim menggunakan SendMessage() .


-- Ambil `aktor` adalah variabel lokal yang mengacu pada kejadianActor
actor:SendMessage("Greeting", "Hello World")

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi pesan yang dikirim.

message: Tuple

Konten pesan untuk dikirim ke Actor.


Memberikan nilai

void

Acara