| Pacote | flash.ui |
| Classe | public final class GameInput |
| Herança | GameInput  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.7 |
GameInput é o ponto de entrada da API GameInput. Você pode usar esta API para gerenciar as comunicações entre um aplicativo e dispositivos de entrada de jogo (por exemplo: alavancas de controle de um avião, gamepads e varetas).
O objetivo principal desta classe é fornecer o acesso aos dispositivos de entrada suportados que se conectam à sua plataforma de aplicativo. Esta classe estática enumera os dispositivos de entrada conectados em uma lista. Você poderá acessar um dispositivo da lista utilizando o método getDeviceAt (index:int).
A propriedade numDevices fornece o número de dispositivos de entrada conectados à plataforma no momento. Utilize este valor para determinar o limite superior da lista de dispositivos.
Utilize uma ocorrência desta classe para escutar eventos que o notificam sobre a adição e a remoção de dispositivos de entrada. Para ouvir estes eventos, faça o seguinte:
-
Crie uma ocorrência da classe
GameInput. -
Adicione ouvintes de evento aos eventos
GameInputEvent. DEVICE_ADDEDeGameInputEvent.DEVICE_REMOVED. (Os eventos só podem ser registrados em uma instância da classe.)
Esta classe também apresenta o sinalizador isSupported, que indica se GameInput API é suportado na sua plataforma.
Para obter mais informações, consulte o artigo da Central do Desenvolvedor do Adobe Air: Controladores de jogos no Adobe AIR.
Para Android, este recurso suporta uma versão mínima do Android OS 4.1 e requerem o SWF versão mínima 20 e namespace 3.7. No iOS, esse recurso tem suporte para uma versão mínima do iOS 9.0 e requer o SWF versão mínima 34 e namespace 23.0.
Como detectar um dispositivo de entrada de jogo entre dispositivos idênticos.
Uma solicitação comum de dois ou mais jogos do player está detectando um dispositivo entre dispositivos idênticos. Por exemplo, os aplicativos às vezes devem determinar qual dispositivo representa o "Jogador 1", o "Jogador 2"..., o "Jogador N".
Solução:
-
Adicione ouvintes de evento a cada controle em todos os dispositivos de entrada não detectados. Estes ouvintes de evento escutam eventos
Event.CHANGE, que são despachados sempre que um valor de controle é alterado. - A primeira vez que qualquer controle é ativado (por exemplo um botão pressionado ou um acionamento de gatilho) o aplicativo rotula esse dispositivo.
- Remova tudo dos ouvintes de evento dos dispositivos de entrada não detectados restantes.
- Repita as etapas 1-3 como requerido para identificar o resto dos dispositivos de entrada não detectados.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isSupported : Boolean [estático] [somente leitura]
Indica se a sua plataforma é compatível com a API GameInput. | GameInput | ||
| numDevices : int [estático] [somente leitura]
Fornece o número de dispositivos de entrada conectados. | GameInput | ||
| Método | Definido por | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
[estático]
Coloca o dispositivo de entrada no local de índice especificado na lista de dispositivos de entrada conectados. | GameInput | ||
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando o dispositivo de entrada do jogo é conectado à plataforma ou quando um dispositivo já conectado é ligado. | GameInput | |||
| Despachado quando um dispositivo de entrada de jogo é removido da sua plataforma ou quando um dispositivo conectado é desligado. | GameInput | |||
| Despachado quando um dispositivo de entrada de jogo está conectado mas não pode ser usado. | GameInput | |||
isSupported | propriedade |
numDevices | propriedade |
getDeviceAt | () | método |
public static function getDeviceAt(index:int):GameInputDevice| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.7 |
Coloca o dispositivo de entrada no local de índice especificado na lista de dispositivos de entrada conectados.
A ordem de dispositivos no índice poderá ser alterada sempre que um dispositivo for adicionado ou removido. É possível verificar as propriedades name e ID em um objeto GameInputDevice para corresponder a um dispositivo de entrada específico.
Parâmetros
index:int — A posição no índice na lista de dispositivos de entrada.
|
GameInputDevice — O GameInputDevice especificado.
|
Lança
RangeError — Quando o índice fornecido é menor do que zero ou maior do que (numDevices - 1).
|
deviceAdded | Evento |
flash.events.GameInputEventDespachado quando o dispositivo de entrada do jogo é conectado à plataforma ou quando um dispositivo já conectado é ligado.
deviceRemoved | Evento |
flash.events.GameInputEventDespachado quando um dispositivo de entrada de jogo é removido da sua plataforma ou quando um dispositivo conectado é desligado.
deviceUnusable | Evento |
flash.events.GameInputEventDespachado quando um dispositivo de entrada de jogo está conectado mas não pode ser usado. Esse evento é específico do Windows. Por exemplo, isso ocorre no navegador de uma caixa de proteção do Windows quando outro aplicativo com base em DirectInput já está utilizando o dispositivo.
Wed Jun 13 2018, 11:10 AM Z