3D 드래그 감지기

인스턴스는 문 및 서랍 열기, 부품 슬라이드, 볼링 공 잡기 및 던지기, 활 당겨 및 발사, 그리고 훨씬 더 많은 경험에서 3D 개체와의 상호 작용을 용이하게 하고 장려합니다.주요 기능은 다음과 같습니다:

• 모든 입력(마우스, 터치, 게임패드 및 VR)을 통해 드래그할 수 있도록 아래에 또는 를 배치하고, 코드 한 줄도 사용하지 않고 모든 것을 수행합니다.

• 여러 가지 드래그 스타일 중에서 선택하고, 개체가 이동에 어떻게 반응하는지 정의하고, 선택적으로 축 또는 이동 제한을 적용합니다.

• 스크립트는 끌어온 개체의 조작에 응답하여 UI를 드라이브하거나 슬라이딩 벽 스위치 디밸러에 따라 방의 조명 수준을 조정하는 등 논리적인 결정을 내릴 수 있습니다.

• 플레이어는 고정된 부품이나 모델을 조작할 수 있으며, 릴리스 시 배포한 위치에 정확히 유지됩니다.

• 작업실에서 선택, 이동, 크기 조정, 또는 회전 도구를 사용하지 않는 한, Studio에서 편집하는 동안 계속 작업합니다.

개체 끌기 가능 만들기

어떤 부품이나 모델을 드래그할 수 있도록 하려면 직접 하위로 DragDetector를 추가하면 됩니다.

1. 탐색기 창에서 , Part 또는 MeshPart 을 가리키고 Model 버튼을 클릭하십시오. 컨텍스트 메뉴가 표시됩니다.

2. 메뉴에서 드래그 감지기 를 삽입합니다.

   

3. 기본적으로 개체는 이제 지상 평면에서 드래그할 수 있지만, 를 사용자 정의하고, 모션에 어떻게 응답하는지 정의하고, 선택적으로 축이나 이동 제한을 적용할 수 있습니다.

드래그 감지기 사용자 정의

스타일 끌기

DragDetectors 제안된 3D 이동을 계산하기 위해 가상 선과 평면에 커서 이동을 매핑합니다.DragStyle 속성을 통해 요구에 맞게 다양한 매핑 중에서 선택할 수 있습니다.예를 들어, TranslatePlane 은 가상 평면에서 번역을 생성하지만, RotateAxis 는 가상 축에 대한 회전을 생성합니다.

방향 끌기

기본적으로, 3D 이동과 관련된 DragStyle 세계 공간 맵.그러나 드래그 검색기를 조정 가능한 부품이 있는 모델에 빌드할 때 예를 들어 또는 을 변경하려는 경우가 있을 수 있습니다.

모션에 대한 응답

ResponseStyle 속성은 개체가 Anchored인지 여부에 따라 제안된 동작에 대해 개체가 응답하는 방법을 지정합니다.

축 및 이동 제한

기본적으로, 3D 이동에는 DragStyle의 내재적 제한을 넘어서는 제한이 없습니다.필요한 경우 번역과 회전에 최소값과 최대값을 적용할 수 있습니다.그러나 이들은 아니다 제약 조건이며, 단지 제한 내에 머무르기 위해 드래그 검출기의 움직임 생성 시도를 방해합니다.

권한 끌기

플레이어가 지정된 드래그 검출기 인스턴스와 상호작용할 수 있는 권한은 PermissionPolicy 속성으로 지정할 수 있습니다.기본적으로 이것은 Enum.DragDetectorPermissionPolicy.Everybody에 설정되며, 코드 샘플에 표시된 것처럼 스크립트 기반 권한 제어를 지원하도록 변경할 수도 있습니다.

드래그 탐지기 - 스크립트된 드래그 권한
local dragDetector = script.Parent.DragDetector
dragDetector.PermissionPolicy = Enum.DragDetectorPermissionPolicy.Scriptable

dragDetector:SetPermissionPolicyFunction(function(player, part)
	if player and player:GetAttribute("IsInTurn") then
		return true
	elseif part and not part:GetAttribute("IsDraggable") then
		return false
	else
		return true
	end
end)

물리 응답

드래거의 응답 스타일이 물리적으로 설정되고 고정되지 않은 개체에 적용되면, 그 개체는 제안된 동작으로 지정된 위치/방향으로 제약 조건에 의해 이동됩니다.다음 속성을 통해 물리적 응답을 추가로 사용자 지정할 수 있습니다:

모디파이어 입력

일부 DragStyle 모드는 사용자가 다양한 방식으로 끌어온 개체를 조작하기 위해 모디파이어 키/버튼을 길게 누를 수 있습니다.기본적으로 모디파이어는 PC에서 LeftControl, 게임패드에서 ButtonR1, VR에서 ButtonL2입니다.드래그 검색기 인스턴스의 KeyboardModeSwitchKeyCode , GamepadModeSwitchKeyCode 또는 VRSwitchKeyCode 속성을 통해 이러한 모디파이어를 사용자 지정할 수 있습니다.

