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
  • LevelOfDetail:Enum.ModelLevelOfDetail
    Keamanan Plugin
    Baca Paralel

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

  • ModelStreamingMode:Enum.ModelStreamingMode
    Baca Paralel

    Mengontrol perilaku streaming model di Models ketika streaming instansi diaktifkan.

  • PrimaryPart:BasePart
    Baca Paralel

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

  • Scale:number
    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.

  • WorldPivot:CFrame
    Tidak Direplikasi
    Baca Paralel

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

Properti diwarisi dari PVInstance
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

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.

  • GetBoundingBox():Tuple

    Kembalikan deskripsi volume yang berisi semua bagian dari Model.

  • GetExtentsSize():Vector3

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

  • GetPersistentPlayers():Instances

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

  • GetScale():number

    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
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Properti

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Metode

BindToMessage

RBXScriptConnection
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

RBXScriptConnection

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

BindToMessageParallel

RBXScriptConnection
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

RBXScriptConnection

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

()
Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance
Lihat semua yang diwarisi dari Object