Actor 는 task.desynchronize()를 사용하여 안전하게 자체 스레드로 분할할 수 있는 코드 컨테이너입니다.스크립트에 사용되는 인스턴스도 포함되어야 합니다.
스크립트 이행최적화하기 위해 여러 액터를 사용하는 방법에 대해 자세히 알아보려면 평행 Luau를 참조하십시오.
요약
속성
속성가 Model에서 상속되었습니다인스턴스 스트리밍이 활성화된 경험에 대한 모델의 세부 수준을 설정합니다.
인스턴스 스트리밍이 활성화된 경우 Models에서 모델 스트리밍 행동을 제어합니다.
기본 부분의 Model 또는 nil 명시적으로 설정되지 않은 경우.
편집기에만 사용되는 속성으로, 피벗 주위에 모델을 확장하는 데 사용됩니다. 이 속성을 설정하면 피벗에서 Model/ScaleTo가 호출된 것처럼 규모가 이동됩니다.
어떤 Model 가 가지고 있지 않은 피벗의 위치를 결정합니다. where the pivot of a which does not have a set Model.PrimaryPart 는.
메서드
Luau 콜백을 지정된 주제의 메시지에 바인딩합니다.
Luau 콜백을 지정된 주제의 메시지에 바인딩합니다.
액터에게 메시지를 보냅니다.
지정된 플레이어에 대해 이 모델을 영구적으로 유지하도록 설정합니다.Model.ModelStreamingMode 는 추가로 인해 변경된 동작을 위해 PersistentPerPlayer 로 설정해야 합니다.
모델의 모든 부분을 포함하는 볼륨의 설명을 반환합니다.
설정되면 의 모든 것을 포함하는 가장 작은 바인딩 상자의 크기를 반환합니다.Returns the size of the smallest bounding box that contains all of the in the , aligned with the if it is set.
이 모델 개체가 영구적으로 유지하는 모든 Player 개체를 반환합니다.이 메서드가 Script 또는 LocalScript 호출되는지에 따라 동작이 달라집니다.
새로 생성된 모델에 기본값이 1인 모델의 캐논 규모를 반환하며, Model/ScaleTo를 통해 크기가 조정될 때 변경됩니다.
PrimaryPart를 지정된 위치로 이동합니다. 기본 부품이 지정되지 않았으면 모델의 루트 부품이 사용됩니다.
지정된 플레이어에 대해 이 모델을 더 이상 영구적으로 유지하지 않습니다.Model.ModelStreamingMode 는 제거로 인해 변경된 동작을 위해 PersistentPerPlayer 로 설정해야 합니다.
모델의 규모 요소를 설정하여 모든 하위 인스턴스의 크기와 위치를 조정하여 규모 요소가 1일 때 초기 크기와 위치와 관련하여 그 규모 요소가 있도록 합니다.
모델의 방향을 유지하면서 주어진 오프셋 Model에 의해 이동하여 Vector3로 전환합니다.새 위치에 이미 다른 BasePart 또는 Terrain 가 있으면 해당 Model 가 해당 개체를 겹치게 합니다.
PVInstance의 피벗을 가져옵니다.
피벗이 지금 지정된 PVInstance 에 위치하도록 모든 하위 요소 PVInstances 와 함께 변환하여 피벗이 지금 지정된 CFrame 에 위치합니다.
속성
메서드
BindToMessage
이 메서드는 Luau 콜백을 지정된 주제의 메시지에 바인딩하는 데 사용됩니다.메시지가 전송될 때(를 사용하여) 지정된 토픽에 제공된 콜백이 연속 실행 컨텍스트에서 호출됩니다.
여러 Luau 콜백은 단일 액터 또는 단일 메시지 주제에 바인딩될 수 있습니다.
참고: 액터의 후손인 스크립트만 해당 메시지에 바인딩할 수 있습니다.
local actor = script:GetActor()
-- 인사 메시지가 액터에 전송될 때 메시지 출력 메시지 출력 인사 메시지가 액터에 전송될 때 메시지 출력
-- 이 스크립트는 후손입니다.
local connection = actor:BindToMessage("Greeting", function(message)
print("Received Greeting Message:", message)
end)
매개 변수
반환
이 연결 개체는 Luau 콜백이 메시지 수신을 중단하도록 할 수 있습니다.
BindToMessageParallel
이 메서드는 Luau 콜백을 지정된 주제의 메시지에 바인딩하는 데 사용됩니다.메시지가 전송될 때(를 사용하여) 지정된 토픽에 제공된 콜백이 병렬 실행 컨텍스트에서 호출됩니다.
여러 Luau 콜백은 단일 액터 또는 단일 메시지 주제에 바인딩될 수 있습니다.
참고: 액터의 후손인 스크립트만 해당 메시지에 바인딩할 수 있습니다.
local actor = script:GetActor()
-- 인사 메시지가 액터에 전송될 때 메시지 출력 메시지 출력 인사 메시지가 액터에 전송될 때 메시지 출력
-- 이 스크립트는 후손입니다.
local connection = actor:BindToMessageParallel("Greeting", function(message)
print("Received Greeting Message:", message)
end)
매개 변수
반환
이 연결 개체는 Luau 콜백이 메시지 수신을 중단하도록 할 수 있습니다.
SendMessage
액터에 메시지를 보냅니다. 메시지는 비동기적으로 전송되므로 발신자는 SendMessage() 메서드를 호출할 때 차단하거나 양보하지 않습니다.
단일 액터가 다양한 종류의 메시지를 받을 수 있기 때문에, 다양한 종류의 메시지를 구분하기 위해 topic 매개 변수가 사용됩니다.
보내기 메시지를 사용하여 메시지를 받는 방법에 대한 자세한 내용은 를 참조하십시오.