InputObject
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Sebuah InputObject mewakili input pengguna tunggal, seperti gerakan mouse, sentuhan, tekanan tombol, dan banyak lagi. Ini dibuat saat input dimulai.
Properti objek ini bervariasi tergantung pada UserInputType.Setiap jenis input akan mengalami berbagai perubahan pada UserInputState nya.Selama masa hidup input, properti lain yang lebih lanjut menggambarkan input dapat berubah, seperti Position dan Delta.Tombol keyboard dan gamepad akan memiliki aturproperty KeyCode.
Setelah dibuat pada awal input, objek yang sama bertahan dan diperbarui sampai input berakhir.Sebagai hasilnya, Anda dapat melacak perubahan objek menggunakan acara Changed sebagai pengguna mengubah input yang ditanyakan.Anda juga dapat menempatkan objek ini ke dalam daftar input aktif dan berinteraksi dengan objek setelah dibuat oleh peristiwa seperti UserInputService.InputBegan .Ini terutama berguna untuk acara sentuhan, karena setiap titik sentuhan akan memiliki InputObject yang terpisah.
Lihat juga:
- ContextActionService , yang mengirimkan InputObject ke fungsi penanganan aksi bound
- UserInputService , yang peristiwa dan fungsinya sering menggunakan InputObject
- GuiObject , yang peristiwa terkait dengan penggunaan input pengguna menggunakan InputObject
Rangkuman
Properti
Vector3 yang menggambarkan Delta antara gerakan mouse/joystick.
Berisi Enum yang menggambarkan jenis input yang digunakan.
Menggambarkan nilai posisional dari input ini.
Menggambarkan status suatu input yang dilakukan, setelah aliran tertentu tergantung pada UserInputType.
Menggambarkan jenis input yang dilakukan (mouse, keyboard, gamepad, sentuhan, dll).
Metode
Properti
Delta
A Vector3 menjelaskan Delta (perubahan) antara gerakan mouse/joystick.
Ini berguna ketika digunakan dengan input position untuk melacak posisi dan gerakan mouse/joystick pengguna, seperti saat Anda membuat gerakan khusus atau skrip kamera.Pertimbangkan untuk melacak perubahan objek input menggunakan acara Object.Changed atau ketika pengguna mengubah input melalui acara seperti UserInputService.InputChanged dan GuiObject.InputChanged .
Perhatikan bahwa an InputObject yang sesuai dengan Enum.UserInputType.MouseButton1 (klik kiri) dan Enum.UserInputType.MouseButton2 (klik kanan) yang disediakan dari panggilan balik InputBegan tidak akan memiliki Delta atau Position diperbarui setelah dibuat, kecuali saat input mouse berakhir.Untuk mendapatkan delta yang diperbarui untuk input mouse, Anda harus merujuk ke InputObject dari panggilan kembali InputChanged, atau panggil GetMouseDelta().Namun, setiap InputObjects yang sesuai dengan input sentuhan akan memiliki delta dan posisi diperbarui setiap frame sepanjang masa hidupnya.
Lihat juga:
Contoh Kode
Contoh ini membuat skrip binokel yang mengurangi klik mouse pemain FieldOfView() dan MouseDeltaSensitivity() ketika pemain dengan MouseEnabled() meninggalkan klik mouse.Skrip juga menunjukkan posisi Camera pemain terhadap posisi Vector3 dunia klik mouse.
Ketika pemain meninggalkan klik mouse lagi, kamera pemain kembali ke a khusus Enum.CameraType dengan bidang pandang yang sama dan CFrame() seperti sebelum pemain memperbesar dengan skrip.
Sementara pemain menggunakan binokel, skrip mengunci mouse pemain ke bagian tengah layar dengan menetapkan mouse pemain ke LockCenter.Kamera pemain bergerak saat pemain memindahkan mouse sesuai dengan properti yang diberikan oleh menunjukkan perubahan posisi mouse di layar.
Untuk contoh ini agar berfungsi seperti yang diharapkan, itu harus ditempatkan di 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
-- Setel ulang kamera kembali ke CFrame dan FieldOfView sebelum zoom
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()
-- Izinkan kamera diubah oleh skrip
camera.CameraType = Enum.CameraType.Scriptable
-- Simpan properti kamera sebelum melakukan zoom
originalProperties._CFrame = camera.CFrame
originalProperties.FieldOfView = camera.FieldOfView
originalProperties.MouseBehavior = UserInputService.MouseBehavior
originalProperties.MouseDeltaSensitivity = UserInputService.MouseDeltaSensitivity
-- Kamera zoom
target = mouse.Hit.Position
local eyesight = head.Position
camera.CFrame = CFrame.new(eyesight, target)
camera.Focus = CFrame.new(target)
camera.FieldOfView = 10
-- Kunci dan perlambat mouse
UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter
UserInputService.MouseDeltaSensitivity = 1
-- Setel ulang sudut zoom
AngleX, TargetAngleX = 0, 0
AngleY, TargetAngleY = 0, 0
end
-- Aktifkan/nonaktifkan zoom kamera/unzoom
local function MouseClick()
if zoomed then
-- Kamera tidak zoom keluar
ResetCamera()
else
-- Perbesar di kamera
ZoomCamera()
end
zoomed = not zoomed
end
local function MouseMoved(input)
if zoomed then
local sensitivity = 0.6 -- apa pun yang lebih tinggi akan membuat mencari ke atas dan ke bawah lebih sulit; rekomendasikan apa pun di antara 0~1
local smoothness = 0.05 -- rekomendasikan apa pun antara 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
Berisi sebuah Enum.KeyCode enum yang menjelaskan jenis input apa yang digunakan.Untuk jenis input seperti keyboard, ini menjelaskan tombol apa yang ditekan.Untuk input seperti mouse, ini tidak memberikan informasi tambahan.
Enums
| Nama |
|---|
Lihat juga:
Contoh Kode
Contoh ini mendapatkan daftar gamepad navigasi dan daftar dukungan mereka Enum.KeyCodes.Kemudian, ia mengulang melalui daftar KeyCode yang didukung dan mengikat tombol ButtonX dan X ke fungsi jika mereka didukung oleh gamepad menggunakan 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
-- Karena fungsi ini tidak mengembalikan apa pun, penangan ini akan
-- “sink” input dan tidak ada penangan aksi lain yang akan dipanggil setelah
-- yang ini.
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
Properti ini menggambarkan nilai posisional Vector3 dari input ini.
Untuk input mouse dan sentuhan, ini adalah posisi layar mouse/sentuhan, yang dijelaskan dalam komponen X dan Y.Layanan yang diterapkan ke elemen GUI (seperti dari bilah atas) dihitung dalam posisi.
Untuk input roda mouse, komponen Z menggambarkan apakah roda dipindahkan ke depan (1), ke belakang (-1), atau sama sekali tidak (0).
Untuk Enum.KeyCode, ini menunjukkan posisi Mouse .
Perhatikan bahwa an InputObject yang sesuai dengan Enum.UserInputType.MouseButton1 (klik kiri) dan Enum.UserInputType.MouseButton2 (klik kanan) yang disediakan dari panggilan balik InputBegan tidak akan memiliki Delta atau Position diperbarui setelah dibuat, kecuali saat input mouse berakhir.Untuk mendapatkan posisi yang diperbarui untuk input mouse, Anda harus merujuk ke InputObject dari panggilan kembali InputChanged, atau panggil GetMouseLocation().Namun, setiap InputObjects yang sesuai dengan input sentuhan akan memiliki delta dan posisi diperbarui setiap frame sepanjang masa hidupnya.
Lihat juga
UserInputState
UserInputState menggambarkan status input yang dilakukan, setelah aliran tertentu tergantung pada UserInputType.Ini menggunakan enum dengan nama yang sama, Enum.UserInputState .Lihat halaman enum untuk daftar semua nilai yang mungkin untuk properti ini.
Lihat juga:
Contoh Kode
Contoh ini mendapatkan daftar gamepad navigasi dan daftar dukungan mereka Enum.KeyCodes.Kemudian, ia mengulang melalui daftar KeyCode yang didukung dan mengikat tombol ButtonX dan X ke fungsi jika mereka didukung oleh gamepad menggunakan 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
-- Karena fungsi ini tidak mengembalikan apa pun, penangan ini akan
-- “sink” input dan tidak ada penangan aksi lain yang akan dipanggil setelah
-- yang ini.
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
Tipe Input Pengguna adalah properti yang menggambarkan jenis input apa yang diwakili oleh ini InputObject , seperti mouse, keyboard, sentuhan atau gamepad input.Ini menggunakan enum dengan nama yang sama, Enum.UserInputType .Lihat halaman enum untuk daftar semua nilai yang mungkin untuk properti ini.
Lihat juga: