UserInputService

คุณสมบัตินี้อธิบายว่าอุปกรณ์ของผู้ใช้มีเครื่องวัดความเร่งหรือไม่

เครื่องวัดความเร่งเป็นส่วนประกอบที่พบในอุปกรณ์เคลื่อนที่ส่วนใหญ่ที่วัดความเร่ง (การเปลี่ยนแปลงความเร็ว)

ตัวอย่างเช่น ส่วนตัดต่อโค้ดต่อไปนี้แสดงวิธีการตรวจสอบว่าอุปกรณ์ของผู้ใช้มีเครื่องวัดความเร่งหรือไม่

local UserInputService = game:GetService("UserInputService")

local accelerometerEnabled = UserInputService.AccelerometerEnabled
if accelerometerEnabled then
	print("Accelerometer enabled!")
else
	print("Accelerometer not enabled!")
end

หากอุปกรณ์มีเครื่องวัดความเร่งที่เปิดใช้งานคุณสามารถรับการเร่งปัจจุบันโดยใช้ฟังก์ชัน UserInputService:GetDeviceAcceleration() หรือติดตามเมื่อการเร่งของอุปกรณ์เปลี่ยนแปลงโดยใช้เหตุการณ์ UserInputService.DeviceAccelerationChanged

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

local Workspace = game:GetService("Workspace")
local UserInputService = game:GetService("UserInputService")

local ball = script.Parent:WaitForChild("Ball")
local mass = ball:GetMass()
local gravityForce = ball:WaitForChild("GravityForce")

local function moveBall(gravity)
	gravityForce.Force = gravity.Position * Workspace.Gravity * mass
end

if UserInputService.AccelerometerEnabled then
	UserInputService.DeviceGravityChanged:Connect(moveBall)
end

คุณสมบัตินี้อธิบายว่าอุปกรณ์ที่ใช้โดยผู้ใช้มี gamepad ที่ใช้งานได้หรือไม่หาก gamepads มีอยู่คุณสามารถใช้ UserInputService:GetConnectedGamepads() เพื่อดูรายการ gamepads ที่เชื่อมต่อ

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.GamepadConnected
• UserInputService.GamepadDisconnected
• UserInputService:GetConnectedGamepads()
• UserInputService:IsGamepadButtonDown()
• UserInputService:GetSupportedGamepadKeyCodes()
• UserInputService:GetGamepadState()
• UserInputService:GetGamepadConnected()
• UserInputService:GamepadSupports()

คุณสมบัตินี้อธิบายว่าอุปกรณ์ของผู้ใช้มีเครื่องวัดความเร่งหรือไม่

ไจโรสโคปเป็นส่วนประกอบที่พบในอุปกรณ์เคลื่อนที่ส่วนใหญ่ที่ตรวจจับการหมุนและความเร็วในการหมุน

หากอุปกรณ์ของผู้ใช้มีเครื่องวัดความเร่ง คุณสามารถใช้รวมมันเข้ากับเกมของคุณโดยใช้ฟังก์ชัน UserInputService:GetDeviceRotation() และอีเวนต์ UserInputService.DeviceRotationChanged

local UserInputService = game:GetService("UserInputService")

local gyroIsEnabled = UserInputService.GyroscopeEnabled
if gyroIsEnabled then
	print("Gyroscope is enabled!")
else
	print("Gyroscope is not enabled!")
end

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

คุณสมบัตินี้อธิบายว่าอุปกรณ์ของผู้ใช้มีแป้นพิมพ์ที่ใช้งานได้หรือไม่คุณสมบัตินี้คือ true เมื่ออุปกรณ์ของผู้ใช้มีแป้นพิมพ์ที่ใช้งานได้ และ false เมื่อไม่มี

สามารถใช้เพื่อตรวจสอบว่าผู้ใช้มีแป้นพิมพ์ที่ใช้งานได้หรือไม่ - ซึ่งอาจเป็นสิ่งสำคัญหากคุณต้องการตรวจสอบว่าคุณสามารถใช้ UserInputService:IsKeyDown() หรือ UserInputService:GetKeysPressed() เพื่อตรวจสอบการใส่ข้อมูลบนแป้นพิมพ์ได้

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

local UserInputService = game:GetService("UserInputService")

if UserInputService.KeyboardEnabled then
	print("The user's device has an available keyboard!")
else
	print("The user's device does not have an available keyboard!")
end

คุณสมบัตินี้กำหนดวิธีที่เมาส์ของผู้ใช้ทำงานตาม enum Enum.MouseBehavior ได้ สามารถตั้งค่าเป็นสามค่า:

• Enum.MouseBehavior.Default — เมาส์เคลื่อนไหวได้อย่างอิสระรอบหน้าจอของผู้ใช้
• Enum.MouseBehavior.LockCenter — เมาส์ถูกล็อคและไม่สามารถย้ายจากศูนย์กลางของหน้าจอผู้ใช้ได้
• Enum.MouseBehavior.LockCurrentPosition — เมาส์ถูกล็อคและไม่สามารถย้ายจากตำแหน่งปัจจุบันบนหน้าจอของผู้ใช้ในเวลาที่ล็อคได้

