InputObject
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bir Giriş Nesnesi bir tek kullanıcı girişini temsil eder, örneğin fare hareketleri, dokunma, anahtar basmalar ve daha fazlası. Bir giriş başladığında oluşturulur.
Bu nesnenin özellikleri UserInputType 'ye göre değişir.Her türlü giriş, UserInputState 'ye çeşitli değişiklikler geçirecektir.Bir girişin ömrü boyunca, girişi daha fazla tanımlayan diğer özellikler değişebilir, örneğin Position ve Delta.Klavye ve oyun kolu düğmelerinin KeyCode özellik ayarlasahip olacak.
Bir girişin başında oluşturulduktan sonra, aynı nesne devam edene kadar aynı kalır ve giriş bitene kadar güncellenir.sonuçolarak, nesnenin değişikliklerini kullanarak Changed etkinliğini takip edebilirsiniz, kullanıcı girdiyi değiştirdiğinde.Ayrıca, bu nesneleri aktif giriş izinin bir listesine yerleştirebilir ve bir olay (örneğin UserInputService.InputBegan) tarafından oluşturulduktan sonra nesne ile etkileşime girebilirsiniz.Bu çoğunlukla dokunma olayları için yararlıdır, çünkü her dokunma noktası ayrı bir Giriş Nesnesine sahip olacaktır.
Ayrıca bakın:
- ContextActionService , bir Giriş Nesnesini bound eylem işleme fonksiyonlarına aktaran
- UserInputService , etkinlikleri ve işlevleri genellikle InputObject kullanır
- GuiObject , kullanıcı girişiyle ilgili olayları olan kimin etkinlikleri InputObject kullanır
Özet
Özellikler
Fare/joystick hareketleri arasındaki Delta'yı tanımlayan bir Vector3.
Kullanılan giriş türünü tanımlayan bir Enum içerir.
Bu girişin pozisyonel değerini tanımlar.
Bir girişin yapıldığı durumu tanımlar, UserInputType 'ye bağlı olarak belirli bir akış izleyerek.
Yapılan giriş türünü tanımlar (fare, klavye, oyun kolu, dokunma vb.).
Yöntemler
Özellikler
Delta
Fare/joystick hareketleri arasındaki Delta'yı tanımlayan bir Vector3 .
Bu, girişin position ile kullanıldığında kullanıcının fare/joystick hareket ve konumunu izlemek için yararlıdır, örneğin özel hareket veya kamera senaryoları oluştururken.Object.Changed etkinliğini kullanarak giriş nesnesi değişikliklerini izlemeyi veya UserInputService.InputChanged ve GuiObject.InputChanged gibi etkinlikler aracılığıyla kullanıcı giriş değişikliklerini izlemeyi düşünün.
Bir InputObject (sol tık) ve Enum.UserInputType.MouseButton1 (sağ tık) bir Enum.UserInputType.MouseButton2 (sol tık) ve InputBegan (sağ tık) bir Delta veya Position gönderilen bir geri çağrıdan gelen çalıştırılırken güncellenmez, fare girişi sona erene kadar hariç.Fare girişleri için güncellenmiş deltalar almak için, bunun yerine bir geri çağrısından referans vermeli veya çağırmalısınız.Bununla birlikte, dokunma girişlerine karşılık gelen herhangi bir herhangi bir süre boyunca her karede delta ve konumları güncellenecektir.
Ayrıca bakın:
Kod Örnekleri
Bu örnek, bir oyuncunun FieldOfView() ve MouseDeltaSensitivity() 'sini azaltan bir dürbün kodu oluşturur, bir oyuncunun MouseEnabled() 'sini bıraktığında.Ayrıca, senaryo oyuncunun Camera mouse'un tıklama dünya konumuna yönlendirilmesini sağlar Vector3 .
Oyuncu tekrar fare tıklamalarını bıraktığında, oyuncunun kamerası aynı görüş alanı ve ile önce oyuncu tarafından yakınlaştırıldığı gibi aynı alana geri döner.
Oyuncu dürbünleri kullandığında, senaryo oyuncunun mouse'unu ekranın merkezine kilitleerek oyuncunun MouseBehavior() 'sini KilitleCenter'a ayarlar.Oyuncunun kamerası, oyuncunun fareyi ekranda InputObject.Delta değiştirdiğine göre hareket eder, çünkü InputChanged() mouse'un ekranda değişen Vector2 konumunu gösteren özellik tarafından geçirilir.
Bu örnekin beklenen şekilde çalışması için, bir LocalScript içine yerleştirilmelidir.
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
-- Kamera, zoom'dan önce CFrame ve FieldOfView'e sıfırla
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()
-- Kameranın kod tarafından değiştirilmesine izin ver
camera.CameraType = Enum.CameraType.Scriptable
-- Küçültmeden önce kameranın özelliklerini depolayın
originalProperties._CFrame = camera.CFrame
originalProperties.FieldOfView = camera.FieldOfView
originalProperties.MouseBehavior = UserInputService.MouseBehavior
originalProperties.MouseDeltaSensitivity = UserInputService.MouseDeltaSensitivity
-- Büyütme kamerası
target = mouse.Hit.Position
local eyesight = head.Position
camera.CFrame = CFrame.new(eyesight, target)
camera.Focus = CFrame.new(target)
camera.FieldOfView = 10
-- Fareyi kilitle ve yavaşlat
UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter
UserInputService.MouseDeltaSensitivity = 1
-- Zoom açılarını sıfırla
AngleX, TargetAngleX = 0, 0
AngleY, TargetAngleY = 0, 0
end
-- Kamera yakınlaştırması/uzaklaştırması geçişi
local function MouseClick()
if zoomed then
-- Kamerayı genişletmez Unzoom camera
ResetCamera()
else
-- Kamerada yakınlaş
ZoomCamera()
end
zoomed = not zoomed
end
local function MouseMoved(input)
if zoomed then
local sensitivity = 0.6 -- daha yüksek bir şey aşağı ve yukarı bakmayı zorlaştırır; 0~1 arasında her şeyi önerin
local smoothness = 0.05 -- 0~1 arasında herhangi bir şey önerin
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
Ne tür bir giriş kullanıldığını tanımlayan bir Enum.KeyCode dizi içerir.Klavye gibi giriş türleri için, bu, hangi tuşun basıldığını tanımlar.faregibi girişler için, bu ek bilgi sağlamaz.
Enleri
| Adı |
|---|
Ayrıca bakın:
Kod Örnekleri
Bu örnek, navigasyon oyun konsollarının bir listesini ve desteklenenlerin bir listesini alır Enum.KeyCodes.Sonra, desteklenen AnahtarKod listesinden döngü geçer ve ButtonX ve X düğmeleri bir oyun kumandası tarafından destekleniyorsa, fonksiyonlara bağlanır 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
-- Bu işlev hiçbir şey dönmediğinden, bu işlemci
-- giriş "sink" edilir ve başka bir giriş işlem yöneticisi ardından çağrılmaz
-- bu.
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
Bu özellik, bu girişin Vector3 pozisyonel değerini tanımlar.
Fare ve dokunma girişi için, bu, X ve Y bileşenlerinde açıklanan fare/dokunma ekran konumudur.UI öğelerine (örneğin üst çubuktan) uygulanan ekstrüzyon, pozisyonda hesaba katılır.
Fare tekerleği girişi için, Z bileşeni tekerleğin ileriye doğru (1), geriye doğru (-1) veya hiç olmadığını tanımlar (0).
Giriş için Enum.KeyCode , bu, oyuncunun Mouse konumunu gösterir.
Bir InputObject (sol tık) ve Enum.UserInputType.MouseButton1 (sağ tık) bir Enum.UserInputType.MouseButton2 (sol tık) ve InputBegan (sağ tık) bir Delta veya Position gönderilen bir geri çağrıdan gelen çalıştırılırken güncellenmez, fare girişi sona erene kadar hariç.Fare girişleri için güncellenmiş pozisyonlar almak için, bunun yerine bir geri çağrısından referans vermeli veya çağırmalısınız.Bununla birlikte, dokunma girişlerine karşılık gelen herhangi bir herhangi bir süre boyunca her karede delta ve konumları güncellenecektir.
Ayrıca bakın
UserInputState
KullanıcıGirişDurumu bir girişin yapıldığı durumu tanımlar, UserInputType 'a bağlı olarak belirli bir akış izleyerek.Aynı adın enum'ini kullanır, Enum.UserInputState .Bu özellik için mümkün olan tüm değerlerin bir listesini görmek için enum sayfasına bakın.
Ayrıca bakın:
Kod Örnekleri
Bu örnek, navigasyon oyun konsollarının bir listesini ve desteklenenlerin bir listesini alır Enum.KeyCodes.Sonra, desteklenen AnahtarKod listesinden döngü geçer ve ButtonX ve X düğmeleri bir oyun kumandası tarafından destekleniyorsa, fonksiyonlara bağlanır 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
-- Bu işlev hiçbir şey dönmediğinden, bu işlemci
-- giriş "sink" edilir ve başka bir giriş işlem yöneticisi ardından çağrılmaz
-- bu.
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
KullanıcıGirişTürü bir özelliktir, fare, klavye, dokunma veya oyun kolu girişi gibi hangi giriş türünü temsil ettiğini tanımlar, öyle ki bu InputObject .Aynı adın enum'ini kullanır, Enum.UserInputType .Bu özellik için mümkün olan tüm değerlerin bir listesini görmek için enum sayfasına bakın.
Ayrıca bakın: