InputObject
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Một InputObject đại diện cho một lượt nhập duy nhất của người dùng, chẳng hạn như di chuyển chuột, các cú chạm, lần nhấn phím và nhiều hơn nữa. Nó được tạo ra khi một lượt nhập bắt đầu.
Các thuộc tính của đối tượng này thay đổi tùy thuộc vào UserInputType.Mỗi loại đầu vào sẽ trải qua nhiều thay đổi khác nhau cho UserInputState của nó.Trong suốt cuộc sống của một đầu vào, các thuộc tính khác mô tả thêm về đầu vào có thể thay đổi, chẳng hạn như Position và Delta .Các nút bấm bàn phím và gamepad sẽ có cài đặtchỉ số KeyCode .
Một khi được tạo vào đầu của một đầu vào, cùng một đối tượng tồn tại và được cập nhật cho đến khi đầu vào kết thúc.Kết kết quảlà, bạn có thể theo dõi các thay đổi của đối tượng bằng sự kiện Changed khi người dùng thay đổi nhập vào câu hỏi.Bạn cũng có thể đặt các đối tượng này vào một danh sách các đầu vào hoạt động và tương tác với đối tượng sau khi nó được tạo bởi một sự kiện như UserInputService.InputBegan.Điều này chủ yếu hữu ích cho các sự kiện chạm, vì mỗi điểm chạm sẽ có một đối tượng nhập riêng biệt.
Xem thêm:
- ContextActionService , mà truyền một đối tượng nhập vào chức năng xử lý hành động bound
- UserInputService , sự kiện và chức năng của nó thường sử dụng InputObject
- GuiObject , sự kiện của nó liên quan đến việc nhập của người dùng sử dụng InputObject
Mẫu mã
Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng xử lý nhập lượng từ InputBegan tùy thuộc vào loại của nó.
-- Để sử dụng sự kiện InputBegan, dịch vụ UserInputService phải được sử dụng
local UserInputService = game:GetService("UserInputService")
-- Một chức năng mẫu cung cấp nhiều trường hợp sử dụng cho các loại nhập khác nhau của người dùng
UserInputService.InputBegan:Connect(function(input, gameProcessed)
if input.UserInputType == Enum.UserInputType.Keyboard then
print("A key is being pushed down! Key:", input.KeyCode)
elseif input.UserInputType == Enum.UserInputType.MouseButton1 then
print("The left mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.MouseButton2 then
print("The right mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Touch then
print("A touchscreen input has started at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Gamepad1 then
print("A button is being pressed on a gamepad! Button:", input.KeyCode)
end
if gameProcessed then
print("The game engine internally observed this input!")
else
print("The game engine did not internally observe this input!")
end
end)Tóm Tắt
Thuộc Tính
Một Vector3 mô tả Delta giữa các chuyển động chuột/joystick.
Bao gồm một Enum mô tả loại nhập sử dụng.
Mô tả giá trị vị trí của đầu vào này.
Mô tả trạng thái của một đầu vào đang thực hiện, sau một dòng chảy cụ thể tùy thuộc vào UserInputType.
Mô tả loại đầu vào đang thực hiện (chuột, bàn phím, gamepad, cảm ứng, v.v.).
Phương Pháp
Thuộc Tính
Delta
Một Vector3 mô tả Delta (thay đổi) giữa các chuyển động chuột/joystick.
Điều này hữu ích khi sử dụng với đầu vào position để theo dõi vị trí và chuyển động của con trỏ/joystick của người dùng, chẳng hạn như khi bạn đang tạo chuyển động hoặc kịch bản máy ảnh tùy chỉnh.Xem xét thay đổi đầu vào theo dõi bằng sự kiện Object.Changed hoặc khi người dùng thay đổi đầu vào thông qua các sự kiện như UserInputService.InputChanged và GuiObject.InputChanged .
Lưu ý rằng một InputObject tương ứng với Enum.UserInputType.MouseButton1 (nhấp chuột trái) và Enum.UserInputType.MouseButton2 (nhấp chuột phải) được cung cấp từ một InputBegan lời gọi trả lại sẽ không có được định dạng Delta hoặc Position của nó một khi tạo xong, ngoại trừ khi nhập chuột kết thúc.Để có được cập nhật deltas cho đầu vào chuột, bạn phải thay vào đó tham chiếu một InputObject từ một InputChanged lời gọi trả lại, hoặc gọi GetMouseDelta() .Tuy nhiên, bất kỳ InputObjects phù hợp với các đầu vào chạm sẽ có delta và vị trí được cập nhật mỗi khung trong suốt cuộc sống của chúng.
Xem thêm:
Mẫu mã
Ví dụ này tạo ra một kịch bản nhòm mà giảm lượt nhấp chuột của người chơi FieldOfView() và MouseDeltaSensitivity() khi một người chơi có MouseEnabled() chuột trái còn lại.Tập lệnh cũng chỉ thẳng vào vị trí thế giới của chuột nhấp của người chơi Camera đối với vị trí Vector3 của con trỏ.
Khi người chơi lại nhấp chuột vào máy tính, máy ảnh của người chơi quay trở lại cùng một góc nhìn và với cùng góc nhìn như trước khi người chơi phóng to với kịch bản.
Trong khi người chơi sử dụng ống nhòm, kịch bản khóa chuột của người chơi vào trung tâm của màn hình bằng cách đặt chuột của người chơi thành MouseBehavior() để KhóaTrung tâm.Máy ảnh của người chơi di chuyển khi người chơi di chuyển con trỏ theo thuộc tính InputObject.Delta được truyền bởi InputChanged() chỉ ra sự thay đổi vị trí con trỏ trên màn hình của người chơi theo thuộc tính Vector2.
Để ví dụ này hoạt động như mong đợi, nó nên được đặt trong một LocalScript .
local UserInputService = game:GetService("UserInputService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local character = player.CharacterAdded:Wait()
local head = character:WaitForChild("Head", false)
local mouse = player:GetMouse()
local zoomed = false
local camera = game.Workspace.CurrentCamera
local target = nil
local originalProperties = {
FieldOfView = nil,
_CFrame = nil,
MouseBehavior = nil,
MouseDeltaSensitivity = nil,
}
local AngleX, TargetAngleX = 0, 0
local AngleY, TargetAngleY = 0, 0
-- Đặt lại máy ảnh trở lại CFrame và FieldOfView trước khi phóng to
local function ResetCamera()
target = nil
camera.CameraType = Enum.CameraType.Custom
camera.CFrame = originalProperties._CFrame
camera.FieldOfView = originalProperties.FieldOfView
UserInputService.MouseBehavior = originalProperties.MouseBehavior
UserInputService.MouseDeltaSensitivity = originalProperties.MouseDeltaSensitivity
end
local function ZoomCamera()
-- Cho phép camera được thay đổi bởi kịch bản
camera.CameraType = Enum.CameraType.Scriptable
-- Lưu các thuộc tính máy ảnh trước khi phóng to
originalProperties._CFrame = camera.CFrame
originalProperties.FieldOfView = camera.FieldOfView
originalProperties.MouseBehavior = UserInputService.MouseBehavior
originalProperties.MouseDeltaSensitivity = UserInputService.MouseDeltaSensitivity
-- Máy ảnh zoom
target = mouse.Hit.Position
local eyesight = head.Position
camera.CFrame = CFrame.new(eyesight, target)
camera.Focus = CFrame.new(target)
camera.FieldOfView = 10
-- Khóa và làm chậm con chuột
UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter
UserInputService.MouseDeltaSensitivity = 1
-- Đặt lại góc zoom
AngleX, TargetAngleX = 0, 0
AngleY, TargetAngleY = 0, 0
end
-- Bật/tắt kích thước camera zoom/unzoom
local function MouseClick()
if zoomed then
-- Thu nhỏ camera
ResetCamera()
else
-- Phóng to trên máy ảnh
ZoomCamera()
end
zoomed = not zoomed
end
local function MouseMoved(input)
if zoomed then
local sensitivity = 0.6 -- bất cứ thứ gì cao hơn sẽ làm cho việc tìm kiếm lên và xuống khó hơn; khuyến nghị bất cứ thứ gì giữa 0~1
local smoothness = 0.05 -- đề xuất bất cứ thứ gì giữa 0~1
local delta = Vector2.new(input.Delta.x / sensitivity, input.Delta.y / sensitivity) * smoothness
local X = TargetAngleX - delta.y
local Y = TargetAngleY - delta.x
TargetAngleX = (X >= 80 and 80) or (X <= -80 and -80) or X
TargetAngleY = (Y >= 80 and 80) or (Y <= -80 and -80) or Y
AngleX = AngleX + (TargetAngleX - AngleX) * 0.35
AngleY = AngleY + (TargetAngleY - AngleY) * 0.15
camera.CFrame = CFrame.new(head.Position, target)
* CFrame.Angles(0, math.rad(AngleY), 0)
* CFrame.Angles(math.rad(AngleX), 0, 0)
end
end
local function InputBegan(input, _gameProcessedEvent)
if input.UserInputType == Enum.UserInputType.MouseButton1 then
MouseClick()
end
end
local function InputChanged(input, _gameProcessedEvent)
if input.UserInputType == Enum.UserInputType.MouseMovement then
MouseMoved(input)
end
end
if UserInputService.MouseEnabled then
UserInputService.InputBegan:Connect(InputBegan)
UserInputService.InputChanged:Connect(InputChanged)
endKeyCode
Bao gồm một enum Enum.KeyCode mô tả loại đầu vào đã được sử dụng.Đối với các loại đầu vào như bàn phím, điều này mô tả chìa khóa được nhấn.Đối với các đầu vào như chuột, điều này không cung cấp thêm thông tin.
Danh sách
| Tên |
|---|
Xem thêm:
Mẫu mã
Ví dụ này nhận được danh sách gamepad điều hướng và danh sách các gamepad được hỗ trợ Enum.KeyCodes.Sau đó, nó lặp qua danh sách KeyCode được hỗ trợ và gắn các nút ButtonX và X vào các chức năng nếu chúng được hỗ trợ bởi gamepad bằng cách sử dụng ContextActionService .
local UserInputService = game:GetService("UserInputService")
local ContextActionService = game:GetService("ContextActionService")
local function actionHandler(actionName, inputState, inputObject)
if inputState == Enum.UserInputState.Begin then
print("Action Handler: " .. actionName)
print(inputObject)
end
-- Vì chức năng này không trả lại bất cứ thứ gì, bộ xử lý này sẽ
-- “rửa” đầu vào và không có đại lý hành động khác sẽ được gọi sau
-- cái này.
end
local navGamepads = UserInputService:GetNavigationGamepads()
for _, gamepad in pairs(navGamepads) do
local supportedKeyCodes = UserInputService:GetSupportedGamepadKeyCodes(gamepad)
for _, keycode in pairs(supportedKeyCodes) do
if keycode == Enum.KeyCode.ButtonX then
ContextActionService:BindAction("SampleAction", actionHandler, false, Enum.KeyCode.ButtonX)
end
if keycode == Enum.KeyCode.X then
ContextActionService:BindAction("SampleAction", actionHandler, false, Enum.KeyCode.X)
end
end
endPosition
Thuộc tính này mô tả giá trị vị trí Vector3 của đầu vào này.
Đối với đầu vào chuột và cảm ứng, đây là vị trí màn hình của chuột/cảm ứng, được mô tả trong thành phần X và Y.Phần nhúc được áp dụng cho các thành phần GUI (như từ thanh trên cùng) được tính trong vị trí.
Đối với đầu vào bánh xe chuột, thành phần Z mô tả xem bánh xe đã được di chuyển về phía trước (1), lùi (-1) hoặc không có gì cả (0).
Đối với Enum.KeyCode nhập, điều này cho thấy vị trí của Mouse người chơi.
Lưu ý rằng một InputObject tương ứng với Enum.UserInputType.MouseButton1 (nhấp chuột trái) và Enum.UserInputType.MouseButton2 (nhấp chuột phải) được cung cấp từ một InputBegan lời gọi trả lại sẽ không có được định dạng Delta hoặc Position của nó một khi tạo xong, ngoại trừ khi nhập chuột kết thúc.Để có được vị trí được cập nhật cho đầu vào chuột, bạn phải thay vào đó tham chiếu một InputObject từ một InputChanged lời gọi trả lại, hoặc gọi GetMouseLocation() .Tuy nhiên, bất kỳ InputObjects phù hợp với các đầu vào chạm sẽ có delta và vị trí được cập nhật mỗi khung trong suốt cuộc sống của chúng.
Xem thêm
Mẫu mã
Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng xử lý nhập lượng từ InputBegan tùy thuộc vào loại của nó.
-- Để sử dụng sự kiện InputBegan, dịch vụ UserInputService phải được sử dụng
local UserInputService = game:GetService("UserInputService")
-- Một chức năng mẫu cung cấp nhiều trường hợp sử dụng cho các loại nhập khác nhau của người dùng
UserInputService.InputBegan:Connect(function(input, gameProcessed)
if input.UserInputType == Enum.UserInputType.Keyboard then
print("A key is being pushed down! Key:", input.KeyCode)
elseif input.UserInputType == Enum.UserInputType.MouseButton1 then
print("The left mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.MouseButton2 then
print("The right mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Touch then
print("A touchscreen input has started at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Gamepad1 then
print("A button is being pressed on a gamepad! Button:", input.KeyCode)
end
if gameProcessed then
print("The game engine internally observed this input!")
else
print("The game engine did not internally observe this input!")
end
end)UserInputState
UserInputState mô tả trạng thái của một đầu vào đang thực hiện, sau một dòng chảy cụ thể tùy thuộc vào UserInputType.Nó sử dụng enum cùng tên, Enum.UserInputState .Xem trang enum để có danh sách tất cả các giá trị có thể cho tài sản này.
Xem thêm:
Mẫu mã
Ví dụ này nhận được danh sách gamepad điều hướng và danh sách các gamepad được hỗ trợ Enum.KeyCodes.Sau đó, nó lặp qua danh sách KeyCode được hỗ trợ và gắn các nút ButtonX và X vào các chức năng nếu chúng được hỗ trợ bởi gamepad bằng cách sử dụng ContextActionService .
local UserInputService = game:GetService("UserInputService")
local ContextActionService = game:GetService("ContextActionService")
local function actionHandler(actionName, inputState, inputObject)
if inputState == Enum.UserInputState.Begin then
print("Action Handler: " .. actionName)
print(inputObject)
end
-- Vì chức năng này không trả lại bất cứ thứ gì, bộ xử lý này sẽ
-- “rửa” đầu vào và không có đại lý hành động khác sẽ được gọi sau
-- cái này.
end
local navGamepads = UserInputService:GetNavigationGamepads()
for _, gamepad in pairs(navGamepads) do
local supportedKeyCodes = UserInputService:GetSupportedGamepadKeyCodes(gamepad)
for _, keycode in pairs(supportedKeyCodes) do
if keycode == Enum.KeyCode.ButtonX then
ContextActionService:BindAction("SampleAction", actionHandler, false, Enum.KeyCode.ButtonX)
end
if keycode == Enum.KeyCode.X then
ContextActionService:BindAction("SampleAction", actionHandler, false, Enum.KeyCode.X)
end
end
endUserInputType
UserInputType là một thuộc tính mô tả loại đầu vào mà InputObject đại diện, chẳng hạn như chuột, bàn phím, cảm ứng hoặc gamepad.Nó sử dụng enum cùng tên, Enum.UserInputType .Xem trang enum để có danh sách tất cả các giá trị có thể cho tài sản này.
Xem thêm:
Mẫu mã
Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng xử lý nhập lượng từ InputBegan tùy thuộc vào loại của nó.
-- Để sử dụng sự kiện InputBegan, dịch vụ UserInputService phải được sử dụng
local UserInputService = game:GetService("UserInputService")
-- Một chức năng mẫu cung cấp nhiều trường hợp sử dụng cho các loại nhập khác nhau của người dùng
UserInputService.InputBegan:Connect(function(input, gameProcessed)
if input.UserInputType == Enum.UserInputType.Keyboard then
print("A key is being pushed down! Key:", input.KeyCode)
elseif input.UserInputType == Enum.UserInputType.MouseButton1 then
print("The left mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.MouseButton2 then
print("The right mouse button has been pressed down at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Touch then
print("A touchscreen input has started at", input.Position)
elseif input.UserInputType == Enum.UserInputType.Gamepad1 then
print("A button is being pressed on a gamepad! Button:", input.KeyCode)
end
if gameProcessed then
print("The game engine internally observed this input!")
else
print("The game engine did not internally observe this input!")
end
end)