ค่าของคุณสมบัตินี้ไม่ส่งผลต่อความไวของการติดตามการเคลื่อนไหวของเมาส์ในการติดตามเหตุการณ์ตัวอย่างเช่น GetMouseDelta ส่งคืนตำแหน่งหน้าจอเดียวกัน Vector2 ในพิกเซลไม่ว่าเมาส์จะถูกล็อคหรือสามารถเคลื่อนที่ได้อย่างอิสระรอบหน้าจอของผู้ใช้ผลที่ตามมาคือสคริปต์เริ่มต้นเช่นสคริปต์ที่ควบคุมกล้องจะไม่ได้รับผลกระทบจากคุณสมบัตินี้

คุณสมบัตินี้จะถูกแทนที่หาก GuiButton ที่มี Modal เปิดใช้งานอยู่เป็น GuiButton.Visible ยกเว้นหากปุ่มเมาส์ขวาของผู้เล่นลง

โปรดทราบว่าหากเมาส์ถูกล็อค UserInputService.InputChanged จะยังคงยิงเมื่อผู้เล่นย้ายเมาส์และจะผ่านเดลต้าที่เมาส์พยายามย้ายไปนอกจากนี้หากผู้เล่นถูกไล่ออกจากเกม เมาส์จะถูกปลดล็อกอย่างถาวร

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน 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)
end

คุณสมบัตินี้กำหนดความไวของ Mouse ของผู้ใช้

ความไวกำหนดขอบเขตที่การเคลื่อนไหวของเมาส์จริงจะแปลเป็นการเคลื่อนไหวของเมาส์ในเกมสิ่งนี้สามารถใช้เพื่อปรับเปลี่ยนวิธีการติดตามการเคลื่อนไหวของเหตุการณ์ที่ไวที่เกี่ยวข้องกับการเคลื่อนไหวของเมาส์, เช่น GetMouseDelta , กับการเคลื่อนไหวของเมาส์

คุณสมบัตินี้ไม่ส่งผลต่อการเคลื่อนไหวของไอคอนเมาส์นอกจากนี้ยังไม่ส่งผลต่อการตั้งค่าความไวของกล้อง ความไวของกล้อง ที่พบในแท็บ การตั้งค่า ของเมนู การตั้งค่าของลูกค้า ซึ่งยังปรับความไวของการติดตามการเคลื่อนไหวของเหตุการณ์ด้วย

คุณสมบัตินี้มีค่าสูงสุดคือ 10 และค่าต่ำสุดคือ 0มูลค่าที่ต่ำกว่าตรงกับความไวต่ำกว่าและมูลค่าที่สูงกว่าตรงกับความไวสูงกว่า

เมื่อความไวเป็น 0 อีเวนต์ที่ติดตามการเคลื่อนไหวของเมาส์จะยังคงยิง แต่พารามิเตอร์และคุณสมบัติทั้งหมดที่ระบุถึงการเปลี่ยนแปลงในตำแหน่งเมาส์จะกลับมา Vector2.new() หรือ Vector3.new() ในกรณีของ InputObject.Deltaตัวอย่างเช่น GetMouseDelta จะส่งกลับเสมอ (0, 0)

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)
end

คุณสมบัตินี้อธิบายว่าอุปกรณ์ของผู้ใช้มีเมาส์ที่ใช้งานหรือไม่คุณสมบัตินี้คือ true เมื่ออุปกรณ์ของผู้ใช้มีเมาส์ที่ใช้งานได้ และ false เมื่อไม่มี

local UserInputService = game:GetService("UserInputService")

if UserInputService.MouseEnabled then
	print("The user's device has an available mouse!")
else
	print("The user's device does not have an available mouse!")
end

เป็นสิ่งสำคัญที่ต้องตรวจสอบนี้ก่อนที่จะใช้ฟังก์ชันเมาส์ UserInputService เช่น UserInputService:GetMouseLocation()

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.MouseBehavior
• UserInputService.MouseDeltaSensitivity
• UserInputService.MouseIconEnabled
• UserInputService:GetMouseLocation()
• UserInputService:GetMouseDelta()
• UserInputService:GetMouseButtonsPressed()

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)
end

คุณสมบัติ MouseIcon กำหนดภาพที่ใช้เป็นตัวชี้หากว่างเปล่าจะใช้ลูกศรเริ่มต้นในขณะที่เคอร์เซอร์ลอยอยู่เหนือวัตถุ UI บางอย่างเช่น ImageButton , TextButton , TextBox หรือ ProximityPrompt รูปภาพนี้จะถูกแทนที่และถูกเพิกเฉยชั่วคราว

เพื่อซ่อนเคอร์เซอร์โดยสิ้นเชิง ทำ ไม่ ใช้ภาพโปร่งใส แทนที่จะตั้ง UserInputService.MouseIconEnabled เป็น false

local UserInputService = game:GetService("UserInputService")

-- เพื่อฟื้นฟูเคอร์เซอร์กลับไปที่สิ่งที่กำหนดไว้ก่อนหน้านี้ จะต้องบันทึกลงในตัวแปร
local savedCursor = nil
local function setTemporaryCursor(cursor: string)
	-- อัปเดตเคอร์เซอร์ที่บันทึกไว้เฉพาะถ้าไม่ได้บันทึกอยู่ในปัจจุบัน
	if not savedCursor then
		savedCursor = UserInputService.MouseIcon
	end
	UserInputService.MouseIcon = cursor
end

local function clearTemporaryCursor()
	-- เฉพาะการคืนค่าเคอร์เซอร์เมาส์เท่านั้นหากมีเคอร์เซอร์ที่บันทึกไว้เพื่อการคืนค่า
	if savedCursor then
		UserInputService.MouseIcon = savedCursor
		-- อย่าฟื้นฟูเคอร์เซอร์เดียวกันสองครั้ง (อาจเขียนทับสคริปต์อื่น)
		savedCursor = nil
	end
