DragDetector

ตั้งไอคอนเคอร์เซอร์ให้แสดงเมื่อเมาส์ถูกเปิดใช้งานบนพ่อของนี้ DragDetectorหากคุณสมบัตินี้ว่างเปล่า เครื่องตรวจจะใช้ไอคอนเริ่มต้น

เพื่อเปลี่ยนไอคอนเคอร์ที่เปิดใช้งานให้ตั้งค่าคุณสมบัตินี้เป็น ID สินทรัพย์ของภาพที่คุณต้องการใช้

เมื่อเท็จ (ค่าเริ่มต้น) แรงข้อจํากัดจะถูกใช้ที่จุดที่ผู้ใช้คลิกเมื่อถูกต้องแรงจะถูกใช้ที่ศูนย์กลางของมวลของวัตถุเกี่ยวข้องเฉพาะถ้า ResponseStyle เป็น Enum.DragDetectorResponseStyle.Physical และวัตถุบิดาไม่ได้ถูกยึด

แกนหลักของการเคลื่อนไหวที่แสดงเป็นเปอร์เซ็นต์เมื่อเทียบกับกรอบอ้างอิงสำหรับ DragStyle ของ Enum.DragDetectorDragStyle.TranslateLine , ทิศทางการแปล; สำหรับ Enum.DragDetectorDragStyle.TranslatePlane , ปกติไปยังแผ่นเคลื่อนที่; สำหรับ Enum.DragDetectorDragStyle.RotateAxis , แกนการหมุน 1Dการเปลี่ยนค่านี้โดยอัตโนมัติจะอัปเดต Orientation และกลับกัน

หากตั้งค่า ReferenceInstance ไว้ ค่า CFrame ของจุดหมุนที่เกี่ยวข้องกับกรอบอ้างอิง; มิฉะนั้นค่า CFrame ของจุดหมุนที่เกี่ยวข้องกับกรอบของมันในตอนเริ่มต้นของการลาก

แนวคิดที่ใช้ในการสร้างการเคลื่อนไหวที่เสนอโดยให้สตรีมของเรย์เคอร์เซอร์ ดู Enum.DragDetectorDragStyle สำหรับตัวเลือก

หากเป็นจริง DragDetector จะตอบสนองต่อการป้อนของผู้ใช้; หากเป็นเท็จ มันจะไม่ทำ

ในระหว่างการใส่เกมแพด ตัว Enum.KeyCode สำหรับการสลับโหมดการเคลื่อนไหวรองใช้ได้เฉพาะถ้าตัวตรวจจับแรงดึงมีโหมดการเคลื่อนที่ทั้งแบบเบื้องต้นและรอง DragStyle

ในระหว่างการใส่ข้อมูลบนแป้นพิมพ์, Enum.KeyCode สำหรับการสลับโหมดการเคลื่อนที่รองใช้ได้เฉพาะถ้าตัวตรวจจับแรงดึงมีโหมดการเคลื่อนที่ทั้งแบบเบื้องต้นและรอง DragStyle

หากมากกว่า MinDragAngle แปลจะถูกจำกัดภายในช่วงนั้น

นี่ไม่ใช่ข้อจำกัด; มันเพียงแค่ขัดขวางความพยายามของเครื่องตรวจจับการเคลื่อนไหวในการสร้างการเคลื่อนไหวเพื่ออยู่ภายในขีดจำกัดดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดที่กําหนดเองให้กับการลาก

เกี่ยวข้องเฉพาะถ้า DragStyle เป็น Enum.DragDetectorDragStyle.RotateAxis

ในมิติใดก็ตาม หากนี้มากกว่า MinDragTranslation แปลจะถูกจำกัดภายในช่วงดังกล่าว

นี่ไม่ใช่ข้อจำกัด; มันเพียงแค่ขัดขวางความพยายามของเครื่องตรวจจับการเคลื่อนไหวในการสร้างการเคลื่อนไหวเพื่ออยู่ภายในขีดจำกัดดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดที่กําหนดเองให้กับการลาก

แรงสูงสุดที่ใช้กับวัตถุเพื่อให้บรรลุเป้าหมาย เฉพาะเมื่อ ResponseStyle เป็น Enum.DragDetectorResponseStyle.Physical และวัตถุบิดาไม่ได้รับการยึด

แรงบิดสูงสุดที่ใช้สำหรับวัตถุเพื่อบรรลุเป้าหมาย เฉพาะเมื่อ ResponseStyle เป็น Enum.DragDetectorResponseStyle.Physical และวัตถุบนพื้นผิวไม่ได้รับการยึด

หากน้อยกว่า MaxDragAngle การแปลจะถูกจำกัดภายในช่วงดังกล่าว

นี่ไม่ใช่ข้อจำกัด; มันเพียงแค่ขัดขวางความพยายามของเครื่องตรวจจับการเคลื่อนไหวในการสร้างการเคลื่อนไหวเพื่ออยู่ภายในขีดจำกัดดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดที่กําหนดเองให้กับการลาก

