Máy dò kéo 3D

Các ví dụ DragDetector giúp dễ dàng và khuyến khích tương tác với các đối tượng 3D trong một trải nghiệm, chẳng hạn như mở cửa và ngăn kéo, kéo một phần xung quanh, nắm lấy và ném một quả bóng bowling, kéo lại và bắn một khẩu súng ngắn, và nhiều hơn nữa.Các tính năng chính bao gồm:

• Đặt một DragDetector dưới bất kỳ BasePart hoặc Model để làm cho nó có thể kéo dài thông qua tất cả các đầu vào (chuột, cảm ứng, gamepad và VR), tất cả mà không có một dòng mã nào.

• Chọn từ một số kiểu kéo , xác định cách mà đối tượng phản ứng với chuyển động , và có thể áp dụng tùy chọn trục hoặc giới hạn di chuyển .

• Các kịch bản có thể phản ứng với sự thao tác của các đối tượng bị kéo để lái UI hoặc đưa ra các quyết định logic, chẳng hạn như điều chỉnh mức độ sáng trong một phòng dựa trên một công tắc chuyển đổi ánh sáng trượt.

• Người chơi có thể thao tác các phần hoặc mô hình được neo và chúng sẽ ở lại chính xác nơi bạn đặt chúng khi phát hành.

• DragDetectors làm việc trong Studio miễn là bạn không sử dụng công cụ Chọn , Di chuyển , Thước đo hoặc Xoay công cụ, làm cho nó dễ dàng hơn để kiểm tra và điều chỉnh các đối tượng có thể kéo được trong khi chỉnh sửa.

Làm cho các đối tượng có thể kéo

Để làm cho bất kỳ phần hoặc mô hình nào có thể kéo, chỉ cần thêm một DragDetector như một con cháu trực tiếp.

1. Trong cửa sổ Explorer, di chuột qua Part, MeshPart hoặc Model và nhấp vào nút ⊕. Một menu ngữ cảnh hiển thị.

2. Từ menu, chèn vào DragDetector .

   

3. Mặc định, vật phẩm bây giờ có thể kéo trên máy bay mặt đất, nhưng bạn có thể tùy chỉnh DragStyle, xác định cách nó phản ứng với chuyển động và có thể áp dụng trục hoặc giới hạn di chuyển tùy chọn.

Tùy chỉnh cảm biến kéo

Kéo phong cách

DragDetectors di chuyển con trỏ bản đồ đến các dòng và kế hoạch ảo để tính toán chuyển động 3D đề xuất.Thông qua thuộc tính DragStyle, bạn có thể chọn từ các bản đồ khác nhau để phù hợp với nhu cầu của bạn.Ví dụ, TranslatePlane sản xuất bản dịch trong một máy bay ảo, trong khi RotateAxis sản xuất sự xoay xung quanh một trục ảo.

Hướng kéo

Mặc định, chuyển động 3D và bản đồ liên quan DragStyle đến không gian thế giới.Tuy nhiên, bạn có thể muốn thay đổi ReferenceInstance , Orientation , hoặc Axis , ví dụ khi xây dựng cảm biến kéo vào mô hình có thể điều chỉnh các bộ phận .

Phản hồi lại chuyển động

Thuộc tính ResponseStyle quy định cách một đối tượng phản hồi lại chuyển động đề xuất, tùy thuộc vào việc đối tượng có phải là Anchored hay không.

Giới hạn trục và chuyển động

Mặc định, không có giới hạn cho chuyển động 3D vượt quá các hạn chế bẩm sinh của DragStyle .Nếu cần, bạn có thể áp dụng giới hạn tối thiểu và tối đa cho cả dịch và xoay.Tuy nhiên, hãy lưu ý rằng chúng là không những hạn chế; chúng chỉ cản trở các nỗ lực của máy phát hiện chuyển động để tạo ra chuyển động nhằm đảm bảo nằm trong giới hạn.

Kéo quyền

Quyền của người chơi để tương tác với một ví dụ cảm biến kéo cụ thể có thể được xác định bởi thuộc tính PermissionPolicy.Nó được đặt thành Enum.DragDetectorPermissionPolicy.Everybody mặc định, và cũng có thể được thay đổi để hỗ trợ kiểm soát quyền được lập trình như được hiển thị trong ví dụ mã.

DragDetector - Quyền kéo được lập trình
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)

Phản ứng vật lý

Giả sử phong cách phản hồi của người kéo được đặt thành Vật lý và nó được áp dụng cho một đối tượng chưa neo, đối tượng đó sẽ được di chuyển bởi các lực siết cố gắng đưa nó đến vị trí/hướng được đưa ra bởi chuyển động đề xuấtBạn có thể tùy chỉnh thêm phản hồi vật lý thông qua các thuộc tính sau:

Nhập biến thể

Một số chế độ DragStyle cho phép người dùng giữ phím/ nút chỉnh sửa để thao tác với đối tượng bị kéo theo nhiều cách khác nhau.Mặc định, chỉnh sửa viên là LeftControl trên PC, ButtonR1 trên gamepad hoặc ButtonL2 trên VR.Bạn có thể tùy chỉnh các modifier này thông qua KeyboardModeSwitchKeyCode , GamepadModeSwitchKeyCode hoặc VRSwitchKeyCode tính chất của ví dụ / trường hợpcảm biến kéo.