end

setTemporaryCursor("http://www.roblox.com/asset?id=163023520")
print(UserInputService.MouseIcon)

clearTemporaryCursor()
print(UserInputService.MouseIcon)

คุณสมบัตินี้กำหนดว่าไอคอน Mouse จะปรากฏเมื่อ true ไอคอนของเมาส์มองเห็นได้ เมื่อ false ไม่ได้

ตัวอย่างเช่น ส่วนของโค้ดด้านล่างซ่อนไอคอนของเมาส์

local UserInputService = game:GetService("UserInputService")

UserInputService.MouseIconEnabled = false

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

local UserInputService = game:GetService("UserInputService")

local mouseInput = {
	Enum.UserInputType.MouseButton1,
	Enum.UserInputType.MouseButton2,
	Enum.UserInputType.MouseButton3,
	Enum.UserInputType.MouseMovement,
	Enum.UserInputType.MouseWheel,
}

local keyboard = Enum.UserInputType.Keyboard

local function toggleMouse(lastInputType)
	if lastInputType == keyboard then
		UserInputService.MouseIconEnabled = false
		return
	end

	for _, mouse in pairs(mouseInput) do
		if lastInputType == mouse then
			UserInputService.MouseIconEnabled = true
			return
		end
	end
end

UserInputService.LastInputTypeChanged:Connect(toggleMouse)

คุณสมบัตินี้อธิบายตำแหน่งของแป้นพิมพ์บนหน้าจอในพิกเซล ตำแหน่งของแป้นพิมพ์คือ Vector2.new(0, 0) เมื่อไม่สามารถมองเห็นได้

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript หรือ Script ที่ตั้งค่า RunContext เป็น Enum.RunContext.Client

ดูเพิ่มเติม OnScreenKeyboardVisible และ OnScreenKeyboardSize .

คุณสมบัตินี้อธิบายขนาดของแป้นพิมพ์บนหน้าจอในพิกเซล ขนาดแป้นพิมพ์คือ Vector2.new(0, 0) เมื่อไม่สามารถมองเห็นได้

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript หรือ Script ที่ตั้งค่า RunContext เป็น Enum.RunContext.Client

ดูเพิ่มเติม OnScreenKeyboardVisible และ OnScreenKeyboardPosition .

คุณสมบัตินี้อธิบายว่าแป้นพิมพ์บนหน้าจอมีอยู่ในปัจจุบันบนหน้าจอของผู้ใช้หรือไม่

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript หรือ Script ที่ตั้งค่า RunContext เป็น Enum.RunContext.Client

ดูเพิ่มเติม OnScreenKeyboardSize และ OnScreenKeyboardPosition .

คุณสมบัตินี้อธิบายว่าอุปกรณ์ปัจจุบันของผู้ใช้มีหน้าจอสัมผัสที่ใช้งานได้หรือไม่

คุณสมบัติถูกใช้เพื่อตรวจสอบว่าอุปกรณ์ของผู้ใช้มีหน้าจอสัมผัสหรือไม่ และดังนั้นหากเหตุการณ์แตะจะเกิดขึ้นหาก TouchEnabled เป็นจริง คุณสามารถใช้อีเวนต์ของ UserInputService เช่น UserInputService.TouchStarted และ UserInputService.TouchEnded เพื่อติดตามเมื่อผู้ใช้เริ่มและหยุดสัมผัสหน้าจอของอุปกรณ์ของพวกเขา

บรรทัดโค้ดด้านล่างจะพิมพ์ว่าอุปกรณ์ของผู้ใช้มีหน้าจอสัมผัสหรือไม่

local UserInputService = game:GetService("UserInputService")

if UserInputService.TouchEnabled then
	print("The user's device has a touchscreen!")
else
	print("The user's device does not have a touchscreen!")
end

ดูเพิ่ม:

• UserInputService.TouchTap
• UserInputService.TouchLongPress
• UserInputService.TouchMoved
• UserInputService.TouchPan
• UserInputService.TouchPinch
• UserInputService.TouchRotate
• UserInputService.TouchSwipe
• UserInputService.TouchStarted
• UserInputService.TouchEnded

คุณสมบัตินี้อธิบายว่าผู้ใช้กำลังใช้อุปกรณ์เสมือนจริง (VR) หรือไม่

หากอุปกรณ์ VR เปิดใช้งานแล้ว คุณสามารถโต้ตอบกับตำแหน่งและการเคลื่อนไหวของมันผ่านฟังก์ชันเช่น UserInputService:GetUserCFrame()คุณยังสามารถตอบสนองต่อการเคลื่อนไหวของอุปกรณ์ VR โดยใช้เหตุการณ์ UserInputService.UserCFrameChanged

local UserInputService = game:GetService("UserInputService")

local isUsingVR = UserInputService.VREnabled
if isUsingVR then
	print("User is using a VR headset!")
else
	print("User is not using a VR headset!")
end

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น คุณสมบัตินี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• VRService
• Camera.HeadLocked
• UserInputService:GetUserCFrame()
• UserInputService.UserCFrameChanged

