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 ke thread sendiri menggunakan task.desynchronize() .Ini juga harus berisi instansi yang digunakan oleh skripnya.

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

Rangkuman

Properti

Properti diwarisi dari Model
  • Keamanan Plugin
    Baca Paralel

    Mengatur tingkat rincian pada model untuk pengalaman dengan streaming instansi diaktifkan.

  • Mengontrol perilaku streaming model di Models ketika streaming instansi diaktifkan.

  • Baca Paralel

    Bagian utama dari Model , atau nil jika tidak secara eksplisit atur.

  • Tidak Direplikasi
    Tidak Dapat Ditulis Skripnya
    Baca Paralel

    Properti hanya editor yang digunakan untuk memperluas model di sekitar titik pivotnya. Mengatur properti ini akan memindahkan skala seolah-olah Model/ScaleTo dipanggil di atasnya.

  • Tidak Direplikasi
    Baca Paralel

    Menentukan di mana titik pivot dari yang tidak memiliki set terletak.

Properti diwarisi dari PVInstance

Metode

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

    Atur model ini menjadi permanen untuk pemain yang ditentukan. Model.ModelStreamingMode harus diatur ke PersistentPerPlayer agar perilaku berubah sebagai hasil dari tambahan.

  • Kembalikan deskripsi volume yang berisi semua bagian dari Model.

  • Kembalikan ukuran kotak batas terkecil yang berisi semua BaseParts di dalam Model, sesuai dengan Model.PrimaryPart jika diatur.

  • Kembalikan semua objek Player yang persisten untuk objek model ini.Perilaku bervariasi tergantung pada apakah metode ini dipanggil dari Script atau LocalScript.

  • Kembalikan skala kanonik model, yang defaultnya adalah 1 untuk model yang baru dibuat dan akan berubah saat skalanya diubah melalui Model/ScaleTo .

  • MoveTo(position : Vector3):()

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

  • RemovePersistentPlayer(playerInstance : Player):()

    Membuat model ini tidak lagi permanen untuk pemain yang ditentukan. Model.ModelStreamingMode harus diatur ke PersistentPerPlayer agar perilaku diubah sebagai hasil dari penghapusan.

  • ScaleTo(newScaleFactor : number):()

    Mengatur faktor skala model, menyesuaikan ukuran dan lokasi semua Instans anak sehingga mereka memiliki faktor skala relatif terhadap ukuran dan lokasi awal mereka saat faktor skala adalah 1.

  • TranslateBy(delta : Vector3):()

    Bergeser ke Model dengan offset yang diberikan Vector3 , menyimpan orientasi model.Jika lain BasePart atau Terrain sudah ada di posisi baru maka Model akan tumpang tindih dengan objek yang dikatakan.

Metode diwarisi dari PVInstance

Properti

Metode

BindToMessage

Tulis Paralel

Metode ini digunakan untuk mengikat panggilan balik Luau ke pesan dengan topik yang ditentukan.Ketika pesan dikirim (menggunakan ) ke topik yang ditentukan, panggilan balasan yang disediakan akan dipanggil dalam konteks eksekusi seri .

Beberapa panggilan balik Luau dapat diikat ke aktor tunggal dan bahkan ke topik pesan tunggal.

Catatan: Hanya skrip yang merupakan keturunan Aktor dapat terikat ke pesannya.


local actor = script:GetActor()
-- Cetak pesan ketika pesan salam dikirim ke Aktor
-- skrip ini adalah keturunan dari.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi jenis pesan.

Nilai Default: ""
function: function
Nilai Default: ""

Memberikan nilai

Objek koneksi ini dapat digunakan untuk memutus koneksi panggilan balasan Luau dari menerima pesan.

BindToMessageParallel

Tulis Paralel

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

Beberapa panggilan balik Luau dapat diikat ke aktor tunggal dan bahkan ke topik pesan tunggal.

Catatan: Hanya skrip yang merupakan keturunan Aktor dapat terikat ke pesannya.


local actor = script:GetActor()
-- Cetak pesan ketika pesan salam dikirim ke Aktor
-- skrip ini adalah keturunan dari.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi jenis pesan.

Nilai Default: ""
function: function
Nilai Default: ""

Memberikan nilai

Objek koneksi ini dapat digunakan untuk memutus koneksi panggilan balasan Luau dari menerima pesan.

SendMessage

()
Tulis Paralel

Mengirim pesan ke Aktor. Pesan dikirim secara asinkron, sehingga pengirim tidak akan memblokir atau menyerah saat memanggil metode SendMessage().

Karena Aktor tunggal dapat menerima berbagai jenis pesan, parameter topic digunakan untuk membedakan antara berbagai jenis pesan.

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


-- Anggap `actor` adalah variabel lokal yang merujuk pada instans kejadian
actor:SendMessage("Greeting", "Hello World")

Parameter

topic: string

Topik yang digunakan untuk mengidentifikasi pesan yang dikirim.

Nilai Default: ""
message: Tuple

Isi pesan yang akan dikirim ke Aktor.

Nilai Default: ""

Memberikan nilai

()

Acara