복제

RunLocally 속성이 거짓일 때(기본값) 클라이언트는 모든 입력을 해석하여 서버에 전송하여 드래그를 수행하는 데이터를 생성합니다.이 모드에서는 모든 사용자 지정 이벤트 신호와 등록된 함수가 서버에 있어야 합니다 Scripts.

RunLocally 속성이 true이면 서버에 이벤트가 복제되지 않습니다.모든 사용자 지정 이벤트 신호와 등록된 함수가 클라이언트에 있어야 하며 리모트 이벤트를 사용하여 서버에 필요한 변경 사항을 전파해야 합니다.

클릭 및 드래그에 대한 스크립트 응답

이벤트 신호, 속성 변경, 드래그 스타일, 사용자 지정 함수를 통해 스크립트는 슬라이딩 벽 스위치 밝기를 조정하여 방의 조명 수준을 조정하거나 UI를 조작하여 논리적인 결정을 내릴 수 있습니다.

이벤트 신호

다음 이벤트 신호를 통해 사용자가 개체를 드래그하기 시작, 계속하고 끝내는 시기를 감지할 수 있습니다.

드래그 탐지기 - 이벤트 신호
local dragDetector = script.Parent.DragDetector

local highlight = Instance.new("Highlight")
highlight.Enabled = false
highlight.Parent = script.Parent

dragDetector.DragStart:Connect(function()
	highlight.Enabled = true
end)

dragDetector.DragContinue:Connect(function()

end)

dragDetector.DragEnd:Connect(function()
	highlight.Enabled = false
end)

프레임 변경 드래그

이벤트 신호 외에도, 검출기의 DragFrame 변경 사항을 직접 모니터링할 수 있습니다

드래그 탐지기 - 드래그프레임 변경
local dragDetector = script.Parent.DragDetector

dragDetector:GetPropertyChangedSignal("DragFrame"):Connect(function()
	local currentDragTranslation = dragDetector.DragFrame.Position
	print(currentDragTranslation)
end)

스크립트 드래그 스타일

탐지기의 를 스크립트 가능 으로 설정하면 세계 공간 을 가져와 반환하는 자체 함수를 제공할 수 있습니다.감지기는 움직임을 이동하여 끌어온 개체가 해당 사용자 지정 위치/방향으로 이동합니다.

드래그 탐지기 - 스크립트된 드래그 스타일
local Workspace = game:GetService("Workspace")

local dragDetector = script.Parent.DragDetector
dragDetector.DragStyle = Enum.DragDetectorDragStyle.Scriptable

local cachedHitPoint = Vector3.zero
local cachedHitNormal = Vector3.yAxis

local function followTheCursor(cursorRay)
	-- 끌어온 개체를 레이캐스트 감지에서 제외
	local raycastParams = RaycastParams.new()
	raycastParams.FilterDescendantsInstances = {dragDetector.Parent}
	raycastParams.FilterType = Enum.RaycastFilterType.Exclude

	local hitPoint = Vector3.zero
	local hitNormal = Vector3.yAxis

	local raycastResult = Workspace:Raycast(cursorRay.Origin, cursorRay.Direction, raycastParams)
	if raycastResult then
		hitPoint = raycastResult.Position
		hitNormal = raycastResult.Normal.Unit
	else
		hitPoint = cachedHitPoint
		hitNormal = cachedHitNormal
	end

	cachedHitPoint = hitPoint
	cachedHitNormal = hitNormal

	local lookDir1 = hitNormal:Cross(Vector3.xAxis)
	local lookDir2 = hitNormal:Cross(Vector3.yAxis)
	local lookDir = if lookDir1.Magnitude > lookDir2.Magnitude then lookDir1.Unit else lookDir2.Unit
	return CFrame.lookAt(hitPoint, hitPoint + lookDir, hitNormal)
end

dragDetector:SetDragStyleFunction(followTheCursor)

사용자 지정 제약 조건 함수

드래그 감지기에는 그리드 및 스냅에 대한 내장 된 규칙이 없지만, 검색기의 기능을 편집하기 위해 사용자 지정 제약 조건을 등록할 수 있습니다. before it is applied.예를 들어, 위치를 그리드 증가량의 배수로 반올림하여 그리드에서 움직임을 유지하거나, 각 조각에 적용되는 움직임 규칙으로 체스 게임을 시뮬레이션할 수 있습니다.

드래그 탐지기 - 사용자 지정 제약 함수
local dragDetector = script.Parent.DragDetector
local startPartPosition = nil

local SNAP_INCREMENT = 4

dragDetector.DragStart:Connect(function()
	startPartPosition = script.Parent.Position
end)

dragDetector.DragEnd:Connect(function()
	startPartPosition = nil
end)

