Actor
*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 ModelTetapkan tingkat rincian pada model untuk pengalaman dengan streaming instans.
Mengontrol perilaku streaming model pada Models ketika mode instans Streaming diaktifkan.
Bagian utama dari Model , atau nil jika tidak secara eksplisit atur.
Properti hanya editor digunakan untuk menyesuaikan model di sekitar pivotnya. Mengatur properti ini akan menghubungkan skala seperti Model/ScaleTo yang dipanggil di atasnya.
Menentukan di mana pivot dari Model yang tidak memiliki set Model.PrimaryPart berlokasi.
Metode
Ikat panggilan Luau ke pesan dengan topik yang ditentukan.
Ikat panggilan Luau ke pesan dengan topik yang ditentukan.
Mengirim pesan ke Actor.
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 .
Pindahkan PrimaryPart ke posisi yang diberikan. Jika bagian utama tidak ditentukan, bagian akar model akan digunakan.
Membuat model ini tidak lagi bertahan untuk pemain tertentu. Model.ModelStreamingMode harus diatur menjadi PersistentPerPlayer untuk perilaku berubah sebagai hasil dari penghapusan.
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.
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.
Mendapatkan pivot dari Class.PVInstance .
Mengubah PVInstance bersama dengan semua anaknya PVInstances sehingga pivot sekarang berada di CFrame yang ditentukan.
Properti
Metode
BindToMessage
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
Memberikan nilai
Objek koneksi ini dapat digunakan untuk melepaskan koneksi Luau dari menerima pesan.
BindToMessageParallel
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
Memberikan nilai
Objek koneksi ini dapat digunakan untuk melepaskan koneksi Luau dari menerima pesan.
SendMessage
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 kejadianActoractor:SendMessage("Greeting", "Hello World")
Parameter
Topik yang digunakan untuk mengidentifikasi pesan yang dikirim.
Konten pesan untuk dikirim ke Actor.