InputObject
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Przedmiot wejściowy reprezentuje pojedyncze wejście użytkownika, takie jak ruch myszy, dotknięcia, naciśnięcia klawiszy i więcej. Tworzy się go, gdy rozpoczyna się wejście.
Właściwości tego obiektu różnią się w zależności od UserInputType.Każdy rodzaj wejścia przejdzie różne zmiany w swojej UserInputState .Podczas życia wejścia mogą się zmienić inne właściwości, które dalej opisują wejście, takie jak Position i Delta.Przyciski klawiatury i gamepada będą miały ustawiaćwłaściwość KeyCode.
Po utworzeniu na początku wejścia ten sam obiekt trwa i jest aktualizowany do czasu zakończenia wejścia.W wynikmożesz śledzić zmiany obiektu za pomocą wydarzenia Changed, gdy użytkownik zmienia wejście w kwestii.Możesz również umieścić te obiekty na liście aktywnych ścieżek wejściowych i wejść w interakcję z obiektem po jego utworzeniu przez wydarzenie takie jak UserInputService.InputBegan.Jest to głównie przydatne dla wydarzeń dotykowych, ponieważ każdy punkt dotyku będzie miał oddzielny obiekt wejściowy.
Zobacz także:
- ContextActionService , który przekazuje obiekt wejściowy do funkcji obsługi akcji bound
- UserInputService , których wydarzenia i funkcje często używają InputObject
- GuiObject , których wydarzenia związane z wejściem użytkownika wykorzystują obiekt wejściowy InputObject
Przykłady kodu
Poniższy przykład pokazuje jeden z wielu przykładów użycia obsługi wejścia użytkownika z InputBegan w zależności od jego typu.
-- Aby skorzystać z wydarzenia InputBegan, należy używać usługi UserInputService
local UserInputService = game:GetService("UserInputService")
-- Próbna funkcja dostarczająca wiele przypadków użycia dla różnych rodzajów wejść użytkownika
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)Podsumowanie
Właściwości
Wektora 3 opisującego Delta między ruchami myszy/joysticka.
Zawiera Enum, które opisuje rodzaj używanego wejścia.
Opisuje wartość pozycyjną tego wejścia.
Opisuje stan wykonywania wejścia, po następującym przepływie w zależności od UserInputType.
Opisuje rodzaj wykonywanych wejść (mysz, klawiatura, gamepad, dotyk itp.).
Metody
Właściwości
Delta
A Vector3 opisująca Delta (zmiana) między ruchami myszy/joysticka.
Jest to przydatne, gdy używany jest z wejściem position , aby śledzić pozycję i ruch myszy/joysticka użytkownika, tak jak przy tworzeniu niestandardowych skryptów ruchowych lub kamery.Rozważ śledzenie zmian w obiekcie wejściowym za pomocą wydarzenia Object.Changed lub gdy użytkownik wprowadza zmiany za pomocą wydarzeń takich jak UserInputService.InputChanged i GuiObject.InputChanged.
Zauważ, że odpowiadające (lewe klikać) i (prawe klikać) dostarczone z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powAby uzyskać zaktualizowane delty dla wpisów myszy, musisz zamiast tego odwołać się do InputObject z powrotem do wezwania z powrotem z InputChanged , lub wezwać GetMouseDelta() .Jednak każdy InputObjects odpowiadający wejściom dotykowym będzie miał swoją deltę i pozycję aktualizowaną co każdą ramę w ciągu całego życia.
Zobacz także:
Przykłady kodu
Ten przykład tworzy skrypt lornetki, który zmniejsza FieldOfView() i MouseDeltaSensitivity() gracza, gdy gracz z MouseEnabled() ma lewe kliknięcia myszy.Skrypt wskazuje również kierunek ruchu gracza Camera w kierunku pozycji świata Vector3 kliknięcia myszy.
Kiedy gracz ponownie kliknie myszą, kamera gracza powraca do niestandardowej Enum.CameraType z tym samym polem widzenia i CFrame() tak jak przed tym, jak gracz przybliżył się za pomocą skryptu.
Podczas gdy gracz używa lornetki, skrypt blokuje mysz gracza w centrum ekranu, ustawiając gracza MouseBehavior() na BlokujCentrum.Kamera gracza porusza się, gdy gracz przesuwa mysz zgodnie z właściwością InputObject.Delta, przekazaną przez InputChanged(), wskazującą zmianę pozycji na ekranie Vector2 myszy.
Aby ten przykład działał zgodnie z oczekiwaniem, należy go umieścić w 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
-- Zresetuj kamerę powrotem do CFrame i FieldOfView przed przysunięciem
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()
-- Pozwól, aby kamera została zmieniona przez skrypt
camera.CameraType = Enum.CameraType.Scriptable
-- Przechowywanie właściwości kamery przed przysunięciem
originalProperties._CFrame = camera.CFrame
originalProperties.FieldOfView = camera.FieldOfView
originalProperties.MouseBehavior = UserInputService.MouseBehavior
originalProperties.MouseDeltaSensitivity = UserInputService.MouseDeltaSensitivity
-- Przybliż kamera
target = mouse.Hit.Position
local eyesight = head.Position
camera.CFrame = CFrame.new(eyesight, target)
camera.Focus = CFrame.new(target)
camera.FieldOfView = 10
-- Zablokuj i spowolnij mysz
UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter
UserInputService.MouseDeltaSensitivity = 1
-- Zresetuj kąty przymiotu
AngleX, TargetAngleX = 0, 0
AngleY, TargetAngleY = 0, 0
end
-- Przełącz zoom/odbicie kamery
local function MouseClick()
if zoomed then
-- Odpręż kamerę
ResetCamera()
else
-- Przybliż kamerę
ZoomCamera()
end
zoomed = not zoomed
end
local function MouseMoved(input)
if zoomed then
local sensitivity = 0.6 -- wszystko powyżej sprawiłoby, że poszukiwanie w górę i w dół będzie trudniejsze; zalecam wszystko pomiędzy 0~1
local smoothness = 0.05 -- polecaj coś pomiędzy 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
Zawiera Enum.KeyCode enumerację, która opisuje, jakiego rodzaju wejście zostało użyte.Dla typów wejść takich jak klawiatura opisuje to, który klawisz został naciśnięty.Dla wejść takich jak mysz nie dostarcza to dodatkowych informacji.
Enumery
| Nazwa |
|---|
Zobacz także:
Przykłady kodu
Ten przykład otrzymuje listę gier nawigacyjnych i listę ich wspieranych Enum.KeyCodes.Następnie iteruje przez wspieraną listę KeyCode i wiąże klawisze ButtonX i X z funkcjami, jeśli są one wspierane przez gamepad za pomocą 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
-- Ponieważ ta funkcja nie zwraca nic, ten przełącznik będzie
-- „zmyj” wejście, a po nim nie zostanie wezwany żaden inny menedżer akcji
-- ten jeden.
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
Właściwość ta opisuje wartość pozycyjną Vector3 tej wartości wejściowej.
Dla wpisu myszy i dotyku jest to pozycja ekranu myszy/dotyku, opisana w składnikach X i Y.Wkład zastosowany do elementów interfejsu graficznego (takich jak z paska górnego) jest rozliczany w pozycji.
Dla wejścia koła myszy, komponent Z opisuje, czy koło zostało przesunięte do przodu (1), wstecz (-1) lub wcale (0).
Dla Enum.KeyCode, wskazuje to pozycję Mouse.
Zauważ, że odpowiadające (lewe klikać) i (prawe klikać) dostarczone z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrotem z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powrot z powAby uzyskać zaktualizowane pozycje dla wejść myszy, musisz zamiast tego odwołać się do InputObject z powrotem do wezwania z powrotem z InputChanged , lub wezwać GetMouseLocation() .Jednak każdy InputObjects odpowiadający wejściom dotykowym będzie miał swoją deltę i pozycję aktualizowaną co każdą ramę w ciągu całego życia.
Zobacz także
Przykłady kodu
Poniższy przykład pokazuje jeden z wielu przykładów użycia obsługi wejścia użytkownika z InputBegan w zależności od jego typu.
-- Aby skorzystać z wydarzenia InputBegan, należy używać usługi UserInputService
local UserInputService = game:GetService("UserInputService")
-- Próbna funkcja dostarczająca wiele przypadków użycia dla różnych rodzajów wejść użytkownika
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
Stan wpisu użytkownika opisuje stan wpisu wykonywanego, po następującym przepływie w zależności od >.Używa on enum o tej samej nazwie, Enum.UserInputState .Zobacz stronę enum dla listy wszystkich możliwych wartości dla tej właściwości.
Zobacz także:
Przykłady kodu
Ten przykład otrzymuje listę gier nawigacyjnych i listę ich wspieranych Enum.KeyCodes.Następnie iteruje przez wspieraną listę KeyCode i wiąże klawisze ButtonX i X z funkcjami, jeśli są one wspierane przez gamepad za pomocą 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
-- Ponieważ ta funkcja nie zwraca nic, ten przełącznik będzie
-- „zmyj” wejście, a po nim nie zostanie wezwany żaden inny menedżer akcji
-- ten jeden.
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
Typ wejścia użytkownika jest właściwością, która opisuje, jakiego rodzaju wejście reprezentuje to InputObject, takie jak mysz, klawiatura, dotyk lub gamepad.Używa on enum o tej samej nazwie, Enum.UserInputType .Zobacz stronę enum dla listy wszystkich możliwych wartości dla tej właściwości.
Zobacz także:
Przykłady kodu
Poniższy przykład pokazuje jeden z wielu przykładów użycia obsługi wejścia użytkownika z InputBegan w zależności od jego typu.
-- Aby skorzystać z wydarzenia InputBegan, należy używać usługi UserInputService
local UserInputService = game:GetService("UserInputService")
-- Próbna funkcja dostarczająca wiele przypadków użycia dla różnych rodzajów wejść użytkownika
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)