Home
This wiki serves as a back-up to the original Controller.js wiki and details how to use the lights in Buzz controllers.
Controller.js is built to handle the busy-work associated with using the Gamepad API make it easier to use for non-gaming purposes. It has three main features:
The BuzzController class matches the Controller interface. It can be used as a drop-in replacement so you should refer to the Controller documentation for anything unrelated to the lights.
Controller.js fires DOM events on controller state and input changes. It keeps track of each input's changes over time and reports them similarly to mouse and keyboard events.
Each event provides a packet of information about the event fired, such as coordinates and angle for analog stick events.
A challenge of working with gamepads is the number and variety of devices that exist in the market. Some will have more inputs than a "normal" gamepad, and some will have fewer. The Gamepad API allows for an arbitrary number of buttons and axes but it doesn't privide a way to tell what each of those inputs actually is. buttons[0] might be a D-pad input on one gamepad, but a trigger on another.
Controller.js alleviates this issue by mapping raw inputs against a set of known layouts and giving each input a unique, descriptive name, i.e. "DPAD_UP", "LEFT_SHOULDER", "RIGHT_ANALOG_STICK".
Controller.js provides a set of functions for common tasks and configurable options for each gamepad. It handles the process of discovering gamepads, mapping their inputs and listening for and pausing events from those gamepads. It also provides settings to do things like change button sensitivity or map analog stick movements to the D-pad.
→ Setup
→ Buttons & Analog Sticks
→ Controller Layouts
→ Configuring Settings
→ Event Model
→ The Controller Object
→ Controller Instances
→ Controller Settings
→ Buzz Controller Lights
→ Grunt Tasks
→ Registering Settings
→ Creating Layout Maps