DragDetector

Đặt biểu tượng con trỏ để hiển thị khi chuột được kích hoạt trên cha của đối tượng này DragDetector .Nếu thuộc tính này được để trống, máy dò sẽ sử dụng biểu tượng mặc định.

Để thay đổi biểu tượng con trỏ đã kích hoạt, hãy đặt thuộc tính này vào ID tài sản của hình ảnh bạn muốn sử dụng.

Khi false (mặc định), lực hạn chế được áp dụng tại điểm mà người dùng nhấp vào.Khi đúng, lực được áp dụng tại trung tâm khối lượng của đối tượng.Chỉ liên quan nếu ResponseStyle là Enum.DragDetectorResponseStyle.Physical và đối tượng cha không neo.

Trục chính của chuyển động, được biểu hiện so với khung tham chiếu.Đối với một DragStyle của Enum.DragDetectorDragStyle.TranslateLine , hướng dịch; đối với Enum.DragDetectorDragStyle.TranslatePlane , bình thường trên phương tiện di chuyển; đối với Enum.DragDetectorDragStyle.RotateAxis , trục của 1D xoay.Thay đổi giá trị này tự động cập nhật Orientation và ngược lại.

Nếu ReferenceInstance được cài đặt, CFrame của trục quay so với khung tham chiếu; nếu không, CFrame của trục quay so với khung của nó tại đầu cuộc kéo.

Phương pháp được sử dụng để tạo chuyển động đề xuất, dựa trên một dòng các tia con trỏ. Xem Enum.DragDetectorDragStyle đối với các tùy chọn.

Nếu đúng, DragDetector đáp ứng lại nhập của người dùng; nếu sai, nó không làm như vậy.

Trong lúc nhập gamepad, Enum.KeyCode để chuyển đổi chế độ di chuyển thứ cấp.Chỉ áp dụng nếu cảm biến kéo có DragStyle cả chế độ di chuyển chính và thứ cấp.

Trong lúc nhập bàn phím, Enum.KeyCode để chuyển đổi chế độ di chuyển thứ cấp.Chỉ áp dụng nếu cảm biến kéo có DragStyle cả chế độ di chuyển chính và thứ cấp.

Nếu lớn hơn MinDragAngle, bản dịch sẽ bị giới hạn trong phạm vi đó.

Đây không phải là một hạn chế; nó chỉ cản trở các nỗ lực của máy phát hiện chuyển động để tạo ra chuyển động nhằm đảm bảo nằm trong giới hạn.Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một lần kéo.

Chỉ liên quan nếu DragStyle là Enum.DragDetectorDragStyle.RotateAxis.

Ở bất kỳ chiều nào, nếu điều này lớn hơn MinDragTranslation, bản dịch sẽ bị giới hạn trong phạm vi đó.

Đây không phải là một hạn chế; nó chỉ cản trở các nỗ lực của máy phát hiện chuyển động để tạo ra chuyển động nhằm đảm bảo nằm trong giới hạn.Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một lần kéo.

Lực tối đa được áp dụng cho đối tượng để đạt được mục tiêu của nó. Chỉ có ý nghĩa nếu ResponseStyle là Enum.DragDetectorResponseStyle.Physical và đối tượng cha không neo.

Mômen tối đa được áp dụng cho đối tượng để đạt được mục tiêu của nó. Chỉ có ý nghĩa nếu ResponseStyle là Enum.DragDetectorResponseStyle.Physical và đối tượng cha không neo.

Nếu điều này nhỏ hơn MaxDragAngle, bản dịch sẽ bị giới hạn trong phạm vi đó.

Đây không phải là một hạn chế; nó chỉ cản trở các nỗ lực của máy phát hiện chuyển động để tạo ra chuyển động nhằm đảm bảo nằm trong giới hạn.Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một lần kéo.

Chỉ liên quan nếu DragStyle là Enum.DragDetectorDragStyle.RotateAxis.

Ở bất kỳ chiều nào, nếu điều này nhỏ hơn MaxDragTranslation, bản dịch sẽ bị giới hạn trong phạm vi đó.

Đây không phải là một hạn chế; nó chỉ cản trở các nỗ lực của máy phát hiện chuyển động để tạo ra chuyển động nhằm đảm bảo nằm trong giới hạn.Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một lần kéo.

Xác định sự xoay YXZ của trục chuyển động so với khung tham chiếu (không thay đổi hướng của khung tham chiếu chính nó).Dịch chuyển song song và xoay trục sẽ ở trên trục Y này được chuyển hướng lại, và dịch chuyển phẳng trong XZ không gian.Thay đổi giá trị này tự động cập nhật Axis và ngược lại.

Kiểm soát cấp độ quyền cho phép mà người chơi có thể tương tác với DragDetector. Mặc định là Enum.DragDetectorPermissionPolicy.Everybody.

Một ví dụ mà CFrame của nó là khung tham chiếu cho máy phát hiện kéo.The DragFrame được biểu hiện tương quan với cái CFrame này có thể được truy xuất thông qua phương pháp GetReferenceFrame() .

Nếu ví dụ này là một PVInstance , khung tham chiếu sẽ là trung tâm của nó; nếu một Attachment , thế giới của nó sẽ là CFrame .Nếu nó là nil hoặc không phải là trước đó, khung tham chiếu sẽ dựa trên trục của cha của máy phát hiện kéo BasePart hoặc Model .