local function snapToWorldGrid(proposedMotion)
	if startPartPosition == nil then
		return proposedMotion
	end
	local snapIncrement = SNAP_INCREMENT // 1
	if snapIncrement < 1 then
		return proposedMotion
	end
	local newWorldPosition = startPartPosition + proposedMotion.Position
	local roundedX = ((newWorldPosition.X / snapIncrement + 0.5) // 1) * snapIncrement
	local roundedY = ((newWorldPosition.Y / snapIncrement + 0.5) // 1) * snapIncrement
	local roundedZ = ((newWorldPosition.Z / snapIncrement + 0.5) // 1) * snapIncrement
	local newRoundedWorldPosition = Vector3.new(roundedX, roundedY, roundedZ)
	return proposedMotion.Rotation + (newRoundedWorldPosition - startPartPosition)
end

local connection = dragDetector:AddConstraintFunction(2, snapToWorldGrid)
-- When applicable, remove the constraint function by invoking connection:Disconnect()

예시 사용법

고정되지 않은 물리적 개체

드래그 검색기의 기본 구현은 플레이어가 조각을 신중하게 제거하고 타워를 세우려고 시도해야 하는 타워 밸런스 게임입니다.다음 타워 구조에서 각 조각에는 기본 의 번역 평면 을 가진 자식이 있으므로 플레이어가 조각을 외부로 당길 수 있지만 위쪽이나 아래쪽으로는 할 수 없습니다.

조정 가능한 부품이 있는 고정된 모델

주로 고정된 모델을 쉽게 만들고 공유할 수 있으며, 플레이어가 끌 수 있는 하나 이상의 자식 부품/모델이 있습니다.예를 들어, 다음 책상에는 플레이어가 열어 내부를 확인할 수 있는 2개의 서랍이 있습니다.

검출기 및 제약 조건 끌기

예를 들어, 마리오네트 인형과 드래그 탐지기를 결합할 수 있습니다. Constraints .다음 설정에서는 컨트롤 핸들이 고정되고, 바디 부품은 고정되지 않으며, 제약 조건이 마리오네트를 함께 유지합니다.TranslateViewPlane의 핸들을 이동하면 마리오네트가 춤을 추고, 개별 신체 부위도 드래그 감지기로 이동할 수 있으며, 모델의 무결성은 유지됩니다.

3D 사용자 인터페이스

3D 사용자 인터페이스는 슬라이딩 스위치 디밸러에 따라 밝기를 조정하여 쉽게 달성할 수 있습니다. SpotLight 기반의 조명 밝기를 조정하여 슬라이딩 스위치 디밸러에 따라 달성할 수 있습니다.또한 X 및 Z 축을 개별적으로 감지하여 3D 사용자 인터페이스의 두 가지 다른 측면을 제어할 수 있습니다, 예를 들어 Size , Speed 및 Color 의 ParticleEmitter .

드래그 탐지기 - 3D 사용자 인터페이스
local model = script.Parent
local slider = model.SliderPart
local originPart = model.OriginPart
local emitter = script.Parent.EmitterPart.ParticleEmitter

local dragDetector = slider.DragDetector
dragDetector.ReferenceInstance = originPart
dragDetector.MinDragTranslation = Vector3.zero
dragDetector.MaxDragTranslation = Vector3.new(10, 0, 10)

local dragRangeX = dragDetector.MaxDragTranslation.X - dragDetector.MinDragTranslation.X
local dragRangeZ = dragDetector.MaxDragTranslation.Z - dragDetector.MinDragTranslation.Z

local MIN_PARTICLE_SIZE = 1
local MAX_PARTICLE_SIZE = 1.5
local MIN_PARTICLE_SPEED = 2.5
local MAX_PARTICLE_SPEED = 5
local COLOR1 = Color3.fromRGB(255, 150, 0)
local COLOR2 = Color3.fromRGB(255, 0, 50)

local function updateParticles(emitter)
	local dragFactorX = (dragDetector.DragFrame.Position.X - dragDetector.MinDragTranslation.X) / dragRangeX
	local dragFactorZ = (dragDetector.DragFrame.Position.Z - dragDetector.MinDragTranslation.Z) / dragRangeZ

	-- 드래그 검출기 X 요소에 따라 입자 크기와 속도 조정
	emitter.Size = NumberSequence.new{
		NumberSequenceKeypoint.new(0, 0),
		NumberSequenceKeypoint.new(0.1, MIN_PARTICLE_SIZE + ((MAX_PARTICLE_SIZE - MIN_PARTICLE_SIZE) * dragFactorX)),
		NumberSequenceKeypoint.new(1, 0)
	}
	local speed = MIN_PARTICLE_SPEED + ((MAX_PARTICLE_SPEED - MIN_PARTICLE_SPEED) * dragFactorX)
	emitter.Speed = NumberRange.new(speed, speed * 1.2)
	-- 드래그 검출기 Z 요소에 따라 입자 색상 조정
	local color = COLOR2:Lerp(COLOR1, dragFactorZ)
	emitter.Color = ColorSequence.new{
		ColorSequenceKeypoint.new(0, color),
		ColorSequenceKeypoint.new(1, color)
	}
end

dragDetector:GetPropertyChangedSignal("DragFrame"):Connect(function()
	updateParticles(emitter)
end)