Input del gamepad

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Roblox accetta input da gamepad come i controller Xbox e PlayStation. Per semplificare gli input cross‑platform, inclusi i gamepad, Roblox fornisce il Sistema di Azione Input per definire azioni come "salto", "corsa" o "sparare" e configurare binding per più input hardware per gestire quelle azioni.

Quando si assegnano input del gamepad, consultare gli schemi di controllo comuni per creare un'esperienza di gamepad coerente per i giocatori. Dopo che gli input sono stati impostati, puoi migliorare l'esperienza del giocatore includendo il feedback aptico sui controller supportati.

Mentre sviluppi il supporto per i gamepad, ricorda di testare frequentemente utilizzando un gamepad connesso o il Controller Emulator in Studio.

Rilevazione del tipo di input

Nello sviluppo cross‑platform, è importante determinare e rispondere al tipo di input PreferredInput che un giocatore sta utilizzando, normalmente per garantire che gli elementi UI come i pulsanti e i menu a schermo funzionino in modo elegante e supportino l'interazione tra i dispositivi.

Ad esempio, una console presume che i gamepad siano l'input predefinito, ma un giocatore su PC o laptop può anche scegliere di collegare un gamepad bluetooth. In questo caso, mouse/tastiera rimane un input valido per quel giocatore, ma puoi presumere che vogliano passare al gamepad connesso come tipo di input primario.

Consulta rilevazione del tipo di input per ulteriori informazioni.

Schemi di controllo comuni

Quando si considerano specifici binding di controllo per il Sistema di Azione Input, è meglio stabilire coerenza tra diversi giochi. I seguenti binding di input aiuteranno i giocatori a sentirsi immediatamente familiari e a proprio agio con i controlli del gamepad.

InputUtilizzi comuni
ButtonAAccetta i prompt del giocatore o le selezioni GUI. Alternativamente utilizzato per azioni primarie come il salto.
ButtonBAnnulla i prompt del giocatore o le selezioni GUI. Alternativamente utilizzato per azioni secondarie come un'evitazione, rotolamento o corsa.
Thumbstick1Generalmente associato al movimento del personaggio.
Thumbstick2Generalmente associato al movimento della telecamera.
ButtonL2, ButtonR2Generalmente utilizzato per azioni primarie, come sparare.
ButtonL1, ButtonR1, ButtonX, ButtonYAzioni secondarie come ricaricare, mirare o accedere a un inventario o minimappa.

Feedback aptico

Molti controller del gamepad hanno motori integrati per fornire feedback aptico. Aggiungere tremori e vibrazioni può migliorare notevolmente l'esperienza di un giocatore e fornire feedback sottile oltre a quello visivo o audio.

Roblox supporta gli haptics per i gamepad PlayStation, i gamepad Xbox e il controller Quest Touch. Il feedback aptico è gestito tramite istanze di HapticEffect che possono essere impostate su un tipo specifico di Type come GameplayCollision o UIClick.

Una volta che un HapticEffect è impostato, puoi iniziarlo tramite il metodo Play(), per esempio:


local Workspace = game:GetService("Workspace")
local effect = Instance.new("HapticEffect")
effect.Type = Enum.HapticEffectType.GameplayExplosion
effect.Parent = Workspace
-- Riproduci l'effetto aptico
effect:Play()

Emulazione del controller

L'Emulatore di Controller, accessibile dal menu Test di Studio, ti consente di emulare accuratamente l'input del gamepad direttamente in Studio. Il controller predefinito è un gamepad generico, ma puoi selezionare alternative dal menu a discesa in alto a sinistra.

Vista del controller generico nell'Emulatore di Controller.

Durante il playtesting, puoi controllare il gioco con il controller virtuale usando il mouse.

Puoi anche fare clic su Modifica mappature nell'angolo in alto a destra per visualizzare e modificare le mappature dei tasti per il controller virtuale, ad esempio E a ButtonL2 oppure 9 a ButtonA. Queste mappature vengono salvate come altre impostazioni di Studio (per controller, per utente, per computer) e vengono tradotte in eventi del gamepad sia nella finestra dell'emulatore che nella vista 3D.

© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.