JoystickAPI: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
(Add a redirect to GamepadAPI page)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{bug|604039}} covers prototyping a way for web content to receive input from Joystick/gamepad controllers connected to a computer.
#REDIRECT [[GamepadAPI]]
 
= Initial Implementation =
The patches currently on the bug implement a simple set of DOM events:
* MozJoyButtonDown
* MozJoyButtonUp
** These events currently have the properties:
** unsigned long joystickID: an arbitrary integer ID that's unique per connected device
** unsigned long button: button number being pressed/released
* MozJoyAxisMove
** This event currently has the properties:
** unsigned long joystickID: an arbitrary integer ID that's unique per connected device
** unsigned long axis: axis number being moved
** float value: position of the axis in the range -1.0...1.0
 
= Design considerations =
* Should feel web-native.
** DOM Events were chosen for the first prototype implementation because of the similarity to keyboard/mouse input.
** Whatever API is chosen, it should use standard web idioms.
* Should not expose the user to unnecessary fingerprinting.
** Web pages should not be able to query for the number and type of attached devices without explicit user input.
** Ideally we wouldn't have to use a permission infobar like with some other APIs, the user explicitly interacting with their device while viewing a webpage ought to be enough "permission" to send device data to that page.
** The prototype implementation falls down a bit here, it sends events to all pages that ask for them, should really be just the foreground page.
* Needs to be performant for web games that want to run at 60FPS
** This will need experimentation and testing
** There are assertions that DOM events won't scale to this level, it's possible that the API will need to be changed if that is true
* To be useful, will need some way to map buttons/axes to meaningful values.
** Even the same gamepad looks different on different OSes!
** Across multiple devices this is insanity
** Should try to expose enough info to let content handle this, Kevin Gadd has an "Input Device API" that is higher-level and might be a good fit here.

Latest revision as of 18:07, 15 November 2011

Redirect to:

Retrieved from "https://wiki.mozilla.org/index.php?title=JoystickAPI&oldid=369677"