DragDetector
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
Class.DragDetector インスタンスは、ドアや引き出しを開くなど、エクスペリエンスで 3D オブジェクトとの交流を容易にし、お鼓励します。キー機能には、Key.Feature.Toggle() が含まれます。
複数の DragStyle オプションから選択し、オブジェクトがモーションに応答する方法を ResponseStyle で定義し、オプションでオーディオブリキや移動制限を適用します。
スクリプトは、ドラッグオブジェクトの操作に応答して、UI をドライブするか、理論的な決定を行うために、スライドウォールのスイッチの位置に基づくライトレベルを調整など、ドラッグオブジェクトを操作することができます。
プレイヤーはアンカー部品やモデルを操作できますが、リリース時に正確に配置した場所に保持されます。
Class.DragDetector|DragDetectors は Studio で作動し、 選択 、 移動 、0> スケール0>、または DragDetectors3> ツールを使用していない限り、ドラッグ可能なオブジェクトをテストして調整しやすくします。
詳細と使用例については、3D ドラッグディテクター ガイドを参照してください。
概要
プロパティ
マウスがこの DragDetector の上にあるときにカーソルアイコンを表示するように設定します。
オブジェクトの中央に制限フォースを適用するかどうか。
移動の主軸、参照フレームに対して表現される。
ピボットの CFrame は、ドラッグディテクターの ReferenceInstance に依拸しています。
提案された動作を生成するパラダイム。
ユーザーの入力に応答するかどうか。DragDetector。
ゲームパッドの入力中、セカンダリモーションの modifier Enum.KeyCode を変更します。
キーボードの入力中、セカンダリモーションの modifier Enum.KeyCode を変更します。
Class.DragDetector.MinDragAngle|MinDragAngle と共に、ドラッグディテクターの試みを阻止します。
Class.DragDetector.MinDragTranslation|MinDragTranslation と共に、ドラッグディテクターの試みを阻止します。
オブジェクトが目標に到達するために適用される最大力。
目標に到達するために適用される最大トルク。
Class.DragDetector.MaxDragAngle|MaxDragAngle と共に、ドラッグディテクターの試みを阻止します。
Class.DragDetector.MaxDragTranslation|MaxDragTranslation と共に、ドラッグディテクターの試みを阻止します。
参照フレームに対する YXZ の回転を指定します。
プレイヤーが DragDetector と対話できるパーミッションレベルを制御します。
ドラッグディテクターの参照フレームは CFrame のインスタンスです。
オブジェクトがドラッグディテクターに影響を与えるオブジェクトを移動するために使用されるパラダイム。
より高い値は、オブジェクトが目標に到達するのをより速くにさせます。
ユーザーが DragDetector のリプリケートをサーバーに行くか、特定のクライアントにローカルで残りますか。
動作のセカンダリ軸。
Class.DragDetector.DragStyle|DragStyle が Enum.DragDetectorDragStyle.RotateTrackball である場合、転がりの貢献としてラジアルプルを追加するための乗数。
Class.DragDetector.DragStyle|DragStyle が Enum.DragDetectorDragStyle.RotateTrackball の倍数である場合、ロール回転を合計に追加するためのマルチプライヤー。
VR の入力中、セカンダリモーションの modifier Enum.KeyCode を変更します。
世界スペースに表現された Axis。
世界空間に表現された SecondaryAxis。
マウスがこの ClickDetector または DragDetector の上にあるときにカーソルアイコンを表示します。
プレイヤーがインタラクトできるようにするための最大距離は、ClickDetector または DragDetector です。
方法
提案された動作を変更または制限する機能を追加します。
以下のモーションが表示されている参照 CFrame を返します。
スクリプトから呼び出し、新しいパラメータを使用してドラッグを再起動します。
Class.DragDetector.DragStyle|DragStyle が Enum.DragDetectorDragStyle.Scriptable に設定されている場合にのみ関数を使用します。
Class.DragDetector.Permission Policy|Permission Policy が Enum.DragDetectorPermissionPolicy.Scriptable に設定されている場合にのみ関数を使用します。
イベント
- DragContinue(playerWhoDragged : Player,cursorRay : Ray,viewFrame : CFrame,vrInputFrame : OptionalCoordinateFrame,isModeSwitchKeyDown : bool):RBXScriptSignal
ユーザーが Class.DragDetector.DragStart|DragStart が初期化された後にオブジェクトをドラッグし続けると、ファイアが発生します。
ユーザーがオブジェクトのドラッグを停止すると、ファイアが発動します。
ユーザーがオブジェクトをドラッグし始めると、ファイアが発生します。
プレイヤーが ClickDetector または DragDetector の親とインタラクトしたときにファイアを起動します。
Class.ClickDetector または DragDetector の親がプレイヤーの上にマウスポインタを置くときに発動します。
プレイヤーのカーソルが親の ClickDetector または DragDetector の上に停止すると、ファイアーを起動します。
プレイヤーが ClickDetector または DragDetector のマウスカーソルを右クリックしたときに発動します。
プロパティ
ActivatedCursorIcon
この DragDetector の上にマウスポインタを置くと、カーソルアイコンが表示されます。このプロパティを空の場合は、探知機はデフォルトのアイコンを使用します。
アクティブなカーソルアイコンを変更するには、このプロパティを使用している画像のアセット ID に設定します。
ApplyAtCenterOfMass
[デフォルト] を [ユーザーがクリックするポイント] で適用すると、制限力がオブジェクトの中心に適用されます。[Class.DragDetector.ResponseStyle|ResponseStyle] が [DragDetector.ResponseStyle.Physical] である場合、親オブジェクトがアンカーされていない場合にのみ適用されます。
DragFrame
Class.DragDetector.ReferenceInstance|ReferenceInstance が設定する定されている場合、ピボットのフレームに対する pivot の CFrame は、CFrame のピボットのフレームに対する pivot の 1>Datatype.CFrame1> です。そうでない場合、ピボットのフレームに対する pivot の 4>Datatype.CFrame
GamepadModeSwitchKeyCode
ゲームパッドの入力中、Enum.KeyCode は、ドラッグディテクターの DragStyle との両方のモーションモードを切り替えるための KeyCode です。ドラッグディテクターの 2>Class.DragDetector.DragStyle|DragStyle2> がメインモードとして、ドラッグスタイルの 5>Class.DragDetector.DragStyle5>
KeyboardModeSwitchKeyCode
キーボードの入力中、Enum.KeyCode は、ドラッグディテクターの DragStyle との両方のモーションモードを切り替えるために使用されます。このドラッグディテクターの Class.DragDetector.DragStyle|DragStyle には、主要モードとサブモードの両方のモーションモードが含まれています。
MaxDragAngle
これが MinDragAngle より大きい場合、翻訳はその範囲内にカットされます。
これは制限ではありません； 単に、ドラッグディテクターの試みを制限して、限界内に保つために動作を生成しようとしています。 を参照してAddConstraintFunction() をドラッグに追加します。
Class.DragDetector.DragStyle|DragStyle が Enum.DragDetectorDragStyle.RotateAxis である場合にのみ関連します。
MaxDragTranslation
任意の次元で、これが MinDragTranslation より大きい場合、翻訳はその範囲内にカットされます。
これは制限ではありません； 単に、ドラッグディテクターの試みを制限して、限界内に保つために動作を生成しようとしています。 を参照してAddConstraintFunction() をドラッグに追加します。
MaxForce
オブジェクトが目標に到達するために適用される最大の力。 関連するのは、ResponseStyle が Enum.DragDetectorResponseStyle.Physical であり、親オブジェクトがアンカーされていない場合のみです。
MaxTorque
目標に到達するために適用される最大トルク。 関連するのは、ResponseStyle だけで、Enum.DragDetectorResponseStyle.Physical は親オブジェクトではありません。
MinDragAngle
Class.DragDetector.MaxDragAngle|MaxDragAngle 以下の範囲内に翻訳されます。
これは制限ではありません； 単に、ドラッグディテクターの試みを制限して、限界内に保つために動作を生成しようとしています。 を参照してAddConstraintFunction() をドラッグに追加します。
Class.DragDetector.DragStyle|DragStyle が Enum.DragDetectorDragStyle.RotateAxis である場合にのみ関連します。
MinDragTranslation
任意の次元で、MaxDragTranslation より小さい場合、翻訳はその範囲内にクランプされます。
これは制限ではありません； 単に、ドラッグディテクターの試みを制限して、限界内に保つために動作を生成しようとしています。 を参照してAddConstraintFunction() をドラッグに追加します。
Orientation
参照フレームに対する YXZ 回転を指定します (参照フレーム自体のオリエントエリングを変更しません)。 ライニアルな変換と軸回りの回転は、この Y 軸の上のライン X 平面で行われます。この
PermissionPolicy
プレイヤーが DragDetector とインタラクトできるパーミッションレベルを制御します。デフォルトは Enum.DragDetectorPermissionPolicy.Everybody です。
ReferenceInstance
ドラッグディテクターの参照フレームに CFrame があるインスタンス。DragFrame は、CFrame からの呼び出しを受信することができます。2>Class.DragDetector:GetReferenceFrame()|Get Reference Frame2>
このインスタンスが PVInstance である場合、参照フレームはそのピボットになります。Attachment である場合、参照フレームはその世界の CFrame に基づきます。
ResponseStyle
提案された動作が計算され、可能に制限された場合、これは DragDetector に影響を与えるオブジェクトを移動するためのパラダイムです。Enum.DragDetectorResponseStyle オプションは、Class.DragDetector のオプションとして参照されます。
Responsiveness
より高い値は、オブジェクトが目標に到達するのをより速く導きます。関連するのは、ResponseStyle が Enum.DragDetectorResponseStyle.Physical であり、親オブジェクトがアンカーされていない場合のみです。
RunLocally
Class.DragDetector.DragStart|DragStart 、DragContinue 、DragEnd など) をサーバーに送信します。これらは、カーソルレイを処理し、データモデルを変更し、クライアントに再プリケートするサーバーに送信され
[クライアントプロセス] は、クライアントが信号を処理し、サーバーに再プレーしないように自分で処理します。クライアントLocalScripts は、これらのイベントに応答するために使用され、クライアントRemoteEvents は、サーバーにレプリケートする必要がある変更を送信するため
TrackballRadialPullFactor
カーソルがトラックボールの外にあるとき、DragDetector は、ボールがカーソルに向かってロールしようとしているかのように径向きの引き出し回転を適用できます。このプロパティは、DragStyle が
TrackballRollFactor
カーソルがトラックボールの外にあるとき、DragDetector は、ボールをビニールレコードの表示向きにマウントするかのように回転させるロール回転を適用できます。このプロパティは、DragStyle
VRSwitchKeyCode
VR の入力中、Enum.KeyCode は、ドラッグディテクターの DragStyle との両方のモーションモードを切り替えるための KeyCode です。ドラッグディテクターの 2>Class.DragDetector.DragStyle|DragStyle2> がプライマリモードとセカンダリモードの両方をサポートする場合にのみ適用さ
WorldSecondaryAxis
世界スペースに表現された Class.DragDetector.SecondaryAxis|SecondaryAxis は、Class.Attachments|Attachments と同じパラダイムを使用してオリエンテーションを表現します。
方法
AddConstraintFunction
提案された動作を変更または制限する機能を追加します。機能は、CFrame のより提案された動作 の入力を受信し、CFrame のより2> 変更後の動作2> の出力を返
追加の制限関数を削除するには、Disconnect() を返された接続オブジェクトに呼び出します。
パラメータ
このメソッドを介して追加された関数の優先度のオーダー。上の値は、下の値より優先されます。
戻り値
この接続オブジェクトを使用して、制限関数を削除します。
GetReferenceFrame
以下のモーションに対応する参照 CFrame を返します：ReferenceInstance プロパティの詳細は、「Class.DragDetector.ReferenceInstance|ReferencerInstance」を参照してください。
戻り値
RestartDrag
新しいパラメーターを使用してドラッグを再起動するスクリプトから、DragStyle、Axis または SecondaryAxis が変更されるように、ドラッグを再起動できます。
戻り値
SetDragStyleFunction
パスを使用する必要があり、DragStyle が Enum.DragDetectorDragStyle.Scriptable に設定されている場合にのみ使用されます。 与えられた関数
関数が nil を返すと、オブジェクトは移動されません。これは、スクリプトが正しい答えを提供する必要がある場合、または一時的にオブジェクトを保持しておく必要がある場合に便利です。
パラメータ
戻り値
SetPermissionPolicyFunction
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)
パラメータ
戻り値
イベント
DragContinue
ユーザーが Class.DragDetector.DragStart|DragStart が初期化された後にオブジェクトをドラッグし続けると、ファイアが発生します。
パラメータ
VR 入力デバイスを使用している場合、手にカーソル/ポインター/コントローラーを持っている手持ちデバイスの CFrame 。
DragEnd
ユーザーがオブジェクトのドラッグを停止すると、ファイアが発動します。
パラメータ
DragStart
ユーザーがオブジェクトをドラッグし始めると、ファイアが発生します。
パラメータ
ドラッグを開始したカーソルレイキャストのヒットフレーム。
カーソルレイキャストがドラッグを開始した部分。
VR 入力デバイスを使用している場合、手にカーソル/ポインター/コントローラーを持っている手持ちデバイスの CFrame 。