Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.ui 

GameInput  - AS3

Пакетflash.ui
Классpublic final class GameInput
НаследованиеGameInput Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 3.7

Класс GameInput является основным для реализации API-интерфейса GameInput. С помощью этого API-интерфейса можно управлять обменом данных между приложением и игровыми устройствами ввода (например, джойстиками, геймпадами и палочками).

Главная цель этого класса состоит в том, чтобы обеспечить доступ к поддерживаемым устройствам ввода, которые подключены к платформе приложения. В этом статическом классе в списке перечислены связанные устройства ввода. Доступ к устройству из списка можно получить с помощью метода getDeviceAt(index:int).

Свойство numDevices сообщает число устройств ввода, в настоящее время подключенных к платформе. Используйте это значение для определения верхней границы списка устройств.

Используйте экземпляр этого класса для прослушивания событий, уведомляющих о подключении или отключении устройств ввода. Для прослушивания этих событий выполните следующие действия.

  1. Создайте экземпляр класса GameInput.
  2. Добавьте прослушиватели для событий GameInputEvent.DEVICE_ADDED и GameInputEvent.DEVICE_REMOVED. (События могут регистрироваться только для экземпляра класса.)

Этот класс также имеет флаг isSupported, который обозначает, поддерживается ли API-интерфейс GameInput на платформе.

Дополнительные сведения см. в статье Adobe Air Developer Center Игровые контроллеры на Adobe AIR.

Для устройств Android эта функция поддерживает ОС Android начиная с версии 4.1 и требует SWF начиная с версии 20 и пространство имен 3.7. Для устройств iOS эта функция поддерживает ОС iOS начиная с версии 9.0 и требует SWF начиная с версии 34 и пространство имен 23.0.

Определение одного игрового устройства ввода среди идентичных устройств

Распространенным требованием для игр, рассчитанных на два или более игроков, является определение одного устройства среди идентичных устройств. Например, приложения иногда должны определять, какое устройство представляет игрока 1, игрока 2, ... игрока N.

Решение:

  1. Добавьте прослушиватели событий для каждого элемента управления на всех неопределенных устройствах ввода. Эти прослушиватели улавливают события Event.CHANGE, отправляемые при изменении значения элемента управления.
  2. При первой активации любого элемента управления (например, при нажатии кнопки или нажатии триггера) приложение присваивает метку этому устройству.
  3. Удалите все прослушиватели событий для оставшихся неопределенных устройств ввода.
  4. При необходимости повторите шаги 1-3, чтобы идентифицировать оставшиеся неопределенные устройства ввода.

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      isSupported : Boolean
[статические] [только для чтения] Указывает, поддерживает ли текущая платформа API-интерфейс GameInput.
GameInput
      numDevices : int
[статические] [только для чтения] Сообщает число подключенных устройств ввода.
GameInput
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
[статические] Получает устройство ввода в местоположении с указанным индексом в списке подключенных устройств ввода.
GameInput
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
  Отправляется, когда игровое устройство ввода подключается к платформе или когда подключенное устройство включается.GameInput
  Отправляется, когда игровое устройство ввода удаляется с платформы или когда подключенное устройство выключается.GameInput
  Отправляется, если игровое устройство ввода подключено, но не может использоваться.GameInput
Сведения о свойстве
    

isSupported

свойство
isSupported:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 3.7

Указывает, поддерживает ли текущая платформа API-интерфейс GameInput.



Реализация
    public static function get isSupported():Boolean
    

numDevices

свойство 
numDevices:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 3.7

Сообщает число подключенных устройств ввода. Когда устройство подключено, отправляется событие GameInputEvent.DEVICE_ADDED.



Реализация
    public static function get numDevices():int
Сведения о методе

    getDeviceAt

()метод
public static function getDeviceAt(index:int):GameInputDevice

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 3.7

Получает устройство ввода в местоположении с указанным индексом в списке подключенных устройств ввода.

Порядок устройств в индексе может изменяться каждый раз при добавлении или удалении устройства. Можно проверить свойства name и id объекта GameInputDevice, чтобы найти определенное устройство ввода.

Параметры

index:int — Позиция индекса в списке устройств ввода.

Возвращает
GameInputDevice — Указанный объект GameInputDevice.

Выдает
RangeError — Когда полученный индекс меньше нуля или больше (numDevices - 1).
Сведения о событии

deviceAdded

Событие
Тип объекта события: flash.events.GameInputEvent

Отправляется, когда игровое устройство ввода подключается к платформе или когда подключенное устройство включается.

deviceRemoved

Событие  
Тип объекта события: flash.events.GameInputEvent

Отправляется, когда игровое устройство ввода удаляется с платформы или когда подключенное устройство выключается.

deviceUnusable

Событие  
Тип объекта события: flash.events.GameInputEvent

Отправляется, если игровое устройство ввода подключено, но не может использоваться. Это событие используется только в ОС Windows. Например, такая ситуация возникает в изолированном браузере Windows, если другое приложение на основе DirectInput уже использует устройство.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.