Actor

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir Actor , kendi iş parçasına güvenli bir şekilde bölünebilen kod için bir konteynördür, kullanarak task.desynchronize() .Ayrıca senaryolarını kullandığı instansları da içermelidir.

Senaryo sözleşme imzalamaoptimize etmek için çok sayıda Aktör kullanarak daha fazla bilgi edinmek için, Paralel Luau 'yu görün.

Özet

Özellikler

Şuradan alınan Özellikler: Model
  • Eklenti Güvenliği
    Paralel oku

    Aktif durum yayınıyla deneyimler için modeldeki ayrıntı seviyesini ayarlar.Sets the level of detail on the model for experiences with instance streaming enabled.

  • Instans yayını etkinleştirildiğinde model yayın davranışını Models kontrol eder.

  • Birincil parçası Model , veya nil eğer açıkça ayarla.

  • Çoğaltılmamış
    Betiklenemez
    Paralel oku

    Modelin etrafındaki pivot etrafında ölçeklendirilmesi için yalnızca editör tarafından kullanılan özellik. Bu özelliği ayarlamak, ölçeğin sanki Model/ScaleTo çağrılmış gibi hareket edeceğini değiştirecektir.

  • Çoğaltılmamış
    Paralel oku

    Hangi noktada bir Model döndürme noktasının bulunduğunu belirler bulunmuyor ve bunun bir set Model.PrimaryPart içerdiği yer.

Şuradan alınan Özellikler: PVInstance

Yöntemler

Şuradan alınan Yöntemler: Model
  • AddPersistentPlayer(playerInstance : Player):()

    Bu modeli belirtilen oyuncu için kalıcı olarak ayarlar.Model.ModelStreamingMode davranışın ek sonucu olarak değiştirilmesi için değiştirilmesi gereken davranış PersistentPerPlayer olarak ayarlanmalıdır.

  • Bir Model'in tüm parçalarını içeren bir hacmin açıklamasını döndürür.

  • 'nin tümünü içeren en küçük sınırlayıcı kutunun boyutunu döndürür, eğer ayarlanırsa ile uyumlu olur.

  • Bu model nesnesi için kalıcı olan tüm Player nesnelerini döndürür.Davranış, bu yöntemin bir Script veya bir LocalScript 'dan çağrılıp çağrılmadığına bağlı olarak değişir.

  • Yeni oluşturulan modeller için varsayılan 1'e döner ve Model/ScaleTo aracılığıyla ölçeklendirildiğinde değişecektir.

  • MoveTo(position : Vector3):()

    PrimaryPart ı verilen pozisyona taşır. Birincil bir parça belirtilmediyse, modelin kök parçası kullanılacaktır.

  • RemovePersistentPlayer(playerInstance : Player):()

    Bu modeli belirtilen oyuncu için artık kalıcı olmayan yapar.Model.ModelStreamingMode davranışın kaldırılmasının sonucunda değiştirilmesi için değiştirilmesi gereken davranış için KalıcıOyuncu olarak ayarlanmalıdır.

  • ScaleTo(newScaleFactor : number):()

    Modelin ölçek faktörünü ayarlar, böylece tüm alt örneklerin boyutlandırma ve konumunu ayarlar ve ölçek faktörü 1 olduğunda ilk boyutları ve konumları ile ilgili bu ölçek faktörüne sahip olurlar.

  • TranslateBy(delta : Vector3):()

    Verilen Model ofsetiyle bir Vector3 değiştirir, modelin yönünü koruyarak.Yeni pozisyonda zaten başka bir BasePart veya Terrain varsa, Model o nesneyi üzerine geçecektir.

Şuradan alınan Yöntemler: PVInstance

Özellikler

Yöntemler

BindToMessage

Paralel yaz

Bu yöntem, bir Luau geri aramasını belirtilen konuyla ilgili bir mesaja bağlamak için kullanılır.Bir mesaj gönderildiğinde (SendMessage() kullanarak) belirtilen konuya verilen geri çağrı, bir seri çalışma içinde çağrılacaktır.

Birden fazla Luau geri çağrısı tek bir aktöre ve hatta tek bir mesaj konusuna bağlanabilir.

Not: Yalnızca Aktör'ün soyundan gelen yazılımlar mesajlarına bağlanabilir.


local actor = script:GetActor()
-- Bir selamlama mesajı Aktöre gönderildiğinde bir mesaj basın
-- bu senaryo bir soyundandır.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parametreler

topic: string

mesajtürünü tanımlamak için kullanılan konu.

Varsayılan değer: ""
function: function
Varsayılan değer: ""

Dönüşler

Bu bağlantı nesnesi, Luau geri çağrısının mesaj almasını kesmek için kullanılabilir.

BindToMessageParallel

Paralel yaz

Bu yöntem, bir Luau geri aramasını belirtilen konuyla ilgili bir mesaja bağlamak için kullanılır.Bir mesaj gönderildiğinde (SendMessage() kullanarak) belirtilen konuya verilen geri arama çağrılacak ve sağlanan geri arama paralel bir çalışma içinde çağrılacaktır.

Birden fazla Luau geri çağrısı tek bir aktöre ve hatta tek bir mesaj konusuna bağlanabilir.

Not: Yalnızca Aktör'ün soyundan gelen yazılımlar mesajlarına bağlanabilir.


local actor = script:GetActor()
-- Bir selamlama mesajı Aktöre gönderildiğinde bir mesaj basın
-- bu senaryo bir soyundandır.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)

Parametreler

topic: string

mesajtürünü tanımlamak için kullanılan konu.

Varsayılan değer: ""
function: function
Varsayılan değer: ""

Dönüşler

Bu bağlantı nesnesi, Luau geri çağrısının mesaj almasını kesmek için kullanılabilir.

SendMessage

()
Paralel yaz

Bir Aktöre bir mesaj gönderir. Mesajlar asenkron olarak gönderilir, bu nedenle gönderen SendMessage() yöntemini çağırırken engellemez veya teslim etmez.

Tek bir Aktör farklı türde mesaj alabilir, bu nedenle çeşitli mesaj türleri arasında ayırt etmek için bir topic parametresi kullanılır.

Bir mesajı SendMessage() kullanarak göndermekle ilgili ayrıntılar için BindToMessage() bakın.


-- Varsayın `actor` bir Aktör örneğine referans veren yerel bir durum
actor:SendMessage("Greeting", "Hello World")

Parametreler

topic: string

Gönderilen mesajı tanımlamak için kullanılan konu.

Varsayılan değer: ""
message: Tuple

Aktöre göndermek için mesajın içeriği.

Varsayılan değer: ""

Dönüşler

()

Etkinlikler