local VRService = game:GetService("VRService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.CharacterAdded:Wait()
local head = character:WaitForChild("Head")

local function TrackHead(inputType, value)
	if inputType == Enum.UserCFrame.Head then
		head.CFrame = value
	end
end

if VRService.VREnabled then
	-- Set the initial CFrame
	head.CFrame = VRService:GetUserCFrame(Enum.UserCFrame.Head)

	-- Track VR headset movement and mirror for character's head
	VRService.UserCFrameChanged:Connect(TrackHead)
end

ฟังก์ชันนี้จะคืนว่า gamepad ที่ให้ไว้ Enum.UserInputType สนับสนุนปุ่มที่ตรงกับที่ให้ไว้ Enum.KeyCode หรือไม่ฟังก์ชันนี้ใช้เพื่อตรวจสอบการใส่เกมแพดที่ถูกต้อง

เพื่อกำหนดว่า gamepad ใด Enum.UserInputType ได้รับการเชื่อมต่อแล้วใช้ UserInputService:GetConnectedGamepads()

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.GamepadConnected
• UserInputService.GamepadDisconnected
• UserInputService:GetConnectedGamepads()
• UserInputService:IsGamepadButtonDown()
• UserInputService:GetSupportedGamepadKeyCodes()
• UserInputService:GetGamepadState()
• UserInputService:GetGamepadConnected()
• UserInputService.GamepadEnabled

พารามิเตอร์

ส่งค่ากลับ

ฟังก์ชันนี้ส่งคืนคอลเลกชันของแผ่นเกม Enum.UserInputType ที่เชื่อมต่ออยู่ในปัจจุบันหากไม่มีเกมแพดถูกเชื่อมต่อ ตัวเรียงนี้จะว่างเปล่านอกจากนี้ยังคืนวัตถุ UserInputType เท่านั้นที่เป็นเกมแพดตัวอย่างเช่น อีเวนต์นี้จะคืนวัตถุ Gamepad1 ที่เชื่อมต่อ แต่ไม่ใช่วัตถุแป้นพิมพ์

ตัวอย่างเช่น ชิ้นส่วนโค้ดต่อไปนี้ดึง gamepads ที่เชื่อมต่อและเก็บไว้ในตัวแปรชื่อ connectedGamepads

local UserInputService = game:GetService("UserInputService")
local connectedGamepads = UserInputService:GetConnectedGamepads()

เพื่อตรวจสอบว่าเกมแพดเฉพาะถูกเชื่อมต่อหรือไม่ใช้ UserInputService:GetGamepadConnected()

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.GamepadConnected
• UserInputService.GamepadDisconnected
• UserInputService:GetConnectedGamepads()
• UserInputService:IsGamepadButtonDown()
• UserInputService:GetSupportedGamepadKeyCodes()
• UserInputService:GetGamepadState()
• UserInputService:GetGamepadConnected()
• UserInputService:GamepadSupports()
• UserInputService.GamepadEnabled

ส่งค่ากลับ

ฟังก์ชัน GetDeviceAcceleration กำหนดการเร่งความเร็วปัจจุบันของอุปกรณ์ของผู้ใช้มันส่งคืน InputObject ที่อธิบายการเร่งความเร็วปัจจุบันของอุปกรณ์

เพื่อให้สิ่งนี้ทำงานได้ อุปกรณ์ของผู้ใช้จะต้องมีเครื่องวัดความเร่งเปิดใช้งานเพื่อตรวจสอบว่าอุปกรณ์ของผู้ใช้มีเครื่องวัดความเร่งเปิดใช้งานหรือไม่ คุณสามารถตรวจสอบคุณสมบัติ UserInputService.AccelerometerEnabled ได้

หากต้องการติดตามการเปลี่ยนแปลงการเร่งความเร็วของอุปกรณ์ผู้ใช้แทน คุณสามารถใช้เหตุการณ์ UserInputService.DeviceAccelerationChanged

เนื่องจากมันจะยิงท้องถิ่นเท่านั้น จึงสามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

if UserInputService.AccelerometerEnabled then
	local acceleration = UserInputService:GetDeviceAcceleration().Position
	print(acceleration)
else
	warn("Cannot get device acceleration because device does not have an enabled accelerometer!")
end

ฟังก์ชันนี้ส่งคืน InputObject ที่อธิบายเวกเตอร์แรงโน้มถ่วงปัจจุบันของอุปกรณ์

เวกเตอร์แรงโน้มถ่วงจะถูกกำหนดโดยการจัดตำแหน่งของอุปกรณ์เมื่อเทียบกับแรงโน้มถ่วงในโลกแบบจริงตัวอย่างเช่น หากอุปกรณ์ยืนตัวตรง (ภาพวาด) เวกเตอร์แรงโน้มถ่วงจะเป็น Vector3.new(0, 0, -9.18)หากด้านซ้ายของอุปกรณ์ชี้ลง เวกเตอร์จะเป็น Vector3.new(9.81, 0, 0)สุดท้าย หากด้านหลังของอุปกรณ์ชี้ลง เวกเตอร์จะเป็น Vector3.new(0, -9.81, 0)

ฟังก์ชันนี้อาจถูกใช้เพื่อเปิดใช้งานอุปกรณ์ของผู้ใช้ที่จะส่งผลกระทบหรือควบคุมแรงโน้มถ่วงภายในเกมหรือย้ายวัตถุในเกมเช่นลูกบอล

แรงโน้มถ่วงจะถูกติดตามเฉพาะสำหรับผู้เล่นที่ใช้อุปกรณ์ที่มีเซนเซอร์ไจโรสควบคุม - เช่นอุปกรณ์เคลื่อนที่

เพื่อตรวจสอบว่าอุปกรณ์ของผู้ใช้มีการเปิดใช้งานเครื่องวัดความเร่งหรือไม่ ตรวจสอบค่าของ UserInputService.GyroscopeEnabledหากอุปกรณ์มีการเปิดใช้งานไจโรสโคปคุณสามารถใช้เหตุการณ์ UserInputService.DeviceGravityChanged เพื่อติดตามเมื่อแรงโน้มถ่วงบนอุปกรณ์ของผู้ใช้เปลี่ยนไป

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

local bubble = script.Parent:WaitForChild("Bubble")
local camera = workspace.CurrentCamera

camera.CameraType = Enum.CameraType.Scriptable
camera.CFrame = CFrame.new(0, 20, 0) * CFrame.Angles(-math.pi / 2, 0, 0)

if UserInputService.GyroscopeEnabled then
	-- Bind event to when gyroscope detects change
	UserInputService.DeviceGravityChanged:Connect(function(accel)
		-- Move the bubble in the world based on the gyroscope data
		bubble.Position = Vector3.new(-8 * accel.Position.X, 1.8, -8 * accel.Position.Z)
	end)
end

ฟังก์ชันนี้จะคืน InputObject และ CFrame อธิบายเวกเตอร์การหมุนปัจจุบันของอุปกรณ์

นี้ถูกยิงด้วย InputObjectคุณสมบัติ ตำแหน่ง ของวัตถุอินพุตเป็น Enum.InputType.Gyroscope ที่ติดตามการหมุนทั้งหมดในแต่ละแกนอุปกรณ์ท้องถิ่น

การหมุนอุปกรณ์สามารถติดตามได้เฉพาะในอุปกรณ์ที่มี gyroscope เท่านั้น

เนื่องจากฟังก์ชันนี้จะเรียกใช้ท้องถิ่นจึงสามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

if UserInputService.GyroscopeEnabled then
	local _, cf = UserInputService:GetDeviceRotation()
	print(cf)
else
	warn("Cannot get device rotation because device does not have an enabled gyroscope!")
end

ฟังก์ชันนี้จะคืน TextBox ที่ลูกค้ากําลังมุ่งเน้นอยู่ในปัจจุบันA TextBox สามารถเลือกได้ด้วยตนเองโดยผู้ใช้หรือสามารถบังคับให้เลือกโดยใช้ฟังก์ชัน TextBox:CaptureFocus()หากไม่มี TextBox ถูกเลือกฟังก์ชันนี้จะคืน nil

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่มเติม

• UserInputService.TextBoxFocused
• UserInputService.TextBoxFocusReleased
• TextBox:CaptureFocus()
• TextBox:IsFocused()
• TextBox:ReleaseFocus()

ส่งค่ากลับ

ฟังก์ชันนี้จะคืนว่าเกมแพดที่มี Enum.UserInputType ที่กำหนดเชื่อมต่อกับไคลเอนต์หรือไม่

สิ่งนี้สามารถใช้เพื่อตรวจสอบว่าเกมแพดเฉพาะ เช่น 'Gamepad1' ได้เชื่อมต่อกับอุปกรณ์ของไคลเอนต์หรือไม่

เพื่อดูรายการของ gamepad ทั้งหมดที่เชื่อมต่อใช้ UserInputService:GetConnectedGamepads()

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.GamepadConnected
• UserInputService.GamepadDisconnected
• UserInputService:GetConnectedGamepads()
• UserInputService:IsGamepadButtonDown()
• UserInputService:GetSupportedGamepadKeyCodes()
• UserInputService:GetGamepadState()
• UserInputService:GamepadSupports()
• UserInputService.GamepadEnabled

พารามิเตอร์

ส่งค่ากลับ

ฟังก์ชันนี้ส่งคืนคอลเลกชันของ InputObjects สําหรับการใส่ทั้งหมดที่มีอยู่ในเกมแพดที่กำหนด Enum.UserInputType แทนสถานะการรับสุดท้ายของแต่ละอินพุต

เพื่อค้นหา UserInputTypes ของเกมแพดที่เชื่อมต่อกันใช้ UserInputService:GetConnectedGamepads()

เนื่องจากฟังก์ชันนี้จะเปิดใช้งานเฉพาะในท้องถิ่นเท่านั้น จึงสามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService.GamepadConnected
• UserInputService.GamepadDisconnected
• UserInputService:GetConnectedGamepads()
• UserInputService:IsGamepadButtonDown()
• UserInputService:GetSupportedGamepadKeyCodes()
• UserInputService:GetGamepadConnected()
• UserInputService:GamepadSupports()
• UserInputService.GamepadEnabled

พารามิเตอร์

ส่งค่ากลับ

วิธีนี้ใช้ Enum.KeyCode ที่ร้องขอและส่งภาพที่เกี่ยวข้องกับอุปกรณ์เกมแพดที่เชื่อมต่ออยู่ในขณะนี้ (จํากัดเฉพาะ Xbox, PlayStation และ Windows)ซึ่งหมายความว่าหากคอนโทรลเลอร์ที่เชื่อมต่อเป็นคอนโทรลเลอร์ Xbox One ผู้ใช้จะเห็นสินทรัพย์ของ Xboxเช่นเดียวกันหากอุปกรณ์ที่เชื่อมต่อเป็นคอนโทรลเลอร์ของ PlayStation ผู้ใช้จะเห็นสินทรัพย์ของ PlayStationหากต้องการใช้สินทรัพย์ที่กําหนดเอง ดู GetStringForKeyCode()

พารามิเตอร์

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

local imageLabel = script.Parent
local key = Enum.KeyCode.ButtonA

local mappedIconImage = UserInputService:GetImageForKeyCode(key)
imageLabel.Image = mappedIconImage

ฟังก์ชันนี้ส่งคืนคอลเลกชันของ InputObjects ที่เกี่ยวข้องกับแป้นที่กดอยู่ในขณะนี้

ค่าตัวนี้สามารถถูกนำไปผ่านเพื่อกำหนดว่าแป้นใดกำลังถูกกดอยู่ในขณะนี้โดยใช้ค่า InputObject.KeyCode เหล่านี้

เพื่อตรวจสอบว่ากุญแจที่เฉพาะเจาะจงถูกกดหรือไม่ใช้ UserInputService:IsKeyDown()

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

ฟังก์ชันนี้ส่งคืน 'Enum.UserInputType' ที่เกี่ยวข้องกับการใส่ล่าสุดของผู้ใช้

ตัวอย่างเช่น หากการใส่ข้อมูลก่อนหน้าของผู้ใช้กดแป้นพิมพ์ว่างเปล่า ผลลัพธ์ Enum.UserInputType ที่ได้รับจะเป็น 'แป้นพิมพ์'

อีเวนต์ UserInputService.LastInputTypeChanged สามารถใช้เพื่อติดตามเมื่อมีการใช้ Enum.UserInputType ครั้งล่าสุดโดยผู้ใช้เปลี่ยนแปลง

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

if UserInputService:GetLastInputType() == Enum.UserInputType.Keyboard then
	print("Most recent input was keyboard!")
end

ฟังก์ชันนี้ส่งคืนคอลเลกชันของ InputObjects ที่ตรงกับปุ่มเมาส์ที่กําลังกดอยู่ในขณะนี้

ปุ่มเมาส์ที่ติดตามโดยฟังก์ชันนี้รวมถึง:

<td>คําอธิบาย</td>
  </tr>
</thead>

<tr>
  <td>ปุ่มเมาส์1</td>

  <td>ปุ่มเมาส์ด้านซ้าย</td>
</tr>

<tr>
  <td>ปุ่มเมาส์ 2</td>

  <td>ปุ่มเมาส์ด้านขวา</td>
</tr>

<tr>
  <td>ปุ่มเมาส์ 3</td>

  <td>ปุ่มเมาส์ตรงกลาง</td>
</tr>

หากผู้ใช้ไม่กดปุ่มเมาส์ลงเมื่อเรียกฟังก์ชันแล้ว จะส่งคืนรายการว่างเปล่า

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local UserInputService = game:GetService("UserInputService")

UserInputService.InputBegan:Connect(function(input, gameProcessedEvent)
	-- Return an array of the pressed mouse buttons
	local buttonsPressed = UserInputService:GetMouseButtonsPressed()

	local m1, m2 = false, false
	for _, button in buttonsPressed do
		if button.UserInputType == Enum.UserInputType.MouseButton1 then
			print("MouseButton1 pressed!")
			m1 = true
		end

		if button.UserInputType == Enum.UserInputType.MouseButton2 then
			print("MouseButton2 pressed!")
			m2 = true
		end

		if m1 and m2 then
			print("Both mouse buttons pressed!")
		end
	end
end)

ฟังก์ชันนี้ส่งคืนการเปลี่ยนแปลงในพิกเซลของตำแหน่งของผู้เล่น Mouse ในเฟรมที่เรนเดอร์ล่าสุดเรนเดอร์เป็น Vector2ฟังก์ชันนี้ทำงานได้เฉพาะถ้าเมาส์ถูกล็อคโดยใช้คุณสมบัติ UserInputService.MouseBehaviorหากเมาส์ยังไม่ถูกล็อค ค่าที่ส่งคืน Vector2 จะเป็นศูนย์

ความไวของเมาส์ซึ่งกำหนดไว้ในการตั้งค่าของไคลเอนต์และ UserInputService.MouseDeltaSensitivity จะมีอิทธิพลต่อผลลัพธ์

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

local RunService = game:GetService("RunService")
local UserInputService = game:GetService("UserInputService")

UserInputService.MouseBehavior = Enum.MouseBehavior.LockCenter

local function onRenderStep()
	local delta = UserInputService:GetMouseDelta()
	if delta ~= Vector2.new(0, 0) then
		print("The mouse has moved", delta, "since the last step")
	end
end

RunService:BindToRenderStep("MeasureMouseMovement", Enum.RenderPriority.Input.Value, onRenderStep)

ฟังก์ชันนี้ส่งคืน Vector2 ที่แทนตำแหน่งหน้าจอปัจจุบันของผู้เล่น Mouse ในพิกเซลที่เกี่ยวข้องกับมุมซ้ายบนสิ่งนี้ไม่นับรวมกับ Enum.ScreenInsets เพื่อรับช่องว่างด้านบนซ้ายและด้านล่างขวา โทร GuiService:GetGuiInset()

หากตำแหน่งของเคอร์เซอร์อยู่นอกหน้าจอหรืออุปกรณ์ของผู้เล่นไม่มีเมาส์ ค่าที่ส่งกลับจะไม่สามารถกำหนดได้

เนื่องจาก UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ส่งค่ากลับ

ฟังก์ชันนี้ส่งคืนคอลเลกชันของเกมแพด UserInputTypes ที่เชื่อมต่อและเปิดใช้งานสำหรับการนําทาง GUIรายการนี้อยู่ในลำดับลดลงของลําดับความสําคัญ ซึ่งหมายความว่าสามารถทําซ้ําได้เพื่อกําหนดว่าเกมแพดใดที่ควรมีการควบคุมการนําทาง

ว่าคอนโซลเกมที่เชื่อมต่อเป็นคอนโซลเกมการนําทางเท่านั้นจะกำหนดได้ว่าคอนโซลเกมใดควบคุม GUI การนําทางสิ่งนี้ไม่มีผลต่อการควบคุมการนำทาง

ตั้งแต่ UserInputService เป็นเฉพาะด้านไคลเอนต์เท่านั้น ฟังก์ชันนี้สามารถใช้ได้เฉพาะใน LocalScript

ดูเพิ่ม:

• UserInputService:SetNavigationGamepad() , เพื่อเปิดใช้งานหรือปิดการใช้งานแป้นเกมสําหรับการนําทาง GUI
• UserInputService:IsNavigationGamepad() เพื่อตรวจสอบว่าเกมแพดถูกเปิดใช้งานสำหรับการนําทาง GUI
• UserInputService:GetConnectedGamepads() เพื่อคืนคอนโซลเกมทั้งหมดที่เชื่อมต่อไม่ว่าจะเป็นการควบคุมการนําทางของ GUI

ส่งค่ากลับ

รับสตริงสําหรับรหัสกุญแจ ส่งคืนสตริงที่แทนที่กุญแจที่ผู้ใช้ควรกดเพื่อใส่ Enum.KeyCode ที่กำหนด โดยคํานึงถึงการจัดเค้าโครงแป้นพิมพ์ของพวกเขาสำหรับรหัสหลักที่ต้องการให้มีการถือบางตัวแก้ไขไว้ ฟังก์ชันนี้จะคืนรหัสหลักที่จะกดเพิ่มเติมจากตัวแก้ไขดูตัวอย่างด้านล่างสำหรับคำอธิบายเพิ่มเติม

เมื่อใช้ Roblox ด้วยเลย์เอาต์แป้นพิมพ์ที่ไม่ใช่ QWERTY รหัสกุญแจจะถูกแปลงเป็นตำแหน่ง QWERTY ที่เทียบเท่าตัวอย่างเช่น การกด A บนแป้นพิมพ์ AZERTY จะทำให้ได้ผลลัพธ์ Enum.KeyCode.Qการจัดเรียงนี้สามารถนำไปสู่ข้อมูลที่ไม่ตรงกันบนองค์ประกอบ UI ประสบการณ์ตัวอย่างเช่น "กด M เพื่อเปิดแผนที่" ไม่ถูกต้องบนแป้นพิมพ์ AZERTY; จะต้องเป็น "กด ? เพื่อเปิดแผนที่" ซึ่งอยู่ในตำแหน่งเดียวกับ M บน QWERTYฟังก์ชันนี้แก้ปัญหานี้โดยให้กุญแจจริงที่จะกดในขณะที่ใช้การจัดเลย์เอาต์แป้นพิมพ์ที่ไม่ใช่ QWERTY

local UserInputService = game:GetService("UserInputService")

local textLabel = script.Parent
local mapKey = Enum.KeyCode.M
textLabel.Text = "Press " .. UserInputService:GetStringForKeyCode(mapKey) .. " to open the map"

ตัวอย่างบนแป้นพิมพ์ QWERTY

<th>ค่ากลับ</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Enum.KeyCode.Q</code></td>

    <td><code>Q</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.W</code></td>

    <td><code>W</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Equals</code></td>

    <td><code>=</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.At</code></td>

    <td><code>2</code> เพราะ <code>@</code> ถูกพิมพ์ด้วย <kbd>Shift</kbd><kbd>2</kbd></td>
  </tr>
</tbody>

ตัวอย่างบนแป้นพิมพ์ AZERTY

<th>ค่ากลับ</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Enum.KeyCode.Q</code></td>

    <td><code>A</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.W</code></td>

    <td><code>Z</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Equals</code></td>

    <td><code>=</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.At</code></td>

    <td><code>É</code></td>
  </tr>
</tbody>

การใช้งานเกมแพด

ส่งคืนการแมพสตริงสำหรับเกมแพดที่เชื่อมต่อล่าสุดสำหรับเกมที่เชื่อมต่อล่าสุดหากคอนโทรลเลอร์ที่เชื่อมต่อไม่ได้รับการสนับสนุน ฟังก์ชันจะคืนค่าการแปลงสตริงเริ่มต้นสำหรับรหัสกุญแจที่ร้องขอ

ตัวอย่างต่อไปแสดงวิธีที่คุณสามารถแมพรายการสินทรัพย์ที่กําหนดเองสําหรับ ButtonA :

local UserInputService = game:GetService("UserInputService")

local imageLabel = script.Parent
local key = Enum.KeyCode.ButtonA

local mappings = {
  ButtonA = "rbxasset://BUTTON_A_ASSET", -- Replace with the desired ButtonA asset
  ButtonCross = "rbxasset://BUTTON_CROSS_ASSET"  -- Replace with the desired ButtonCross asset
}

local mappedKey = UserInputService:GetStringForKeyCode(key)
local image = mappings[mappedKey]

imageLabel.Image = image

แผนที่เกมแพด

รหัสแปดทิศทางไม่มีความแตกต่างตามอุปกรณ์Enum.KeyCode.ButtonSelect มีพฤติกรรมที่แตกต่างเล็กน้อยในบางกรณีใช้ทั้งแผนที่ของ PlayStation เพื่อให้แน่ใจว่าผู้ใช้เห็นปุ่มที่ถูกต้อง

<th>มูลค่าการคืนของ PlayStation</th>

    <th>มูลค่าการคืน Xbox</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Enum.KeyCode.ปุ่ม A</code></td>

    <td><code>ปุ่มข้าม</code></td>

    <td><code>ปุ่ม A</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ปุ่ม B</code></td>

    <td><code>วงกลมปุ่ม</code></td>

    <td><code>ปุ่ม B</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonX</code></td>

    <td><code>ปุ่มสแควร์</code></td>

    <td><code>ปุ่ม X</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ปุ่มY</code></td>

    <td><code>ปุ่มสามเหลี่ยม</code></td>

    <td><code>ปุ่ม Y</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL1</code></td>

    <td><code>ปุ่ม L1</code></td>

    <td><code>ปุ่ม LB</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL2</code></td>

    <td><code>ปุ่ม L2</code></td>

    <td><code>ปุ่มLT</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL3</code></td>

    <td><code>ปุ่ม L3</code></td>

    <td><code>ปุ่มLS</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR1</code></td>

    <td><code>ปุ่ม R1</code></td>

    <td><code>ปุ่ม RB</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR2</code></td>

    <td><code>ปุ่ม R2</code></td>

    <td><code>ปุ่ม RT</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR3</code></td>

    <td><code>ปุ่ม R3</code></td>

    <td><code>ปุ่ม RS</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonStart</code></td>

    <td><code>ตัวเลือกปุ่ม</code></td>

    <td><code>ปุ่มเริ่มต้น</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonSelect</code></td>

    <td><code>แป้ดสัมผัสปุ่ม</code> และ <code>แบ่งปันปุ่ม</code></td>

    <td><code>ปุ่มเลือก</code></td>
  </tr>
</tbody>

ภาพระบบสําหรับ KeyCodes

เมื่อใช้ Enum.KeyCode ที่อาจแสดงได้ดีขึ้นในรูปแบบภาพ เช่น สำหรับ ImageLabel ในอินเทอร์เฟซผู้ใช้ คุณสามารถใช้ไอคอนมรดกต่อไปนี้ได้อย่างไรก็ตาม ขอแนะนำให้คุณใช้ GetImageForKeyCode() ในฐานะวิธีที่ทันสมัยและข้ามแพลตฟอร์มมากขึ้นในการดึงไอคอนควบคุม Xbox และ PlayStation

<th>ภาพ</th>

    <th>รหัสสินทรัพย์</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Enum.KeyCode.ButtonX</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxX.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxX.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonY</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxY.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxY.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonA</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxA.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxA.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonB</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxB.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxB.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.DPadLeft</code></td>

    <td>
      <img src="../../../assets/scripting/controls/dpadLeft.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/dpadLeft.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.DPadRight</code></td>

    <td>
      <img src="../../../assets/scripting/controls/dpadRight.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/dpadRight.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.DPadUp</code></td>

    <td>
      <img src="../../../assets/scripting/controls/dpadUp.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/dpadUp.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.DPadDown</code></td>

    <td>
      <img src="../../../assets/scripting/controls/dpadDown.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/dpadDown.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonSelect</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxView.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxView.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonStart</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxmenu.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxmenu.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL1</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxLB.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxLB.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR1</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxRB.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxRB.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL2</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxLT.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxLT.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR2</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxRT.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxRT.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonL3</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxLS.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxLS.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.ButtonR3</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxRS.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxRS.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Thumbstick1</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxLSDirectional.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxLSDirectional.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Thumbstick2</code></td>

    <td>
      <img src="../../../assets/scripting/controls/xboxRSDirectional.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/xboxRSDirectional.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Backspace</code></td>

    <td>
      <img src="../../../assets/scripting/controls/backspace.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/backspace.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Return</code></td>

    <td>
      <img src="../../../assets/scripting/controls/return.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/return.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.LeftShift</code></td>

    <td>
      <img src="../../../assets/scripting/controls/shift.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/shift.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.RightShift</code></td>

    <td>
      <img src="../../../assets/scripting/controls/shift.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/shift.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Tab</code></td>

    <td>
      <img src="../../../assets/scripting/controls/tab.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/tab.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Quote</code></td>

    <td>
      <img src="../../../assets/scripting/controls/apostrophe.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/apostrophe.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Comma</code></td>

    <td>
      <img src="../../../assets/scripting/controls/comma.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/comma.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Backquote</code></td>

    <td>
      <img src="../../../assets/scripting/controls/graveaccent.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/graveaccent.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Period</code></td>

    <td>
      <img src="../../../assets/scripting/controls/period.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/period.png</code></td>
  </tr>

  <tr>
    <td><code>Enum.KeyCode.Space</code></td>

    <td>
      <img src="../../../assets/scripting/controls/spacebar.png" width="24">

      </img>
    </td>

    <td><code>rbxasset://textures/ui/การควบคุม/spacebar.png</code></td>
  </tr>
</tbody>