3D ドラッグ検出器

インスタンスは、ドアや引き出しを開いたり、部品をスライドしたり、ボウリングボールをつかんで投げたり、スリングショットを引っ張って発射したり、さらに多くのことを通じて、エクスペリエンス内の3Dオブジェクトとの相互作用を促進します。主な機能には以下があります：

• 任意の DragDetector または BasePart または Model の下に ドラッグ可能にする すべての入力 (マウス、タッチ、ゲームパッド、および VR) を通じてコード一行もなく配置します。

• 複数の ドラッグスタイル から選択し、オブジェクトがモーションにどのように応答するかを定義し、オプションで 軸または移動制限 を適用します。

• スクリプトは、ドラッグされたオブジェクトの操作に応答して、UIをドライブするか、スライディングウォールスイッチダイマーに基づいて部屋の照明レベルを調整するなど、論理的な決定を下すことができます。

• プレイヤーは固定されたパーツやモデルを操作でき、リリース時に置いた場所に正確に残ります。

• DragDetectors 作業室では、 使用していない限り 、 選択 、 移動 、 スケール 、または 回転 ツールを使用しない限り、編集中にドラッグ可能なオブジェクトをテストし、調整するのが簡単になります。

オブジェクトをドラッグ可能にする

任意のパーツまたはモデルをドラッグ可能にするには、単に DragDetector を直接の子孫として追加します。

1. エクスプローラー ウィンドウで、Part、MeshPart、またはModelをホバーし、⊕ボタンをクリックします。コンテキストメニューが表示됩니다。

2. メニューから、 ドラッグディテクター を挿入します。

   

3. デフォルトでは、オブジェクトは地上平面でドラッグ可能になりますが、DragStyle をカスタマイズして、モーションにどのように応答するか を定義し、オプションで軸または移動制限を適用する ことができます。

ドラッグディテクタをカスタマイズする

スタイルをドラッグ

DragDetectors マップカーソル移動を仮想のラインとプレーンに移動し、提案された 3D 動作を計算します。DragStyle プロパティを通じて、ニーズに合わせて異なるマッピングから選択できます。たとえば、 TranslatePlane は、仮想プレーンで翻訳を生成し、 RotateAxis は、仮想プレーンに関する回転を生成します。

方向をドラッグ

デフォルトでは、3D モーションと関連する DragStyle マップをワールドスペースにマップします。ただし、ドラッグ検出器をビルドするときなど、 、 、または など、例えば調整可能なパーツを持つモデルに変更したい場合があります。

モーションへの応答

ResponseStyle プロパティは、オブジェクトが Anchored かどうかに応じて、提案された動作に対してオブジェクトがどのように応答するかを指定します。

軸と移動制限

デフォルトでは、DragStyle の内在的な制限を超えて 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 プロパティが false (デフォルト) の場合、クライアントはすべての入力を解釈し、サーバーに送信してドラッグを実行するデータを生成します。このモードでは、すべてのカスタムイベントシグナルと登録された機能がサーバー Scripts にある必要があります。

RunLocally プロパティが真になると、サーバーにイベントは複製されません。すべてのカスタムイベントシグナルと登録された機能は、クライアント LocalScripts にある必須であり、サーバーに必要な変更を拡散するには リモートイベント を使用する必要があります。

クリックとドラッグに対するスクリプトの応答

イベントシグナル、プロパティ変更、ドラッグスタイル、カスタム関数を通じて、スクリプトはドラッグされたオブジェクトの操作に応答し、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)

スクリプト化されたドラッグスタイル

検出器の 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()

例の使用

未固定の物理オブジェクト

ドラッグディテクターの基本的な実装は、プレイヤーが注意深くピースを削除し、塔を正しく保つように試みるタワーバランスゲームです。次のタワー構造では、各部品にはデフォルトの で TranslatePlane の子があるので、プレイヤーが部品を外向きに引き出すことができますが、上向きや下向き、または横向きではありません。

調整可能なパーツで固定モデル Anchored models with adjustable parts

主に固定されているが、プレイヤーがドラッグできる子部品/モデルが 1つ以上あるモデルを簡単に作成し、共有できます。たとえば、次のデスクには、プレイヤーが開いて内部を調べることができる2つの引き出しがあります。

検出器と制限をドラッグする

ドラッグ探知器を Constraints と組み合わせることができます、例えばマリオネットのパペットです。次の設定では、コントロールハンドルが固定され、ボディパーツは固定されず、制限がマリオネットを一緒に保持します。ハンドルを TranslateViewPlane で移動し、DragStyle でマリオネットが踊り、個々の身体部位もドラッグディテクターで移動でき、モデルの完全性が維持されます。

3D ユーザーインターフェイス

3D ユーザーインターフェイスは、スライディングスイッチダイマーに基づいて SpotLight の明るさを調整するなどのドラッグ検出器を通じて簡単に達成できます。また、 X と Z 軸を個別に検出して、3Dユーザーインターフェイスの異なる2つの側面を制御できます。例えば、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)