3D 拖動偵測器

實例可以幫助和促進體驗中與 3D 對象的互動，例如打開門和抽屜、滑動部件、抓取和投擲保齡球、拉回並射擊彈弓，以及更多。關鍵功能包括：

• 在任何 DragDetector 或 BasePart 或 Model 下放置一個 使其可拖曳 通過所有輸入（滑鼠、觸摸、遊戲手柄和 VR），而且沒有一行代碼。

• 從多種 拖式 中選擇，定義對象如何回應運動，並可選擇 軸或移動限制 。

• 腳本可以回應拖動物件的操作來驅動用戶介面或做出邏輯決定，例如根據滑動牆開關調整房間的光亮度。

• 玩家可以操縱錨定的零件或模型，並且在發布時保持在你放置它們的位置。

• 在工作室工作，只要你不使用選擇、移動、縮放或旋轉工具，就可以輕鬆測試和調整可拖曳的對象，而編輯時。

讓物件可拖曳

若要讓任何零件或模型可拖曳，只需添加 DragDetector 作為直接後代。

1. 在 檢索器 窗口中，將鼠標懸停在 Part 、 MeshPart 或 Model 上，然後單擊 ⊕ 按鈕。一個上下文菜單顯示。

2. 從選單中插入 拖動偵測器 。

   

3. 預設情況下，對象現在可以在地面平面上拖曳，但您可以自定義其 DragStyle 、定義它如何回應運動，並可選擇應用軸或運動限制。

自訂拖動偵測器

拖式風格

DragDetectors 將鼠標移動轉換為虛擬線和平面，以計算提出的 3D 運動。通過 DragStyle 屬性，您可以從不同的映射中選擇滿足您需求的一個。例如， 翻譯飛機 在虛擬飛機中產生翻譯，而 旋轉軸 在虛擬軸上產生旋轉。

拖動方向

預設情況下，3D運動和相關的DragStyle地圖到世界空間。然而，您可能想要更改 ReferenceInstance , Orientation , 或 Axis , 例如當將拖動偵測器融入 可調整零件的模型 時。

回應動作

ResponseStyle 屬性指定對象如何回應提出的動作，取決於對象是否為 Anchored 或不是。

軸與移動限制

預設情況下， 的內在限制之外沒有任何限制 3D 運動。如有需要，您可以對翻譯和旋轉都適用最小和最大限制。請注意，這些不是 限制 ；它們只是阻止拖動偵測器嘗試產生運動，以便保持在限制內。

拖曳許可

玩家與給定的拖動偵測器實例互動的許可可以由 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 屬性為真時，沒有事件複製到服務伺服器。所有自訂事件訊號和已註冊的功能必須在客戶端 LocalScripts 中，您必須使用 遠端事件 來向服務伺服器傳播必要的變更。

點擊和拖動的腳本回應

通過 事件訊號、屬性變更、Scriptable和自訂函數，腳本可以回應拖動對象的操作來驅動用戶介面或做出邏輯決定，例如基於滑動牆開關調整房間的光等級。

事件信號

透過以下事件訊號，您可以偵測使用者開始、繼續和結束拖曳物件的時間。

拖動偵測器 - 事件訊號
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)

腳本拖式風格

如果您將偵測器的 DragStyle 設為 可執行 ，您可以提供自己的功能，該功能會接收 Ray 並返回世界空間 CFrame 。偵測器會移動運動，使拖曳的對象移至那個特定位置/方向。

拖動偵測器 - 腳本拖動風格
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)

自訂約束功能

拖動偵測器沒有內建運動規則關於網格和捕捉，但您可以註冊自訂約束函數來編輯偵測器的 DragFrame 之前應用。例如，您可以將位置回合到網格增量的倍數來保持網格上的運動，或模擬每個部件的運動規則合法的棋局。

拖動偵測器 - 自訂約束函數
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()

範例使用

未錨定的物理對象

基本實現拖動偵測器的遊戲是一個塔平衡遊戲，玩家必須仔細移除碎片並嘗試保持塔保持垂直。在下一個塔結構中，每個部分都有一個子 DragDetector 與預設 DragStyle 的 翻譯飛機 ，因此玩家可以將部分向外拉出，但不向上或向下。

具有可調整零件的錨定模型

您可以輕鬆創建並分享主要被錨定的模型，但模型上有一個或多個子模型/模型，玩家可以拖曳。例如，下面的桌子有兩個抽屜，玩家可以打開以檢查裡面的東西。

拖動偵測器和限制

您可以將拖動偵測器與 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)