3D ドラッグディテクター

Class.DragDetector インスタンスは、ドアや引き出しを開くなど、エクスペリエンスで 3D オブジェクトとの交流を容易にし、促進します。キー機能には、Class.DragDetector を含みます：

• Class.DragDetector を任意の BasePart または Model の下に配置し、すべての入力 (マウス、タッチ、ゲームパッド、および VR) でドラッグ可能にするために、コードの行を 1 つも置きません。

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

• スクリプトは、ドラッグオブジェクトの操作に応答して UI をドライブするか、ロジカルな決定を下すために、ドラグオブジェクトを操作するなど、ドラグオブジェクトの操作に応答することができます。

• プレイヤーはアンカー部品やモデルを操作できますが、リリース時に正確に配置した場所に保持されます。

• Class.DragDetector|DragDetectors は Studio で作動し、 選択 、 移動 、0> スケール0>、または DragDetectors3> ツールを使用していない限り、ドラッグ可能なオブジェクトをテストして調整しやすくします。

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

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

1. In the エクスプローラー ウィンドウ, hover over the Part, MeshPart, or 1>Class.Model1> and click the ⊕ button. コンテキストメニューが表示されます。

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

   

3. デフォルトでは、オブジェクトは地上の飛行機にドラッグできますが、DragStyle 、モーションに応答する方法 、およびオプションで軸または移動制限を適用することができます。

ドラッグ検知機をカスタマイズする

ドラッグスタイル

DragDetectors マップカーソルの動きをバーチャルラインと飛行機を計算するために変更します。通過する DragStyle プロパティで、必要に応じて異なるマッピングを選択できます。たとえ

方向をドラッグ

デフォルトでは、3D モーションと関連する DragStyle マップをワールドスペースに。しかし、ReferenceInstance、Orientation

モーションに対応するレポート

Class.DragDetector.ResponseStyle|ResponseStyle プロパティは、オブジェクトが Anchored であるかどうかに応じて、オブジェクトがプロポーションされた動きにどのように返信するかを指定します。

アクスと移動の制限

デフォルトでは、DragStyle の内在する制限を超える 3D モーションには制限がありません。必要に応じて、Class.DragDetector.DragStyle とClass.DragDetector.DragStyle の両方に最小限と最大限を適用できます。ただし、これらは2>制限2>ではありま

許可をドラッグ

プレイヤーが与えられたドラッグディテクターインスタンスとインタラクトする権限は、PermissionPolicy プロパティによって指定されることがあります。これは、デフォルトで Enum.DragDetectorPermissionPolicy.Everybody に設定され、コードサンプルに示すように、スクリプトされた権限コントロー

DragDetector - スクリプトドラッグ権限
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)

物理の応答

ドラガーの レポートスタイル は 物理 に設定され、アンカーオブジェクトに適用されます。そのオブジェクトは、物理 の位置/方向に指定された位置に移動されるように、2>制限フォース2> によって移動されます。5>物理5> のレポートをカスタマイズするには

変更者の入力

レプリケーション

Class.DragDetector.RunLocally|RunLocally プロパティが偽である場合、クライアントは、ドラッグを実行するためにサーバーに送信するデータを生成します。このモードでは、すべてのカスタムイベントシグナルと登録された関数がサーバーに Scripts でなければなりません。

Class.DragDetector.RunLocally|RunLocally プロパティが true の場合、サーバーにイベントはレプリケートされません。すべてのカスタムイベントの信号と登録された関数は、クライアントの LocalScripts にあり、リモートイベント を使用して、必要な変更をサーバーに拡

クリックとドラッグに対するスクリプトのレポート

通過 イベント信号、プロパティの変更、 Scriptable ドラッグスタイル、およびカスタム関数、スクリプトは、ドラッグオブジェクトを操作して 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)

スクリプト式ドラッグスタイル

Class.DragDetector.DragStyle|DragStyle をスクリプト可能に設定すると、 Datatype.Ray を入れて、世界スペースを返す Ray を提供できます。1> スクリプト可能に設定すると、ドラッグオブジェクトがそのカスタム位置/方向に移動するよ

DragDetector - スクリプトドラッグスタイル
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 を適用する前に、カスタムな制限機能を登録して、Class.DragDetector.DragFrame|DragFrame を編集できます。たとえば、 モーションゲー

DragDetector - カスタムコントリント機能
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 = math.floor(SNAP_INCREMENT)
	if snapIncrement < 1 then
		return proposedMotion
	end
	local newWorldPosition = startPartPosition + proposedMotion.Position
	local roundedX = math.floor(newWorldPosition.X / snapIncrement + 0.5) * snapIncrement
	local roundedY = math.floor(newWorldPosition.Y / snapIncrement + 0.5) * snapIncrement
	local roundedZ = math.floor(newWorldPosition.Z / snapIncrement + 0.5) * 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()

使用例

アンカーされていない物理オブジェクト

ドラッグディテクターの基本実装は、プレイヤーが部品を慎重に削除し、タワーを矮小化する必要があるドラッグスタイルゲームです。次のタワー構造では、各部品にデフォルトの Class.DragDetector.DragStyle|DragStyle の Class.DragDetector のドラッグスタイルを持つ子供

調整可能なパーツ付き錠定モデル

メインに固定されているが、プレイヤーがドラッグできる 1つまたは複数の子供部品/モデル があるモデルを簡単に作成し、共有できます。たとえば、次のデスクには 2つの引き出しがあり、プレイヤーが中に何があるかを確認できます。

探知機と制限をドラッグ

Class.DragDetector.DragStyle|DragStyle を使用して、マリオネットのパピオンを検出するためにドラッグディテクターと Class.Constructor|Constraints を組み合わせることができます。次の設定では、コントロールハンドルは��

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

3D ユーザーインターフェイスは、明るさを調整するなど、SpotLight 基にあるドラッグディテクタ

DragDetector - 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)