เกี่ยวข้องเฉพาะถ้า DragStyle เป็น Enum.DragDetectorDragStyle.RotateAxis

ในมิติใดก็ตาม หากน้อยกว่า MaxDragTranslation แปลจะถูกจำกัดภายในช่วงดังกล่าว

นี่ไม่ใช่ข้อจำกัด; มันเพียงแค่ขัดขวางความพยายามของเครื่องตรวจจับการเคลื่อนไหวในการสร้างการเคลื่อนไหวเพื่ออยู่ภายในขีดจำกัดดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดที่กําหนดเองให้กับการลาก

ระบุการหมุน YXZ ของแกนการเคลื่อนที่เมื่อเทียบกับกรอบอ้างอิง (ไม่เปลี่ยนทิศทางของกรอบอ้างอิงเอง)การแปลเชิงเส้นและการหมุนแบบเขวี้ยงจะอยู่บนแกนหมุนเชิงเส้นนี้ Y และการแปลแบบเรียบในแพลน XZ การเปลี่ยนค่านี้โดยอัตโนมัติจะอัปเดต Axis และกลับกัน

ควบคุมระดับสิทธิ์ที่ผู้เล่นสามารถโต้ตอบกับ DragDetector ได้ ค่าเริ่มต้นคือ Enum.DragDetectorPermissionPolicy.Everybody

ตัวอย่างที่ CFrame เป็นกรอบอ้างอิงสำหรับตัวตรวจจับลาก DragFrame ถูกแสดงเป็นสัดส่วนเมื่อเทียบกับ CFrame ซึ่งสามารถดึงได้ผ่านวิธี GetReferenceFrame()

หากตัวอย่างนี้เป็น PVInstance , กรอบอ้างอิงจะเป็นจุดศูนย์กลาง; หากเป็น Attachment , โลกของมันจะเป็น CFrameหากเป็น nil หรือไม่ใช่ทั้งสองอย่างก่อนหน้านี้ กรอบอ้างอิงจะขึ้นอยู่กับจุดศูนย์กลางของแผ่นตรวจจับลาก BasePart หรือ Model ของผู้ปกครอง

เมื่อโมชันที่เสนอได้ถูกคำนวณและจำกัดไว้แล้ว นี่คือแนวคิดที่ใช้เพื่อย้ายหรือไม่ย้ายวัตถุที่ได้รับผลกระทบจาก DragDetectorดู Enum.DragDetectorResponseStyle สำหรับตัวเลือก

มูลค่าที่สูงกว่าทำให้วัตถุบรรลุเป้าหมายได้เร็วขึ้น เฉพาะเมื่อ ResponseStyle เป็น Enum.DragDetectorResponseStyle.Physical และวัตถุรากไม่ได้ถูกยึดถือ

หากเป็นเท็จ (เริ่มต้น) ไคลเอนต์จะส่งสัญญาณที่ซ้ำกัน ( DragStart , DragContinue , DragEnd ) ไปยังเซิร์ฟเวอร์ที่ประมวลผลเคอร์เซอร์และทำการเปลี่ยนแปลงในโมเดลข้อมูลและส่งต่อไปยังไคลเอนต์

หากเป็นจริง ไคลเอนต์จะประมวลผลสัญญาณเหล่านั้นด้วยตัวเองและไม่ทำซ้ำให้กับเซิร์ฟเวอร์ไคลเอนต์ LocalScripts อาจใช้เพื่อตอบสนองต่อเหตุการณ์เหล่านี้และ RemoteEvents อาจใช้เพื่อส่งการเปลี่ยนแปลงใดๆ ที่เกิดขึ้นที่ควรจะถูกส่งไปยังเซิร์ฟเวอร์

แกนรองของการเคลื่อนไหว เกี่ยวข้องกับการจัดตำแหน่งโดยใช้แนวคิดเดียวกับ Attachments

เมื่อเคอร์เซอร์อยู่นอกเทร็คบอล ตัว DragDetector สามารถใช้การหมุนแบบรัศมีที่หมุนลูกบอลให้เหมือนกับว่ากำลังพยายามที่จะกลิ้งออกไปในทิศทางของเคอร์เซอร์คุณสมบัตินี้เป็นตัวคูณ 0 ถึง 1 สำหรับการเพิ่มการหมุนนั้นเป็นการบริจาคให้กับทั้งหมดเกี่ยวข้องเฉพาะถ้า DragStyle เป็น Enum.DragDetectorDragStyle.RotateTrackball

