403 Forbidden
403 ForbiddenActionScript& 3.0 Reference for the Adobe& Flash& Platform
Retrieving Data from Server...
GameInput& - AS3
Language Version:&ActionScript 3.0Runtime Versions:&AIR 3.7 &
The GameInput class is the entry point into the GameInput
API. You can use this API to manage the communications between an
application and game input devices (for example: joysticks, gamepads, and wands).
The main purpose of this class is to provide access to the supported
input devices that are connected to your application platform. This
static class enumerates the connected input devices in a list. You
access a device from the list using the getDeviceAt(index:int) method.
The numDevices property provides the number of input
devices currently connected to your platform. Use this value to
determine the upper bound of the list of devices.
Use an instance of this class to listen for events that notify you about the addition
and removal of input devices. To listen these events, do the following:
Create an instance of the GameInput class.
Add event listeners for the GameInputEvent.DEVICE_ADDED
and GameInputEvent.DEVICE_REMOVED events. (Events can only be
registered on an instance of the class.)
This class also features the isSupported flag, which
indicates whether the GameInput API is supported on your platform.
For more information, see the Adobe Air Developer Center article:
For Android, this feature supports a minimum Android OS version of 4.1 and
requires the minimum SWF version 20 and namespace 3.7.
For iOS, this feature supports a minimum iOS version of 9.0 and requires
the minimum SWF version 34 and namespace 23.0.
How to Detect One Game Input Device From Among Identical
A common requirement for two-or-more player games is detecting one device
from among identical devices. For example, applications sometimes must
determine which device represents "Player 1", "Player 2", ..., "Player N".
Add event listeners to every control on all undetected input devices. These event
listeners listen for Event.CHANGE events, which are dispatched
whenever a control value changes.
The first time any control is activated (for example a button press or trigger pull)
the application labels that device.
Remove all of the event listeners from the remaining undetected input devices.
Repeat steps 1-3 as required to identify the rest of the undetected input devices.
Public Properties&PropertyDefined ByPublic Methods &MethodDefined ByEvents&Event Summary Defined By&&Dispatched when a game input device is connected to your platform, or when an already connected device is switched on.GameInput&&Dispatched when a game input device is removed from your platform, or when a connected device is switched off.GameInput&&Dispatched when a game input device is connected but is not usable.GameInput&isSupportedisSupported:&&[read-only] Language Version:&ActionScript 3.0Runtime Versions:&AIR 3.7
Indicates whether the current platform supports the GameInput API.
Implementation &&&&public static function get isSupported():&numDevicesnumDevices:&&[read-only] Language Version:&ActionScript 3.0Runtime Versions:&AIR 3.7
Provides the number of connected input devices. When
a device is connected, the GameInputEvent.DEVICE_ADDED
event is fired.
Implementation &&&&public static function get numDevices():&getDeviceAt public static function getDeviceAt(index:):Language Version:&ActionScript 3.0Runtime Versions:&AIR 3.7
Gets the input device at the specified index location in the list
of connected input devices.
The order of devices in the index may change whenever
a device is added or removed. You can check the name and
id properties on a GameInputDevice object to
match a specific input device.
Parameters index: & The index position in the list of input devices.
Returns & The specified GameInputDevice.
& When the provided index is less than zero or
greater than (numDevices - 1).
Event Object Type:
Dispatched when a game input device is connected to your platform,
or when an already connected device is switched on.
Event Object Type:
Dispatched when a game input device is removed from your platform,
or when a connected device is switched off.
Event Object Type:
Dispatched when a game input device is connected but is not usable.
This event is specific to Windows only.
For example, this happens in a Windows sandboxed browser when another
DirectInput based application is already using the device.
[an error occurred while processing this directive]&|&