一个 输入对象 代表单个用户输入，例如鼠标移动、触摸、按键操作等。当输入开始时创建。
该对象的属性根据 UserInputType 会有所不同。每种输入都会经历各种变化，以其 UserInputState 。在输入的使用期间，其他进一步描述输入的属性可能会更改，例如 Position 和 Delta 。键盘和游戏手柄按钮将具有 KeyCode 属性设置。
在输入开始之前创建一次，同一个对象存在并更新直到输入结束。因结果，您可以使用 Changed 事件跟踪对象的更改，因为用户在问题的输入更改时。您还可以将这些对象放入激活输入列表，并在创建后通过事件 such as UserInputService.InputBegan 与对象进行交互。这主要对触摸事件有用，因为每个触摸点都会有一个独立的输入对象。
还见：
- ContextActionService , 这将传递一个输入对象到 bound 操作处理函数
- UserInputService ,其事件和功能经常使用输入对象
- GuiObject ,其事件与用户输入相关的使用输入对象
概要
属性
描述鼠标/手柄移动之间差异的 Vector3。
包含一个枚数，描述使用的输入类型。
描述了这个输入的位置值。
描述输入正在执行的状态，根据 UserInputType 进行特定流程。
描述正在执行的输入类型（鼠标、键盘、游戏手柄、触摸等）。
属性
Delta
描述鼠标/手柄移动之间的差异(更改)的 Vector3 。
当与输入的 position 一起使用时，这有助于跟踪用户的鼠标/手柄的位置和移动，例如当你正在创建自定义移动或相机脚本时。考虑使用 Object.Changed 事件跟踪输入对象更改或当用户通过事件如 UserInputService.InputChanged 和 GuiObject.InputChanged 输入更改时。
请注意，一个对应于 （左键点击） 和 （右键点击） 从回调中提供的 （左键点击） 和 （右键点按） 在创建后不会更新，除了鼠标输入结束时。为了获取鼠标输入的更新差异，你必须使用 InputObject 从 InputChanged 回调中引用，或调用 GetMouseDelta() 。然而，任何与触摸输入相对应的 InputObjects 将在其生命周期内每一帧更新其差异和位置。
还见：
代码示例
这个例子创建了一个望远镜脚本，降低玩家的 FieldOfView() 和 MouseDeltaSensitivity() 当玩家使用具有 MouseEnabled() 的鼠标点击时。该脚本还指向玩家的 向鼠标单击的世界位置。
当玩家再次离开鼠标点击时，玩家的相机返回到与玩家使用脚本时相同的视野和 领域。
当玩家使用望远镜时，脚本通过设置玩家的 MouseBehavior() 到锁定中心来锁定玩家的鼠标到屏幕中心。当玩家移动鼠标时，按照传递给 InputObject.Delta 的 InputChanged() 属性移动相机，表示玩家在屏幕位置上更改了鼠标的 Vector2 。
为了这个例子按期望的方式运行，它应该放置在 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
-- 将相机重置为 CFrame 和 FieldOfView，在缩放之前
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()
-- 允许通过脚本更改相机
camera.CameraType = Enum.CameraType.Scriptable
-- 在缩放之前存储相机属性
originalProperties._CFrame = camera.CFrame
originalProperties.FieldOfView = camera.FieldOfView
originalProperties.MouseBehavior = UserInputService.MouseBehavior
originalProperties.MouseDeltaSensitivity = UserInputService.MouseDeltaSensitivity
-- 缩放相机
target = mouse.Hit.Position
local eyesight = head.Position
camera.CFrame = CFrame.new(eyesight, target)
camera.Focus = CFrame.new(target)
camera.FieldOfView = 10
-- 锁定并减慢鼠标
UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter
UserInputService.MouseDeltaSensitivity = 1
-- 重置缩放角度
AngleX, TargetAngleX = 0, 0
AngleY, TargetAngleY = 0, 0
end
-- 切换镜头缩放/取消缩放
local function MouseClick()
if zoomed then
-- 缩放相机
ResetCamera()
else
-- 在相机放大
ZoomCamera()
end
zoomed = not zoomed
end
local function MouseMoved(input)
if zoomed then
local sensitivity = 0.6 -- 任何高于此的数值都会使查找上下更加困难；推荐在 0~1 之间的数值
local smoothness = 0.05 -- 推荐在 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
包含一个 Enum.KeyCode 枚列，描述使用了哪种输入。对于像键盘这样的输入类型，这描述了按下了哪个键。对于像鼠标这样的输入，这不提供额外信息。
枚数
| 名称 |
|---|
还见：
代码示例
这个例子获取一个列表的导航游戏板和一个列表支持的Enum.KeyCodes。然后，它循环通过支持的 KeyCode 列表并将 ButtonX 和 X 键绑定到函数，如果使用游戏手柄 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
-- 由于此函数不返回任何内容，这个处理器将
-- “洗手台”输入，其他任何操作处理器不会在之后调用
-- 这个。
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
该属性描述了这个输入的 Vector3 位置值。
对于鼠标和触摸输入，这是鼠标/触摸的屏幕位置，描述在 X 和 Y 组件中。应用于 GUI 元素的插入（例如来自顶部栏）在位置中被计算。
对于鼠标轮输入，Z组件描述轮子是否向前移动(1)、向后移动(-1)或不移动(0)。
对于 Enum.KeyCode 输入，这表示玩家的 Mouse 位置。
请注意，一个对应于 （左键点击） 和 （右键点击） 从回调中提供的 （左键点击） 和 （右键点按） 在创建后不会更新，除了鼠标输入结束时。为了获取鼠标输入的更新位置，您必须使用 InputObject 从 InputChanged 回调中引用，或调用 GetMouseLocation() 。然而，任何与触摸输入相对应的 InputObjects 将在其生命周期内每一帧更新其差异和位置。
还见于
UserInputState
用户输入状态 描述在 UserInputType 后进行的输入状态，根据特定流程进行。它使用相同名称的枚数，Enum.UserInputState。查看枚举页以获取此属性的所有可用值列表。
还见：
代码示例
这个例子获取一个列表的导航游戏板和一个列表支持的Enum.KeyCodes。然后，它循环通过支持的 KeyCode 列表并将 ButtonX 和 X 键绑定到函数，如果使用游戏手柄 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
-- 由于此函数不返回任何内容，这个处理器将
-- “洗手台”输入，其他任何操作处理器不会在之后调用
-- 这个。
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
用户输入类型 是描述这个 InputObject 代表何种输入的属性，例如鼠标、键盘、触摸或游戏手柄输入。它使用相同名称的枚数，Enum.UserInputType。查看枚举页以获取此属性的所有可用值列表。
还见：