GamepadService
*Ce contenu sera bientôt disponible dans la langue que vous avez sélectionnée.
The GamepadService is internally responsible for handling inputs from various controllers, such as Xbox One or PlayStation DualShock controllers. It also handles APIs used with the gamepad virtual cursor. You can enable the gamepad cursor for your experience by setting Enum.VirtualCursorMode under StarterGui to Enabled.
Résumé
Propriétés
The state of the gamepad virtual cursor.
Méthodes
Disables the gamepad cursor, if currently enabled.
Enables the gamepad cursor or updates its position.
Propriétés
GamepadCursorEnabled
This boolean is a read only variable that maintains the state of the gamepad virtual cursor.
Échantillons de code
local gamepadService = game.GamepadService
gamepadService:GetPropertyChangedSignal("GamepadCursorEnabled"):Connect(function()
local enabled = gamepadService.GamepadCursorEnabled
if enabled then
-- Custom code when the virtual cursor is enabled
else
-- Custom code when the virtual cursor is disabled
end
end)Méthodes
DisableGamepadCursor
This function disables the gamepad cursor, if it's currently enabled.
Retours
Échantillons de code
local gamepadService = game.GamepadService
local userInputService = game.UserInputService
userInputService.InputBegan:Connect(function(inputObject, gameProcessed)
if inputObject.KeyCode == Enum.KeyCode.ButtonB then
gamepadService:DisableGamepadCursor()
end
end)EnableGamepadCursor
This function enables the gamepad cursor if it's currently disabled. If the cursor is already enabled, calling the API updates the cursor's position. The function accepts a GuiObject parameter, but there are some invalid cases. Please note that in order to set the cursor to the default position, nil must be passed in as a parameter. Providing no argument will result in an error.
| Input GuiObject | Cursor Starting Position | |
| Nil | Default position | |
| Not a GuiObject | Cursor does not appear, errors | |
| Not a child of BasePlayerGui | Cursor does not appear, errors | |
| GuiObject has Visible 2 set to false or any parent visible set to false | Default position with warning | |
| Child of ScreenGui 1 with Enabled 1 set to false | Default position with warning | |
| Child of BillboardGui 4 or SurfaceGui | Default position with warning | |
| GuiObject outside the viewport (Or, any part of the gui object that is off screen) | Default position with warning | |
| Child of ScrollingFrame with clipping set to false: GuiObject outside of scrolling frame (Object child of scrolling frame and not visible on screen) | Default position with warning | |
| Child of ScrollingFrame with clipping set to true: GuiObject outside scrolling frame window but inside viewport | GuiObject moves into the scrolling frame and starts the cursor centered over the object | |
| GuiObject inside the frame and visible | Cursor starts centered on the GuiObject |
Paramètres
Retours
Échantillons de code
local gamepadService = game.GamepadService
local userInputService = game.UserInputService
local startObject = script.Parent
userInputService.InputBegan:Connect(function(inputObject, gameProcessed)
if inputObject.KeyCode == Enum.KeyCode.ButtonA then
gamepadService:EnableGamepadCursor(startObject)
end
end)