เมื่อเคอร์เซอร์อยู่นอกเนื้อบอลล์แล้ว DragDetector สามารถใช้การหมุนกลิ้งที่เปลี่ยนลูกบอลให้เหมือนว่าติดตั้งบนบันทึกไวนิลที่เผื่อนหน้าผู้ดูคุณสมบัตินี้เป็นตัวคูณ 0 ถึง 1 สำหรับการเพิ่มการหมุนแบบม้วนนั้นให้กับทั้งหมดเกี่ยวข้องเฉพาะถ้า DragStyle เป็น Enum.DragDetectorDragStyle.RotateTrackball

ในระหว่างการป้อน VR ตัว Enum.KeyCode สำหรับการสลับโหมดการเคลื่อนไหวรองใช้ได้เฉพาะถ้าตัวตรวจจับแรงดึงมีโหมดการเคลื่อนที่ทั้งแบบเบื้องต้นและรอง DragStyle

The Axis ที่แสดงในพื้นที่โลก เกี่ยวข้องกับการจัดตำแหน่งโดยใช้แนวคิดเดียวกับ Attachments

The SecondaryAxis ที่แสดงในพื้นที่โลก เกี่ยวข้องกับการจัดตำแหน่งโดยใช้แนวคิดเดียวกับ Attachments

เพิ่มฟังก์ชันเพื่อแก้ไขหรือจำกัดการเคลื่อนไหวที่เสนอฟังก์ชันใช้การใส่ CFrame ของ โมชันที่เสนอ และส่งคืน CFrame ของ โมชันที่แก้ไขแล้ว หรือไม่ได้แก้ไขโมชันทั้งการใส่และการออกมีการแสดงเป็นสัดส่วนเมื่อเทียบกับกรอบอ้างอิงคุณสามารถเพิ่มฟังก์ชันหลายอย่างซึ่งจะถูกเรียกตามลําดับโดย priority โดยส่งผลลัพธ์ไปตามลําดับในลูกโซ่

เพื่อลบฟังก์ชันข้อจํากัดที่เพิ่มเข้ามา โทร Disconnect() ที่วัตถุเชื่อมต่อที่คืนกลับ

พารามิเตอร์

ส่งค่ากลับ

คืนอ้างอิง CFrame ในซึ่งการเคลื่อนไหวถูกแสดงออก; ดูคุณสมบัติ ReferenceInstance สำหรับรายละเอียดเพิ่มเติม

ส่งค่ากลับ

อาจถูกเรียกจากสคริปต์เพื่อรีสตาร์ทการลากโดยใช้พารามิเตอร์ใหม่หากพารามิเตอร์เช่น DragStyle , Axis หรือ SecondaryAxis เปลี่ยนแปลง

ส่งค่ากลับ

ส่งฟังก์ชันที่จะใช้หากและเฉพาะหาก DragStyle ถูกตั้งค่าเป็น Enum.DragDetectorDragStyle.Scriptableฟังก์ชันที่กำหนดจะเรียกเมื่อตอบสนองต่อสัญญาณ DragContinue จะได้รับเรย์เคอร์เวิลด์พื้นที่สัญญาณด้วยประเภท Ray และจะส่งคืนเรย์ที่มีตำแหน่งและทิศทางที่ต้องการของจุดศูนย์กลางในพื้นที่โลก ซึ่งมีประเภท CFrame

หากฟังก์ชัน返回值 nil วัตถุจะไม่ถูกย้ายนี่มีประโยชน์หากสคริปต์ยังไม่ได้รวบรวมข้อมูลทั้งหมดที่ต้องการให้ได้คำตอบที่ถูกต้อง หรือในกรณีชั่วคราวที่คุณต้องการให้วัตถุอยู่ที่เดิม

พารามิเตอร์

ส่งค่ากลับ

ส่งฟังก์ชันที่จะใช้หากและเฉพาะหาก PermissionPolicy ถูกตั้งค่าเป็น Enum.DragDetectorPermissionPolicy.Scriptableฟังก์ชันที่ให้มารับพารามิเตอร์ Player สําหรับการเปิดใช้งาน/ปิดใช้งานเครื่องตรวจจับสําหรับผู้เล่นบางรายนอกจากนี้ยังได้รับพารามิเตอร์ part ที่บ่งบอกถึงการคลิกที่เฉพาะเจาะจง BasePart เช่นส่วนหนึ่งภายในส่วนลากได้ Model ; สิ่งนี้มีประโยชน์สำหรับการเปิดใช้งาน/ปิดใช้งานเครื่องตรวจจับตามค่า Name , Color , HasTag() หรือรายละเอียดอื่นๆ

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)

พารามิเตอร์

ส่งค่ากลับ

เกิดไฟไหม้เมื่อผู้ใช้ดึงวัตถุต่อไปหลังจากที่ DragStart ได้รับการเริ่มต้นแล้ว

พารามิเตอร์

เกิดไฟไหม้เมื่อผู้ใช้หยุดลากวัตถุ

พารามิเตอร์

เกิดไฟไหม้เมื่อผู้ใช้เริ่มลากวัตถุ

พารามิเตอร์