Một khi động tác được đề xuất đã được tính toán và có thể bị hạn chế, đây là triết lý được sử dụng để di chuyển, hoặc không di chuyển, các đối tượng bị ảnh hưởng bởi DragDetector .Xem Enum.DragDetectorResponseStyle đối với các tùy chọn.

Các giá trị cao hơn khiến đối tượng đạt được mục tiêu của nó nhanh hơn. Chỉ có ý nghĩa nếu ResponseStyle là Enum.DragDetectorResponseStyle.Physical và đối tượng cha không neo.

Nếu sai (mặc định), khách hàng gửi tín hiệu lặp lại (DragStart , DragContinue , DragEnd ) đến máy chủ xử lý con trỏ, thay đổi mô hình dữ liệu và sao chép chúng cho các khách hàng tiếp theo.

Nếu đúng, khách hàng xử lý các tín hiệu này bởi chính nó và không sao chép chúng lên máy chủ.Client có thể được sử dụng để trả lời các sự kiện này và có thể được sử dụng để gửi bất kỳ thay đổi nào có thể được sao chép lên máy chủ.

Trục thứ cấp của chuyển động. Liên quan đến hướng dùng cùng một triết lý như Attachments .

Khi con trỏ nằm ngoài trackball, DragDetector có thể áp dụng một vòng xoay kéo tròn khiến quả bóng như thể nó đang cố gắng cuộn về phía con trỏ.Thuộc tính này là một nhân từ 0 đến 1 để thêm quay như một đóng góp cho tổng.Chỉ liên quan nếu DragStyle là Enum.DragDetectorDragStyle.RotateTrackball.

Khi con trỏ nằm ngoài trackball, DragDetector có thể áp dụng một cuộn quay xoay lăn biến biểu bóng như thể nó được gắn vào một kỷ niệm vinyl hướng về người xem.Thuộc tính này là một nhân từ 0 đến 1 để thêm vòng xoay cuộn vào tổng.Chỉ liên quan nếu DragStyle là Enum.DragDetectorDragStyle.RotateTrackball.

Trong lúc nhập VR, Enum.KeyCode để chuyển đổi chế độ di chuyển thứ cấp.Chỉ áp dụng nếu cảm biến kéo có DragStyle cả chế độ di chuyển chính và thứ cấp.

The Axis được biểu hiện trong không gian thế giới. Liên quan đến hướng dùng cùng một triết lý như Attachments .

The SecondaryAxis được biểu hiện trong không gian thế giới. Liên quan đến hướng dùng cùng một triết lý như Attachments .

Thêm một chức năng để thay đổi hoặc hạn chế chuyển động đề xuất.Chức năng nhận một đầu vào CFrame của đề xuất chuyển động và trả lại một CFrame của chuyển động đã sửa đổi hoặc chưa sửa đổi chuyển động.Cả đầu vào và đầu ra được biểu hiện so với khung tham chiếu.Bạn có thể thêm nhiều chức năng sẽ được gọi theo thứ tự bởi priority , truyền kết quả theo chuỗi.

Để loại bỏ chức năng hạn chế được thêm, gọi Disconnect() trên đối tượng kết nối trả về.

Tham Số

Lợi Nhuận

Trả về tham chiếu CFrame trong đó chuyển động được biểu hiện; xem thêm thuộc tính ReferenceInstance để có thêm chi tiết.

Lợi Nhuận

Có thể được gọi từ một kịch bản để khởi động lại kéo sử dụng các tham số mới, nếu các tham số như DragStyle , Axis hoặc SecondaryAxis thay đổi.

Lợi Nhuận

Chuyển một chức năng để sử dụng nếu và chỉ nếu DragStyle được đặt thành Enum.DragDetectorDragStyle.Scriptable .Chức năng được cung cấp được gọi khi đáp ứng lại một tín hiệu DragContinue , nó nhận được con trỏ ray không gian dấu hiệu với loại Ray , và nó trả lại một CFrame chứa vị trí và hướng mong muốn của trục trong không gian thế giới.

Nếu chức năng trả về nil, đối tượng sẽ không được di chuyển.Điều này hữu ích nếu kịch bản chưa thu thập được tất cả thông tin cần thiết để đưa ra câu trả lời chính xác, hoặc trong các trường hợp tạm thời mà bạn muốn đối tượng ở lại nơi nó ở.

Tham Số

Lợi Nhuận

Chuyển một chức năng để sử dụng nếu và chỉ nếu PermissionPolicy được đặt thành Enum.DragDetectorPermissionPolicy.Scriptable .Chức năng được cung cấp chấp nhận một tham số Player để bật/tắt máy dò cho một người chơi cụ thể.Nó cũng nhận một tham số part để chỉ ra cụ thể BasePart đã được nhấp vào, chẳng hạn như một phần trong một phần có thể kéo Model ; điều này hữu ích để bật/tắt cảm biến dựa trên giá trị Name , Color , HasTag() của phần đó hoặc các chi tiết khác.

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)

Tham Số

Lợi Nhuận

Bắt lửa khi người dùng tiếp tục kéo đối tượng sau khi DragStart đã được khởi động.

Tham Số

Bắt lửa khi người dùng ngừng kéo đối tượng.

Tham Số

Bắt lửa khi người dùng bắt đầu kéo đối tượng.

Tham Số