Sao lưu

Khi thuộc tính RunLocally giả mạo, khách hàng giải thích tất cả các đầu vào để sản xuất dữ liệu mà nó gửi cho máy chủ để thực hiện kéoTrong chế độ này, tất cả các tín hiệu sự kiện tùy chỉnh và chức năng đã đăng ký phải ở trong máy chủ Scripts .

Khi thuộc tính RunLocally là true, không có sự kiện nào được sao chép lên máy chủ.Tất cả các tín hiệu sự kiện tùy chỉnh và chức năng đã đăng ký phải ở trong khách hàng LocalScripts và bạn phải sử dụng sự kiện từ xa để truyền đạt các thay đổi cần thiết cho máy chủ.

Phản ứng kịch bản đến việc nhấp và kéo

Thông qua các tín hiệu sự kiện , thay đổi tính chất, kiểu kéo, và chức năng tùy chỉnh, các kịch bản có thể đáp ứng sự thay đổi của các đối tượng bị kéo để điều khiển giao diện người dùng hoặc đưa ra các quyết định logic, chẳng hạn như điều chỉnh mức độ sáng trong một phòng dựa trên công tắc chuyển đổi tường trượt.

Tín hiệu sự kiện

Thông qua các tín hiệu sự kiện sau, bạn có thể phát hiện khi người dùng bắt đầu, tiếp tục và kết thúc kéo một đối tượng.

Detector kéo - Tín hiệu sự kiện
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)

Thay đổi khung kéo

Ngoài các tín hiệu sự kiện , bạn có thể theo dõi các thay đổi đến của cảm biến trực tiếp.

DragDetector - Thay đổi DragFrame
local dragDetector = script.Parent.DragDetector

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

Kiểu kéo được lập trình

Nếu bạn đặt chức năng của một cảm biến thành DragStyle để Thể thao , bạn có thể cung cấp chức năng riêng của mình mà nhận Ray và trả về không gian thế giới CFrame .Bộ cảm biến sẽ di chuyển chuyển động để vật phẩm bị kéo đi đến vị trí/hướng tùy chỉnh đó.

DragDetector - Phong cách kéo được lập trình
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)
	-- Bỏ vật phẩm bị kéo ra khỏi việc phát hiện raycast
	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)

Chức năng giới hạn tùy chỉnh

Các máy dò kéo không có các quy tắc chuyển động tích hợp về lưới và ghim, nhưng bạn có thể đăng ký chức năng giới hạn tùy chỉnh để chỉnh sửa cảm biến trước khi nó được áp dụng DragFrame.Ví dụ, bạn có thể giữ chuyển động trên lưới bằng cách làm tròn vị trí thành nhân số của tăng trưởng lưới, hoặc mô phỏng một trò chơi cờ với các quy tắc chuyển động hợp pháp cho mỗi khối.

DragDetector - Chức năng hạn chế tùy chỉnh
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()

Ví dụ sử dụng

Vật lý không neo cố định

Một thực hiện cơ bản của cảm biến kéo là một trò chơi cân bằng tháp mà người chơi phải cẩn thận loại bỏ các khối và cố gắng giữ cho tháp thẳng.Trong cấu trúc tháp tiếp theo, mỗi khối có một đứa con DragDetector với một đứa con mặc định DragStyle của TranslatePlane để người chơi có thể kéo các khối ra ngoài nhưng không lên trên hoặc xuống dưới.

Mô hình neo với các bộ phận có thể điều chỉnh

Bạn có thể dễ dàng tạo và chia sẻ các mô hình được neo chính yếu, nhưng có một hoặc nhiều phần con/mô hình con mà người chơi có thể kéo.Ví dụ, bàn làm việc sau có hai ngăn kéo mà người chơi có thể mở để kiểm tra những gì ở bên trong.

Kéo cảm biến và hạn chế

Bạn có thể kết hợp cảm biến kéo với Constraints , ví dụ như một con rối marionette.Trong cài đặt tiếp theo, các tay cầm điều khiển được neo, các bộ phận cơ thể không neo và các hạn chế giữ nhân vật cùng nhau.Di chuyển các tay cầm với TranslateViewPlane DragStyle làm cho vũ điệu marionette, và các bộ phận cơ thể cá nhân cũng có thể được di chuyển bằng cảm biến kéo, trong khi mô hình vẫn giữ nguyên sự nguyên vẹn.

Giao diện người dùng 3D

Giao diện người dùng 3D dễ dàng đạt được thông qua cảm biến kéo, chẳng hạn như điều chỉnh độ sáng của một SpotLight dựa trên một công tắc chuyển đổi độ mờ.Bạn cũng có thể phát hiện các trục X và Z riêng lẻ để kiểm soát hai khía cạnh khác nhau của giao diện người dùng 3D, chẳng hạn như Size, Speed và Color của một ParticleEmitter .

DragDetector - Giao diện người dùng 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

	-- Điều chỉnh kích thước và tốc độ hạt dựa trên yếu tố X của máy dò kéo
	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)
	-- Chỉnh màu hạt dựa trên yếu tố Z cảm biến kéo
	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)